[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [PATCH] docs/xen-tscmode: remove mention of numeric tsc_mode= values
The better to encourage moving to setting via string mode names. Signed-off-by: Elliott Mitchell <ehem+xen@xxxxxxx> --- I'm not actually sure what tsc_mode==0 does. I didn't find other references, so I'm unsure how that should be modified. --- docs/man/xen-tscmode.7.pod | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/man/xen-tscmode.7.pod b/docs/man/xen-tscmode.7.pod index 1d81a3fe18..80aea77f76 100644 --- a/docs/man/xen-tscmode.7.pod +++ b/docs/man/xen-tscmode.7.pod @@ -63,19 +63,19 @@ The non-default choices for tsc_mode are: =over 4 -=item * B<tsc_mode=1> (always emulate). +=item * B<tsc_mode='always_emulate'> (always emulate). All rdtsc instructions are emulated; this is the best choice when TSC-sensitive apps are running and it is necessary to understand worst-case performance degradation for a specific hardware environment. -=item * B<tsc_mode=2> (never emulate). +=item * B<tsc_mode='native'> (never emulate). This is the same as prior to Xen 4.0 and is the best choice if it is certain that all apps running in this VM are TSC-resilient and highest performance is required. -=item * B<tsc_mode=3> (PVRDTSCP). +=item * B<tsc_mode='native_paravirt'> (PVRDTSCP). This mode has been removed. @@ -200,10 +200,10 @@ per second per processor), this performance degradation is not noticeable OS-provided alternatives (e.g. Linux's gettimeofday). For environments where it is certain that all apps are TSC-resilient (e.g. "TSC-safeness" is not necessary) and highest performance is a -requirement, TSC emulation may be entirely disabled (tsc_mode==2). +requirement, TSC emulation may be entirely disabled (tsc_mode='native'). -The default mode (tsc_mode==0) checks TSC-safeness of the underlying -hardware on which the virtual machine is launched. If it is +The default mode (tsc_mode='always_emulate') checks TSC-safeness of the +underlying hardware on which the virtual machine is launched. If it is TSC-safe, rdtsc will execute at hardware speed; if it is not, rdtsc will be emulated. Once a virtual machine is save/restored or migrated, however, there are two possibilities: TSC remains native IF the source @@ -213,12 +213,13 @@ is emulated. Note that, though emulated, the "apparent" TSC frequency will be the TSC frequency of the initial physical machine, even after migration. -Finally, tsc_mode==1 always enables TSC emulation, regardless of +Finally, tsc_mode='always_emulate' always enables TSC emulation, regardless of the underlying physical hardware. The "apparent" TSC frequency will be the TSC frequency of the initial physical machine, even after migration. This mode is useful to measure any performance degradation that might be encountered by a tsc_mode==0 domain after migration occurs, -or a tsc_mode==3 domain when it is running on TSC-unsafe hardware. +or a tsc_mode='native_paravirt' domain when it is running on +TSC-unsafe hardware. Note that while Xen ensures that an emulated TSC is "safe" across migration, it does not ensure that it continues to tick at the same rate during -- 2.30.2
|
Lists.xenproject.org is hosted with RackSpace, monitoring our |