~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/virt/kvm/x86/msr.rst

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /Documentation/virt/kvm/x86/msr.rst (Architecture sparc) and /Documentation/virt/kvm/x86/msr.rst (Architecture mips)


  1 .. SPDX-License-Identifier: GPL-2.0                 1 .. SPDX-License-Identifier: GPL-2.0
  2                                                     2 
  3 =================                                   3 =================
  4 KVM-specific MSRs                                   4 KVM-specific MSRs
  5 =================                                   5 =================
  6                                                     6 
  7 :Author: Glauber Costa <glommer@redhat.com>, Re      7 :Author: Glauber Costa <glommer@redhat.com>, Red Hat Inc, 2010
  8                                                     8 
  9 KVM makes use of some custom MSRs to service s      9 KVM makes use of some custom MSRs to service some requests.
 10                                                    10 
 11 Custom MSRs have a range reserved for them, th     11 Custom MSRs have a range reserved for them, that goes from
 12 0x4b564d00 to 0x4b564dff. There are MSRs outsi     12 0x4b564d00 to 0x4b564dff. There are MSRs outside this area,
 13 but they are deprecated and their use is disco     13 but they are deprecated and their use is discouraged.
 14                                                    14 
 15 Custom MSR list                                    15 Custom MSR list
 16 ---------------                                    16 ---------------
 17                                                    17 
 18 The current supported Custom MSR list is:          18 The current supported Custom MSR list is:
 19                                                    19 
 20 MSR_KVM_WALL_CLOCK_NEW:                            20 MSR_KVM_WALL_CLOCK_NEW:
 21         0x4b564d00                                 21         0x4b564d00
 22                                                    22 
 23 data:                                              23 data:
 24         4-byte alignment physical address of a     24         4-byte alignment physical address of a memory area which must be
 25         in guest RAM. This memory is expected      25         in guest RAM. This memory is expected to hold a copy of the following
 26         structure::                                26         structure::
 27                                                    27 
 28          struct pvclock_wall_clock {               28          struct pvclock_wall_clock {
 29                 u32   version;                     29                 u32   version;
 30                 u32   sec;                         30                 u32   sec;
 31                 u32   nsec;                        31                 u32   nsec;
 32           } __attribute__((__packed__));           32           } __attribute__((__packed__));
 33                                                    33 
 34         whose data will be filled in by the hy     34         whose data will be filled in by the hypervisor. The hypervisor is only
 35         guaranteed to update this data at the      35         guaranteed to update this data at the moment of MSR write.
 36         Users that want to reliably query this     36         Users that want to reliably query this information more than once have
 37         to write more than once to this MSR. F     37         to write more than once to this MSR. Fields have the following meanings:
 38                                                    38 
 39         version:                                   39         version:
 40                 guest has to check version bef     40                 guest has to check version before and after grabbing
 41                 time information and check tha     41                 time information and check that they are both equal and even.
 42                 An odd version indicates an in     42                 An odd version indicates an in-progress update.
 43                                                    43 
 44         sec:                                       44         sec:
 45                  number of seconds for wallclo     45                  number of seconds for wallclock at time of boot.
 46                                                    46 
 47         nsec:                                      47         nsec:
 48                  number of nanoseconds for wal     48                  number of nanoseconds for wallclock at time of boot.
 49                                                    49 
 50         In order to get the current wallclock      50         In order to get the current wallclock time, the system_time from
 51         MSR_KVM_SYSTEM_TIME_NEW needs to be ad     51         MSR_KVM_SYSTEM_TIME_NEW needs to be added.
 52                                                    52 
 53         Note that although MSRs are per-CPU en     53         Note that although MSRs are per-CPU entities, the effect of this
 54         particular MSR is global.                  54         particular MSR is global.
 55                                                    55 
 56         Availability of this MSR must be check     56         Availability of this MSR must be checked via bit 3 in 0x4000001 cpuid
 57         leaf prior to usage.                       57         leaf prior to usage.
 58                                                    58 
 59 MSR_KVM_SYSTEM_TIME_NEW:                           59 MSR_KVM_SYSTEM_TIME_NEW:
 60         0x4b564d01                                 60         0x4b564d01
 61                                                    61 
 62 data:                                              62 data:
 63         4-byte aligned physical address of a m     63         4-byte aligned physical address of a memory area which must be in
 64         guest RAM, plus an enable bit in bit 0     64         guest RAM, plus an enable bit in bit 0. This memory is expected to hold
 65         a copy of the following structure::        65         a copy of the following structure::
 66                                                    66 
 67           struct pvclock_vcpu_time_info {          67           struct pvclock_vcpu_time_info {
 68                 u32   version;                     68                 u32   version;
 69                 u32   pad0;                        69                 u32   pad0;
 70                 u64   tsc_timestamp;               70                 u64   tsc_timestamp;
 71                 u64   system_time;                 71                 u64   system_time;
 72                 u32   tsc_to_system_mul;           72                 u32   tsc_to_system_mul;
 73                 s8    tsc_shift;                   73                 s8    tsc_shift;
 74                 u8    flags;                       74                 u8    flags;
 75                 u8    pad[2];                      75                 u8    pad[2];
 76           } __attribute__((__packed__)); /* 32     76           } __attribute__((__packed__)); /* 32 bytes */
 77                                                    77 
 78         whose data will be filled in by the hy     78         whose data will be filled in by the hypervisor periodically. Only one
 79         write, or registration, is needed for      79         write, or registration, is needed for each VCPU. The interval between
 80         updates of this structure is arbitrary     80         updates of this structure is arbitrary and implementation-dependent.
 81         The hypervisor may update this structu     81         The hypervisor may update this structure at any time it sees fit until
 82         anything with bit0 == 0 is written to      82         anything with bit0 == 0 is written to it.
 83                                                    83 
 84         Fields have the following meanings:        84         Fields have the following meanings:
 85                                                    85 
 86         version:                                   86         version:
 87                 guest has to check version bef     87                 guest has to check version before and after grabbing
 88                 time information and check tha     88                 time information and check that they are both equal and even.
 89                 An odd version indicates an in     89                 An odd version indicates an in-progress update.
 90                                                    90 
 91         tsc_timestamp:                             91         tsc_timestamp:
 92                 the tsc value at the current V     92                 the tsc value at the current VCPU at the time
 93                 of the update of this structur     93                 of the update of this structure. Guests can subtract this value
 94                 from current tsc to derive a n     94                 from current tsc to derive a notion of elapsed time since the
 95                 structure update.                  95                 structure update.
 96                                                    96 
 97         system_time:                               97         system_time:
 98                 a host notion of monotonic tim     98                 a host notion of monotonic time, including sleep
 99                 time at the time this structur     99                 time at the time this structure was last updated. Unit is
100                 nanoseconds.                      100                 nanoseconds.
101                                                   101 
102         tsc_to_system_mul:                        102         tsc_to_system_mul:
103                 multiplier to be used when con    103                 multiplier to be used when converting
104                 tsc-related quantity to nanose    104                 tsc-related quantity to nanoseconds
105                                                   105 
106         tsc_shift:                                106         tsc_shift:
107                 shift to be used when converti    107                 shift to be used when converting tsc-related
108                 quantity to nanoseconds. This     108                 quantity to nanoseconds. This shift will ensure that
109                 multiplication with tsc_to_sys    109                 multiplication with tsc_to_system_mul does not overflow.
110                 A positive value denotes a lef    110                 A positive value denotes a left shift, a negative value
111                 a right shift.                    111                 a right shift.
112                                                   112 
113                 The conversion from tsc to nan    113                 The conversion from tsc to nanoseconds involves an additional
114                 right shift by 32 bits. With t    114                 right shift by 32 bits. With this information, guests can
115                 derive per-CPU time by doing::    115                 derive per-CPU time by doing::
116                                                   116 
117                         time = (current_tsc -     117                         time = (current_tsc - tsc_timestamp)
118                         if (tsc_shift >= 0)       118                         if (tsc_shift >= 0)
119                                 time <<= tsc_s    119                                 time <<= tsc_shift;
120                         else                      120                         else
121                                 time >>= -tsc_    121                                 time >>= -tsc_shift;
122                         time = (time * tsc_to_    122                         time = (time * tsc_to_system_mul) >> 32
123                         time = time + system_t    123                         time = time + system_time
124                                                   124 
125         flags:                                    125         flags:
126                 bits in this field indicate ex    126                 bits in this field indicate extended capabilities
127                 coordinated between the guest     127                 coordinated between the guest and the hypervisor. Availability
128                 of specific flags has to be ch    128                 of specific flags has to be checked in 0x40000001 cpuid leaf.
129                 Current flags are:                129                 Current flags are:
130                                                   130 
131                                                   131 
132                 +-----------+--------------+--    132                 +-----------+--------------+----------------------------------+
133                 | flag bit  | cpuid bit    | m    133                 | flag bit  | cpuid bit    | meaning                          |
134                 +-----------+--------------+--    134                 +-----------+--------------+----------------------------------+
135                 |           |              | t    135                 |           |              | time measures taken across       |
136                 |    0      |      24      | m    136                 |    0      |      24      | multiple cpus are guaranteed to  |
137                 |           |              | b    137                 |           |              | be monotonic                     |
138                 +-----------+--------------+--    138                 +-----------+--------------+----------------------------------+
139                 |           |              | g    139                 |           |              | guest vcpu has been paused by    |
140                 |    1      |     N/A      | t    140                 |    1      |     N/A      | the host                         |
141                 |           |              | S    141                 |           |              | See 4.70 in api.txt              |
142                 +-----------+--------------+--    142                 +-----------+--------------+----------------------------------+
143                                                   143 
144         Availability of this MSR must be check    144         Availability of this MSR must be checked via bit 3 in 0x4000001 cpuid
145         leaf prior to usage.                      145         leaf prior to usage.
146                                                   146 
147                                                   147 
148 MSR_KVM_WALL_CLOCK:                               148 MSR_KVM_WALL_CLOCK:
149         0x11                                      149         0x11
150                                                   150 
151 data and functioning:                             151 data and functioning:
152         same as MSR_KVM_WALL_CLOCK_NEW. Use th    152         same as MSR_KVM_WALL_CLOCK_NEW. Use that instead.
153                                                   153 
154         This MSR falls outside the reserved KV    154         This MSR falls outside the reserved KVM range and may be removed in the
155         future. Its usage is deprecated.          155         future. Its usage is deprecated.
156                                                   156 
157         Availability of this MSR must be check    157         Availability of this MSR must be checked via bit 0 in 0x4000001 cpuid
158         leaf prior to usage.                      158         leaf prior to usage.
159                                                   159 
160 MSR_KVM_SYSTEM_TIME:                              160 MSR_KVM_SYSTEM_TIME:
161         0x12                                      161         0x12
162                                                   162 
163 data and functioning:                             163 data and functioning:
164         same as MSR_KVM_SYSTEM_TIME_NEW. Use t    164         same as MSR_KVM_SYSTEM_TIME_NEW. Use that instead.
165                                                   165 
166         This MSR falls outside the reserved KV    166         This MSR falls outside the reserved KVM range and may be removed in the
167         future. Its usage is deprecated.          167         future. Its usage is deprecated.
168                                                   168 
169         Availability of this MSR must be check    169         Availability of this MSR must be checked via bit 0 in 0x4000001 cpuid
170         leaf prior to usage.                      170         leaf prior to usage.
171                                                   171 
172         The suggested algorithm for detecting     172         The suggested algorithm for detecting kvmclock presence is then::
173                                                   173 
174                 if (!kvm_para_available())        174                 if (!kvm_para_available())    /* refer to cpuid.txt */
175                         return NON_PRESENT;       175                         return NON_PRESENT;
176                                                   176 
177                 flags = cpuid_eax(0x40000001);    177                 flags = cpuid_eax(0x40000001);
178                 if (flags & 3) {                  178                 if (flags & 3) {
179                         msr_kvm_system_time =     179                         msr_kvm_system_time = MSR_KVM_SYSTEM_TIME_NEW;
180                         msr_kvm_wall_clock = M    180                         msr_kvm_wall_clock = MSR_KVM_WALL_CLOCK_NEW;
181                         return PRESENT;           181                         return PRESENT;
182                 } else if (flags & 0) {           182                 } else if (flags & 0) {
183                         msr_kvm_system_time =     183                         msr_kvm_system_time = MSR_KVM_SYSTEM_TIME;
184                         msr_kvm_wall_clock = M    184                         msr_kvm_wall_clock = MSR_KVM_WALL_CLOCK;
185                         return PRESENT;           185                         return PRESENT;
186                 } else                            186                 } else
187                         return NON_PRESENT;       187                         return NON_PRESENT;
188                                                   188 
189 MSR_KVM_ASYNC_PF_EN:                              189 MSR_KVM_ASYNC_PF_EN:
190         0x4b564d02                                190         0x4b564d02
191                                                   191 
192 data:                                             192 data:
193         Asynchronous page fault (APF) control     193         Asynchronous page fault (APF) control MSR.
194                                                   194 
195         Bits 63-6 hold 64-byte aligned physica    195         Bits 63-6 hold 64-byte aligned physical address of a 64 byte memory area
196         which must be in guest RAM. This memor    196         which must be in guest RAM. This memory is expected to hold the
197         following structure::                     197         following structure::
198                                                   198 
199           struct kvm_vcpu_pv_apf_data {           199           struct kvm_vcpu_pv_apf_data {
200                 /* Used for 'page not present'    200                 /* Used for 'page not present' events delivered via #PF */
201                 __u32 flags;                      201                 __u32 flags;
202                                                   202 
203                 /* Used for 'page ready' event    203                 /* Used for 'page ready' events delivered via interrupt notification */
204                 __u32 token;                      204                 __u32 token;
205                                                   205 
206                 __u8 pad[56];                     206                 __u8 pad[56];
207           };                                      207           };
208                                                   208 
209         Bits 5-4 of the MSR are reserved and s    209         Bits 5-4 of the MSR are reserved and should be zero. Bit 0 is set to 1
210         when asynchronous page faults are enab    210         when asynchronous page faults are enabled on the vcpu, 0 when disabled.
211         Bit 1 is 1 if asynchronous page faults    211         Bit 1 is 1 if asynchronous page faults can be injected when vcpu is in
212         cpl == 0. Bit 2 is 1 if asynchronous p    212         cpl == 0. Bit 2 is 1 if asynchronous page faults are delivered to L1 as
213         #PF vmexits.  Bit 2 can be set only if    213         #PF vmexits.  Bit 2 can be set only if KVM_FEATURE_ASYNC_PF_VMEXIT is
214         present in CPUID. Bit 3 enables interr    214         present in CPUID. Bit 3 enables interrupt based delivery of 'page ready'
215         events. Bit 3 can only be set if KVM_F    215         events. Bit 3 can only be set if KVM_FEATURE_ASYNC_PF_INT is present in
216         CPUID.                                    216         CPUID.
217                                                   217 
218         'Page not present' events are currentl    218         'Page not present' events are currently always delivered as synthetic
219         #PF exception. During delivery of thes    219         #PF exception. During delivery of these events APF CR2 register contains
220         a token that will be used to notify th    220         a token that will be used to notify the guest when missing page becomes
221         available. Also, to make it possible t    221         available. Also, to make it possible to distinguish between real #PF and
222         APF, first 4 bytes of 64 byte memory l    222         APF, first 4 bytes of 64 byte memory location ('flags') will be written
223         to by the hypervisor at the time of in    223         to by the hypervisor at the time of injection. Only first bit of 'flags'
224         is currently supported, when set, it i    224         is currently supported, when set, it indicates that the guest is dealing
225         with asynchronous 'page not present' e    225         with asynchronous 'page not present' event. If during a page fault APF
226         'flags' is '0' it means that this is r    226         'flags' is '0' it means that this is regular page fault. Guest is
227         supposed to clear 'flags' when it is d    227         supposed to clear 'flags' when it is done handling #PF exception so the
228         next event can be delivered.              228         next event can be delivered.
229                                                   229 
230         Note, since APF 'page not present' eve    230         Note, since APF 'page not present' events use the same exception vector
231         as regular page fault, guest must rese    231         as regular page fault, guest must reset 'flags' to '0' before it does
232         something that can generate normal pag    232         something that can generate normal page fault.
233                                                   233 
234         Bytes 4-7 of 64 byte memory location (    234         Bytes 4-7 of 64 byte memory location ('token') will be written to by the
235         hypervisor at the time of APF 'page re    235         hypervisor at the time of APF 'page ready' event injection. The content
236         of these bytes is a token which was pr    236         of these bytes is a token which was previously delivered in CR2 as
237         'page not present' event. The event in    237         'page not present' event. The event indicates the page is now available.
238         Guest is supposed to write '0' to 'tok    238         Guest is supposed to write '0' to 'token' when it is done handling
239         'page ready' event and to write '1' to    239         'page ready' event and to write '1' to MSR_KVM_ASYNC_PF_ACK after
240         clearing the location; writing to the     240         clearing the location; writing to the MSR forces KVM to re-scan its
241         queue and deliver the next pending not    241         queue and deliver the next pending notification.
242                                                   242 
243         Note, MSR_KVM_ASYNC_PF_INT MSR specify    243         Note, MSR_KVM_ASYNC_PF_INT MSR specifying the interrupt vector for 'page
244         ready' APF delivery needs to be writte    244         ready' APF delivery needs to be written to before enabling APF mechanism
245         in MSR_KVM_ASYNC_PF_EN or interrupt #0    245         in MSR_KVM_ASYNC_PF_EN or interrupt #0 can get injected. The MSR is
246         available if KVM_FEATURE_ASYNC_PF_INT     246         available if KVM_FEATURE_ASYNC_PF_INT is present in CPUID.
247                                                   247 
248         Note, previously, 'page ready' events     248         Note, previously, 'page ready' events were delivered via the same #PF
249         exception as 'page not present' events    249         exception as 'page not present' events but this is now deprecated. If
250         bit 3 (interrupt based delivery) is no    250         bit 3 (interrupt based delivery) is not set APF events are not delivered.
251                                                   251 
252         If APF is disabled while there are out    252         If APF is disabled while there are outstanding APFs, they will
253         not be delivered.                         253         not be delivered.
254                                                   254 
255         Currently 'page ready' APF events will    255         Currently 'page ready' APF events will be always delivered on the
256         same vcpu as 'page not present' event     256         same vcpu as 'page not present' event was, but guest should not rely on
257         that.                                     257         that.
258                                                   258 
259 MSR_KVM_STEAL_TIME:                               259 MSR_KVM_STEAL_TIME:
260         0x4b564d03                                260         0x4b564d03
261                                                   261 
262 data:                                             262 data:
263         64-byte alignment physical address of     263         64-byte alignment physical address of a memory area which must be
264         in guest RAM, plus an enable bit in bi    264         in guest RAM, plus an enable bit in bit 0. This memory is expected to
265         hold a copy of the following structure    265         hold a copy of the following structure::
266                                                   266 
267           struct kvm_steal_time {                 267           struct kvm_steal_time {
268                 __u64 steal;                      268                 __u64 steal;
269                 __u32 version;                    269                 __u32 version;
270                 __u32 flags;                      270                 __u32 flags;
271                 __u8  preempted;                  271                 __u8  preempted;
272                 __u8  u8_pad[3];                  272                 __u8  u8_pad[3];
273                 __u32 pad[11];                    273                 __u32 pad[11];
274           }                                       274           }
275                                                   275 
276         whose data will be filled in by the hy    276         whose data will be filled in by the hypervisor periodically. Only one
277         write, or registration, is needed for     277         write, or registration, is needed for each VCPU. The interval between
278         updates of this structure is arbitrary    278         updates of this structure is arbitrary and implementation-dependent.
279         The hypervisor may update this structu    279         The hypervisor may update this structure at any time it sees fit until
280         anything with bit0 == 0 is written to     280         anything with bit0 == 0 is written to it. Guest is required to make sure
281         this structure is initialized to zero.    281         this structure is initialized to zero.
282                                                   282 
283         Fields have the following meanings:       283         Fields have the following meanings:
284                                                   284 
285         version:                                  285         version:
286                 a sequence counter. In other w    286                 a sequence counter. In other words, guest has to check
287                 this field before and after gr    287                 this field before and after grabbing time information and make
288                 sure they are both equal and e    288                 sure they are both equal and even. An odd version indicates an
289                 in-progress update.               289                 in-progress update.
290                                                   290 
291         flags:                                    291         flags:
292                 At this point, always zero. Ma    292                 At this point, always zero. May be used to indicate
293                 changes in this structure in t    293                 changes in this structure in the future.
294                                                   294 
295         steal:                                    295         steal:
296                 the amount of time in which th    296                 the amount of time in which this vCPU did not run, in
297                 nanoseconds. Time during which    297                 nanoseconds. Time during which the vcpu is idle, will not be
298                 reported as steal time.           298                 reported as steal time.
299                                                   299 
300         preempted:                                300         preempted:
301                 indicate the vCPU who owns thi    301                 indicate the vCPU who owns this struct is running or
302                 not. Non-zero values mean the     302                 not. Non-zero values mean the vCPU has been preempted. Zero
303                 means the vCPU is not preempte    303                 means the vCPU is not preempted. NOTE, it is always zero if the
304                 the hypervisor doesn't support    304                 the hypervisor doesn't support this field.
305                                                   305 
306 MSR_KVM_EOI_EN:                                   306 MSR_KVM_EOI_EN:
307         0x4b564d04                                307         0x4b564d04
308                                                   308 
309 data:                                             309 data:
310         Bit 0 is 1 when PV end of interrupt is    310         Bit 0 is 1 when PV end of interrupt is enabled on the vcpu; 0
311         when disabled.  Bit 1 is reserved and     311         when disabled.  Bit 1 is reserved and must be zero.  When PV end of
312         interrupt is enabled (bit 0 set), bits    312         interrupt is enabled (bit 0 set), bits 63-2 hold a 4-byte aligned
313         physical address of a 4 byte memory ar    313         physical address of a 4 byte memory area which must be in guest RAM and
314         must be zeroed.                           314         must be zeroed.
315                                                   315 
316         The first, least significant bit of 4     316         The first, least significant bit of 4 byte memory location will be
317         written to by the hypervisor, typicall    317         written to by the hypervisor, typically at the time of interrupt
318         injection.  Value of 1 means that gues    318         injection.  Value of 1 means that guest can skip writing EOI to the apic
319         (using MSR or MMIO write); instead, it    319         (using MSR or MMIO write); instead, it is sufficient to signal
320         EOI by clearing the bit in guest memor    320         EOI by clearing the bit in guest memory - this location will
321         later be polled by the hypervisor.        321         later be polled by the hypervisor.
322         Value of 0 means that the EOI write is    322         Value of 0 means that the EOI write is required.
323                                                   323 
324         It is always safe for the guest to ign    324         It is always safe for the guest to ignore the optimization and perform
325         the APIC EOI write anyway.                325         the APIC EOI write anyway.
326                                                   326 
327         Hypervisor is guaranteed to only modif    327         Hypervisor is guaranteed to only modify this least
328         significant bit while in the current V    328         significant bit while in the current VCPU context, this means that
329         guest does not need to use either lock    329         guest does not need to use either lock prefix or memory ordering
330         primitives to synchronise with the hyp    330         primitives to synchronise with the hypervisor.
331                                                   331 
332         However, hypervisor can set and clear     332         However, hypervisor can set and clear this memory bit at any time:
333         therefore to make sure hypervisor does    333         therefore to make sure hypervisor does not interrupt the
334         guest and clear the least significant     334         guest and clear the least significant bit in the memory area
335         in the window between guest testing it    335         in the window between guest testing it to detect
336         whether it can skip EOI apic write and    336         whether it can skip EOI apic write and between guest
337         clearing it to signal EOI to the hyper    337         clearing it to signal EOI to the hypervisor,
338         guest must both read the least signifi    338         guest must both read the least significant bit in the memory area and
339         clear it using a single CPU instructio    339         clear it using a single CPU instruction, such as test and clear, or
340         compare and exchange.                     340         compare and exchange.
341                                                   341 
342 MSR_KVM_POLL_CONTROL:                             342 MSR_KVM_POLL_CONTROL:
343         0x4b564d05                                343         0x4b564d05
344                                                   344 
345         Control host-side polling.                345         Control host-side polling.
346                                                   346 
347 data:                                             347 data:
348         Bit 0 enables (1) or disables (0) host    348         Bit 0 enables (1) or disables (0) host-side HLT polling logic.
349                                                   349 
350         KVM guests can request the host not to    350         KVM guests can request the host not to poll on HLT, for example if
351         they are performing polling themselves    351         they are performing polling themselves.
352                                                   352 
353 MSR_KVM_ASYNC_PF_INT:                             353 MSR_KVM_ASYNC_PF_INT:
354         0x4b564d06                                354         0x4b564d06
355                                                   355 
356 data:                                             356 data:
357         Second asynchronous page fault (APF) c    357         Second asynchronous page fault (APF) control MSR.
358                                                   358 
359         Bits 0-7: APIC vector for delivery of     359         Bits 0-7: APIC vector for delivery of 'page ready' APF events.
360         Bits 8-63: Reserved                       360         Bits 8-63: Reserved
361                                                   361 
362         Interrupt vector for asynchnonous 'pag    362         Interrupt vector for asynchnonous 'page ready' notifications delivery.
363         The vector has to be set up before asy    363         The vector has to be set up before asynchronous page fault mechanism
364         is enabled in MSR_KVM_ASYNC_PF_EN.  Th    364         is enabled in MSR_KVM_ASYNC_PF_EN.  The MSR is only available if
365         KVM_FEATURE_ASYNC_PF_INT is present in    365         KVM_FEATURE_ASYNC_PF_INT is present in CPUID.
366                                                   366 
367 MSR_KVM_ASYNC_PF_ACK:                             367 MSR_KVM_ASYNC_PF_ACK:
368         0x4b564d07                                368         0x4b564d07
369                                                   369 
370 data:                                             370 data:
371         Asynchronous page fault (APF) acknowle    371         Asynchronous page fault (APF) acknowledgment.
372                                                   372 
373         When the guest is done processing 'pag    373         When the guest is done processing 'page ready' APF event and 'token'
374         field in 'struct kvm_vcpu_pv_apf_data'    374         field in 'struct kvm_vcpu_pv_apf_data' is cleared it is supposed to
375         write '1' to bit 0 of the MSR, this ca    375         write '1' to bit 0 of the MSR, this causes the host to re-scan its queue
376         and check if there are more notificati    376         and check if there are more notifications pending. The MSR is available
377         if KVM_FEATURE_ASYNC_PF_INT is present    377         if KVM_FEATURE_ASYNC_PF_INT is present in CPUID.
378                                                   378 
379 MSR_KVM_MIGRATION_CONTROL:                        379 MSR_KVM_MIGRATION_CONTROL:
380         0x4b564d08                                380         0x4b564d08
381                                                   381 
382 data:                                             382 data:
383         This MSR is available if KVM_FEATURE_M    383         This MSR is available if KVM_FEATURE_MIGRATION_CONTROL is present in
384         CPUID.  Bit 0 represents whether live     384         CPUID.  Bit 0 represents whether live migration of the guest is allowed.
385                                                   385 
386         When a guest is started, bit 0 will be    386         When a guest is started, bit 0 will be 0 if the guest has encrypted
387         memory and 1 if the guest does not hav    387         memory and 1 if the guest does not have encrypted memory.  If the
388         guest is communicating page encryption    388         guest is communicating page encryption status to the host using the
389         ``KVM_HC_MAP_GPA_RANGE`` hypercall, it    389         ``KVM_HC_MAP_GPA_RANGE`` hypercall, it can set bit 0 in this MSR to
390         allow live migration of the guest.        390         allow live migration of the guest.
                                                      

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php