Ian Campbell
2012-Mar-26 16:12 UTC
[PATCH 0 of 3 DOCDAY] updates to Xen command line argument documentation
The following patches update misc/xen-command-line.markdown. Resend with Andrew Coopers comments addressed.
Ian Campbell
2012-Mar-26 16:12 UTC
[PATCH 1 of 3 DOCDAY] docs: wrap misc/xen-command-line.markdown to 80 columns
# HG changeset patch # User Ian Campbell <ian.campbell@citrix.com> # Date 1332778180 -3600 # Node ID a09fd3911dc9b659bba7ad4070a0dfb234532359 # Parent d8e15dc99bf307bd0ae0b042f1d50409b9f26386 docs: wrap misc/xen-command-line.markdown to 80 columns Makes it more readable as a text document. Signed-off-by: Ian Campbell <ian.campbell@citrix.com> diff -r d8e15dc99bf3 -r a09fd3911dc9 docs/misc/xen-command-line.markdown --- a/docs/misc/xen-command-line.markdown Mon Mar 26 10:07:40 2012 +0100 +++ b/docs/misc/xen-command-line.markdown Mon Mar 26 17:09:40 2012 +0100 @@ -1,12 +1,17 @@ # Xen Hypervisor Command Line Options -**This document is still a work in progress. There are currently some command line options listed twice, and they are defined in separate arch trees, and some options are currently separate from their legacy versions. Please remove this notice when complete.** +**This document is still a work in progress. There are currently some + command line options listed twice, and they are defined in separate + arch trees, and some options are currently separate from their + legacy versions. Please remove this notice when complete.** -This document coveres the command line options which the Xen Hypervisor. +This document coveres the command line options which the Xen +Hypervisor. ## Types of parameter -Most parameters take the form `option=value`. Different options on the command line should be space delimited. +Most parameters take the form `option=value`. Different options on +the command line should be space delimited. ### Boolean (`<boolean>`) @@ -16,7 +21,8 @@ All boolean option may be explicitly ena They may be explicitly disabled using a `value` of > `no`, `off`, `false`, `disable` or `0` -In addition, a boolean option may be enabled by simply stating its name, and may be disabled by prefixing its name with `no-`. +In addition, a boolean option may be enabled by simply stating its +name, and may be disabled by prefixing its name with `no-`. ####Examples @@ -31,7 +37,10 @@ Enable synchronous console mode ### Integer (`<integer>`) -An integer parameter will default to decimal and may be prefixed with a `-` for negative numbers. Alternativly, a hexidecimal number may be used by prefixing the number with `0x`, or an octal number may be used if a leading `0` is present. +An integer parameter will default to decimal and may be prefixed with +a `-` for negative numbers. Alternativly, a hexidecimal number may be +used by prefixing the number with `0x`, or an octal number may be used +if a leading `0` is present. ### Size (`<size>`) @@ -46,7 +55,9 @@ Without a size suffix, the default will ### String -Many parameters are more complicated and require more intricate configuration. The detailed description of each individual paramter specify which values are valid. +Many parameters are more complicated and require more intricate +configuration. The detailed description of each individual paramter +specify which values are valid. ### List @@ -54,7 +65,8 @@ Some options take a comma separated list ### Combination -Some parameters act as combinations of the above, most commonly a mix of Boolean and String. These are noted in the relevant sections. +Some parameters act as combinations of the above, most commonly a mix +of Boolean and String. These are noted in the relevant sections. ## Parameter details @@ -63,20 +75,32 @@ Some parameters act as combinations of t **String**, or **Boolean** to disable. -The `acpi` option is used to control a set of four related boolean flags; `acpi_force`, `acpi_ht`, `acpi_noirq` and `acpi_disabled`. +The `acpi` option is used to control a set of four related boolean +flags; `acpi_force`, `acpi_ht`, `acpi_noirq` and `acpi_disabled`. -By default, Xen will scan the DMI data and blacklist certain systems which are known to have broken ACPI setups. Providing `acpi=force` will cause Xen to ignore the blacklist and attempt to use all ACPI features. +By default, Xen will scan the DMI data and blacklist certain systems +which are known to have broken ACPI setups. Providing `acpi=force` +will cause Xen to ignore the blacklist and attempt to use all ACPI +features. -Using `acpi=ht` causes Xen to parse the ACPI tables enough to enumerate all CPUs, but will not use other ACPI features. This is not common, and only has an effect if your system is blacklisted. +Using `acpi=ht` causes Xen to parse the ACPI tables enough to +enumerate all CPUs, but will not use other ACPI features. This is not +common, and only has an effect if your system is blacklisted. -The `acpi=noirq` option causes Xen to not parse the ACPI MADT table looking for IO-APIC entries. This is also not common, and any system which requries this option to function should be blacklisted. Additionally, this will not prevent Xen from finding IO-APIC entries from the MP tables. +The `acpi=noirq` option causes Xen to not parse the ACPI MADT table +looking for IO-APIC entries. This is also not common, and any system +which requries this option to function should be blacklisted. +Additionally, this will not prevent Xen from finding IO-APIC entries +from the MP tables. -Finally, any of the boolean false options can be used to disable ACPI usage entirely. +Finally, any of the boolean false options can be used to disable ACPI +usage entirely. ### acpi\_apic\_instance > `= <integer>` -Specify which ACPI MADT table to parse for APIC information, if more than one is present. +Specify which ACPI MADT table to parse for APIC information, if more +than one is present. ### acpi\_pstate\_strict ### acpi\_skip\_timer\_override @@ -86,7 +110,9 @@ Specify which ACPI MADT table to parse f ### apic > `= summit | bigsmp | default` -Override Xen''s logic for choosing the APIC driver. By default, if there are more than 8 CPUs, Xen will switch to `bigsmp` over `default`. +Override Xen''s logic for choosing the APIC driver. By default, if +there are more than 8 CPUs, Xen will switch to `bigsmp` over +`default`. ### apic\_verbosity > `= verbose | debug` @@ -98,7 +124,10 @@ Increase the verbosity of the APIC code ### badpage > `= List of [ <integer> | <integer>-<integer> ]` -Specify that certain pages, or certain ranges of pages contain bad bytes and should not be used. For example, if your memory tester says that byte `0x12345678` is bad, you would place `badpage=0x12345` on Xen''s command line. +Specify that certain pages, or certain ranges of pages contain bad +bytes and should not be used. For example, if your memory tester says +that byte `0x12345678` is bad, you would place `badpage=0x12345` on +Xen''s command line. ### bootscrub ### cachesize @@ -108,9 +137,11 @@ Specify that certain pages, or certain r Both option `com1` and `com2` follow the same format. -* `<baud>` may be either an integer baud rate, or the string `auto` if the bootloader or other earlier firmware has already set it up. +* `<baud>` may be either an integer baud rate, or the string `auto` if + the bootloader or other earlier firmware has already set it up. * Optionally, a clock speed measured in hz can be specified. -* `DPS` represents the number of data bits, the parity, and the number of stop bits. +* `DPS` represents the number of data bits, the parity, and the number + of stop bits. `D` is an integer between 5 and 8 for the number of data bits. @@ -124,12 +155,18 @@ Both option `com1` and `com2` follow the `S` is an integer 1 or 2 for the number of stop bits. -* `<io-base>` is an integer which specifies the IO base port for UART registers. -* `<irq> ` is the IRQ number to use, or `0` to use the UART in poll mode only. -* `<port-bdf>` is the PCI location of the UART, in `<bus>:<device>.<function>` notation. -* `<bridge-bdf>` is the PCI bridge behind which is the UART, in `<bus>:<device>.<function>` notation. -* `pci` indicates that Xen should scan the PCI bus for the UART, avoiding Intel AMT devices. -* `amt` indicated that Xen should scan the PCI bus for the UART, including Intel AMT devices if presetn. +* `<io-base>` is an integer which specifies the IO base port for UART + registers. +* `<irq>` is the IRQ number to use, or `0` to use the UART in poll + mode only. +* `<port-bdf>` is the PCI location of the UART, in + `<bus>:<device>.<function>` notation. +* `<bridge-bdf>` is the PCI bridge behind which is the UART, in + `<bus>:<device>.<function>` notation. +* `pci` indicates that Xen should scan the PCI bus for the UART, + avoiding Intel AMT devices. +* `amt` indicated that Xen should scan the PCI bus for the UART, + including Intel AMT devices if presetn. A typical setup for most situations might be `com1=115200,8n1` @@ -150,9 +187,16 @@ Specify which console(s) Xen should use. `vga` indicates that Xen should try and use the vga graphics adapter. -`com1` and `com2` indicates that Xen should use serial ports 1 and 2 respectivly. Optionally, these arguments may be followed by an `H` or `L`. `H` indicates that transmitted characters will have their MSB set, while recieved characters must have their MSB set. `L` indicates the converse; transmitted and recieved characters will have their MSB cleared. This allows a single port to be shared by two subsystems (e.g. console and debugger). +`com1` and `com2` indicates that Xen should use serial ports 1 and 2 +respectivly. Optionally, these arguments may be followed by an `H` or +`L`. `H` indicates that transmitted characters will have their MSB +set, while recieved characters must have their MSB set. `L` indicates +the converse; transmitted and recieved characters will have their MSB +cleared. This allows a single port to be shared by two subsystems +(e.g. console and debugger). -`none` indicates that Xen should not use a console. This option only makes sense on its own. +`none` indicates that Xen should not use a console. This option only +makes sense on its own. ### console\_timestamps > `= <boolean>` @@ -166,16 +210,22 @@ Flag to indicate whether include a times > Default: `false` -Flag to indicate whether all guest console output should be copied into the console ring buffer. +Flag to indicate whether all guest console output should be copied +into the console ring buffer. ### conswitch > `= <switch char>[,x]` > Default `conswitch=a` -Specify which character should be used to switch serial input between Xen and dom0. The required sequence is CTRL-<switch char> three times. +Specify which character should be used to switch serial input between +Xen and dom0. The required sequence is CTRL-<switch char> three +times. -The optional trailing `x` indicates that Xen should not automatically switch the console input to dom0 during boot. Any other value, including omission, causes Xen to automatically switch to the dom0 console during dom0 boot. +The optional trailing `x` indicates that Xen should not automatically +switch the console input to dom0 during boot. Any other value, +including omission, causes Xen to automatically switch to the dom0 +console during dom0 boot. ### contig\_mem ### cpu\_type @@ -193,7 +243,8 @@ The optional trailing `x` indicates that > Default: `4G` -Specify the maximum address to allocate certain strucutres, if used in combination with the `low_crashinfo` command line option. +Specify the maximum address to allocate certain strucutres, if used in +combination with the `low_crashinfo` command line option. ### crashkernel ### credit2\_balance\_over @@ -211,7 +262,8 @@ Specify the bit width of the DMA heap. ### dom0\_max\_vcpus > `= <integer>` -Specifiy the maximum number of vcpus to give to dom0. This defaults to the number of pcpus on the host. +Specifiy the maximum number of vcpus to give to dom0. This defaults +to the number of pcpus on the host. ### dom0\_mem (ia64) > `= <size>` @@ -260,7 +312,8 @@ Pin dom0 vcpus to their respective pcpus > Default: `guest_loglvl=none/warning` -Set the logging level for Xen guests. Any log message with equal more more importance will be printed. +Set the logging level for Xen guests. Any log message with equal more +more importance will be printed. The optional `<rate-limited level>` options instructs which severities should be rate limited. ### hap\_1gb @@ -276,7 +329,9 @@ The optional `<rate-limited level>` opti ### irq\_vector\_map ### lapic -Force the use of use of the local APIC on a uniprocessor system, even if left disabled by the BIOS. This option will accept any value at all. +Force the use of use of the local APIC on a uniprocessor system, even +if left disabled by the BIOS. This option will accept any value at +all. ### lapic\_timer\_c2\_ok ### ler @@ -285,16 +340,22 @@ Force the use of use of the local APIC o > Default: `loglvl=warning` -Set the logging level for Xen. Any log message with equal more more importance will be printed. +Set the logging level for Xen. Any log message with equal more more +importance will be printed. -The optional `<rate-limited level>` options instructs which severities should be rate limited. +The optional `<rate-limited level>` options instructs which severities +should be rate limited. ### low\_crashinfo > `= none | min | all` > Default: `none` if not specified at all, or to `min` if `low\_crashinfo` is present without qualification. -This option is only useful for hosts with a 32bit dom0 kernel, wishing to use kexec functionality in the case of a crash. It represents which data structures should be deliberatly allocated in low memory, so the crash kernel may find find them. Should be used in combination with `crashinfo_maxaddr`. +This option is only useful for hosts with a 32bit dom0 kernel, wishing +to use kexec functionality in the case of a crash. It represents +which data structures should be deliberatly allocated in low memory, +so the crash kernel may find find them. Should be used in combination +with `crashinfo_maxaddr`. ### max\_cstate ### max\_gsi\_irqs @@ -306,7 +367,8 @@ This option is only useful for hosts wit ### mem > `= <size>` -Specifies the maximum address of physical RAM. Any RAM beyond this limit is ignored by Xen. +Specifies the maximum address of physical RAM. Any RAM beyond this +limit is ignored by Xen. ### mmcfg ### nmi @@ -314,29 +376,37 @@ Specifies the maximum address of physica > Default: `nmi=fatal` -Specify what Xen should do in the event of an NMI parity or I/O error. `ignore` discards the error; `dom0` causes Xen to report the error to dom0, while ''fatal'' causes Xen to print diagnostics and then hang. +Specify what Xen should do in the event of an NMI parity or I/O error. +`ignore` discards the error; `dom0` causes Xen to report the error to +dom0, while ''fatal'' causes Xen to print diagnostics and then hang. ### noapic ### nofxsr ### noirqbalance > `= <boolean>` -Disable software IRQ balancing and affinity. This can be used on systems such as Dell 1850/2850 that have workarounds in hardware for IRQ routing issues. +Disable software IRQ balancing and affinity. This can be used on +systems such as Dell 1850/2850 that have workarounds in hardware for +IRQ routing issues. ### nolapic -Ignore the local APIC on a uniprocessor system, even if enabled by the BIOS. This option will accept value. +Ignore the local APIC on a uniprocessor system, even if enabled by the +BIOS. This option will accept value. ### noreboot > `= <boolean>` -Do not automatically reboot after an error. This is useful for catching debug output. Defaults to automatically reboot after 5 seconds. +Do not automatically reboot after an error. This is useful for +catching debug output. Defaults to automatically reboot after 5 +seconds. ### noserialnumber ### nosmp > `= <boolean>` -Disable SMP support. No secondary processors will be booted. Defaults to booting secondary processors. +Disable SMP support. No secondary processors will be booted. +Defaults to booting secondary processors. ### nr\_irqs ### numa @@ -360,6 +430,7 @@ Choose the default scheduler. > `= <size>` Set the serial tramsit buffer size. Defaults to 16kB. + ### smep ### snb\_igd\_quirk ### sync\_console @@ -367,7 +438,8 @@ Set the serial tramsit buffer size. Def > Default: `false` -Flag to force synchronous console output. Useful for debugging, but not suitable for production environments due to incurred overhead. +Flag to force synchronous console output. Useful for debugging, but +not suitable for production environments due to incurred overhead. ### tboot ### tbuf\_size @@ -395,17 +467,25 @@ Specify the per-cpu trace buffer size in ### vga > `= ( ask | current | text-80x<rows> | gfx-<width>x<height>x<depth> | mode-<mode> )[,keep]` -`ask` causes Xen to display a menu of available modes and request the user to choose one of them. +`ask` causes Xen to display a menu of available modes and request the +user to choose one of them. -`current` causes Xen to use the graphics adapter in its current state, without further setup. +`current` causes Xen to use the graphics adapter in its current state, +without further setup. -`text-80x<rows>` instructs Xen to set up text mode. Valid values for `<rows>` are `25, 28, 30, 34, 43, 50, 80` +`text-80x<rows>` instructs Xen to set up text mode. Valid values for +`<rows>` are `25, 28, 30, 34, 43, 50, 80` -`gfx-<width>x<height>x<depth>` instructs Xen to set up graphics mode with the specified width, height and depth. +`gfx-<width>x<height>x<depth>` instructs Xen to set up graphics mode +with the specified width, height and depth. -`mode-<mode>` instructs Xen to use a specific mode, as shown with the `ask` option. (N.B menu modes are displayed in hex, so `<mode>` should be a hexidecimal number) +`mode-<mode>` instructs Xen to use a specific mode, as shown with the +`ask` option. (N.B menu modes are displayed in hex, so `<mode>` +should be a hexidecimal number) -The optional `keep` parameter causes Xen to continue using the vga console even after dom0 has been started. The default behaviour is to relinquish control to dom0. +The optional `keep` parameter causes Xen to continue using the vga +console even after dom0 has been started. The default behaviour is to +relinquish control to dom0. ### vpid ### vpmu @@ -416,14 +496,16 @@ The optional `keep` parameter causes Xen > Default: `false` -Run an NMI watchdog on each processor. If a processor is stuck for longer than the watchdog\_timeout, a panic occurs. +Run an NMI watchdog on each processor. If a processor is stuck for +longer than the watchdog\_timeout, a panic occurs. ### watchdog\_timeout > `= <integer>` > Default: `5` -Set the NMI watchdog timeout in seconds. Specifying `0` will turn off the watchdog. +Set the NMI watchdog timeout in seconds. Specifying `0` will turn off +the watchdog. ### x2apic ### x2apic\_phys
Ian Campbell
2012-Mar-26 16:12 UTC
[PATCH 2 of 3 DOCDAY] docs: add some missing options to misc/xen-command-line.markdown
# HG changeset patch # User Ian Campbell <ian.campbell@citrix.com> # Date 1332778199 -3600 # Node ID f51f30290b2fb4a63a8d4b9e65bc26a2ba73ff2a # Parent a09fd3911dc9b659bba7ad4070a0dfb234532359 docs: add some missing options to misc/xen-command-line.markdown These were mostly ones from xen/arch/x86/boot/cmdline.S which are handled early and therefore do not use the usual infrastructure and so got missed in the initial trawl. The document now contains (AFAICT) every still valid option which was previously documented at: http://wiki.xen.org/wiki?title=Xen_Hypervisor_Boot_Options&oldid=1379 Signed-off-by: Ian Campbell <ian.campbell@citrix.com> diff -r a09fd3911dc9 -r f51f30290b2f docs/misc/xen-command-line.markdown --- a/docs/misc/xen-command-line.markdown Mon Mar 26 17:09:40 2012 +0100 +++ b/docs/misc/xen-command-line.markdown Mon Mar 26 17:09:59 2012 +0100 @@ -96,6 +96,10 @@ from the MP tables. Finally, any of the boolean false options can be used to disable ACPI usage entirely. +Because responsiblity for ACPI processing is shared between Xen and +the domain 0 kernel this option is automatically propagated to the +domain 0 command line + ### acpi\_apic\_instance > `= <integer>` @@ -103,7 +107,15 @@ Specify which ACPI MADT table to parse f than one is present. ### acpi\_pstate\_strict + ### acpi\_skip\_timer\_override + +Instruct Xen to ignore timer-interrupt override. + +Because responsiblity for ACPI processing is shared between Xen and +the domain 0 kernel this option is automatically propagated to the +domain 0 command line + ### acpi\_sleep ### additional\_cpus ### allowsuperpage @@ -300,8 +312,26 @@ Pin dom0 vcpus to their respective pcpus ### dom\_rid\_bits ### e820-mtrr-clip ### e820-verbose + +### edd (x86) +> `= off | on | skipmbr` + +Control retrieval of Extended Disc Data (EDD) from the BIOS during +boot. + +### edid (x86) +> `= no | force` + +Either force retrieval of monitor EDID information via VESA DDC, or +disable it (edid=no). This option should not normally be required +except for debugging purposes. + ### efi\_print ### extra\_guest\_irqs +> `= <number>` + +Increase the number of PIRQs available for the guest. The default is 32. + ### flask\_enabled ### flask\_enforcing ### font @@ -381,6 +411,15 @@ Specify what Xen should do in the event dom0, while ''fatal'' causes Xen to print diagnostics and then hang. ### noapic + +Instruct Xen to ignore any IOAPICs that are present in the system, and +instead continue to use the legacy PIC. This is _not_ recommended with +pvops type kernels. + +Because responsiblity for APIC setup is shared between Xen and the +domain 0 kernel this option is automatically propagated to the domain +0 command line. + ### nofxsr ### noirqbalance > `= <boolean>` @@ -394,6 +433,12 @@ IRQ routing issues. Ignore the local APIC on a uniprocessor system, even if enabled by the BIOS. This option will accept value. +### no-real-mode (x86) + +Do not execute real-mode bootstrap code when booting Xen. This option +should not be used except for debugging. It will effectively disable +the vga option, which relies on real mode to set the video mode. + ### noreboot > `= <boolean>`
Ian Campbell
2012-Mar-26 16:12 UTC
[PATCH 3 of 3 DOCDAY] docs: spelling and typoes in misc/xen-command-line.markdown
# HG changeset patch # User Ian Campbell <ian.campbell@citrix.com> # Date 1332778273 -3600 # Node ID 1b20c16b76bb70966054dffe971742d8c9dc940c # Parent f51f30290b2fb4a63a8d4b9e65bc26a2ba73ff2a docs: spelling and typoes in misc/xen-command-line.markdown Run a spell checker over the doc and fix the typos and spelling it uncovers (including a few I just added myself). Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Acked-by: Andrew Cooper <andrew.cooper3@citrix.com> diff -r f51f30290b2f -r 1b20c16b76bb docs/misc/xen-command-line.markdown --- a/docs/misc/xen-command-line.markdown Mon Mar 26 17:09:59 2012 +0100 +++ b/docs/misc/xen-command-line.markdown Mon Mar 26 17:11:13 2012 +0100 @@ -5,7 +5,7 @@ arch trees, and some options are currently separate from their legacy versions. Please remove this notice when complete.** -This document coveres the command line options which the Xen +This document covers the command line options which the Xen Hypervisor. ## Types of parameter @@ -38,7 +38,7 @@ Enable synchronous console mode ### Integer (`<integer>`) An integer parameter will default to decimal and may be prefixed with -a `-` for negative numbers. Alternativly, a hexidecimal number may be +a `-` for negative numbers. Alternatively, a hexadecimal number may be used by prefixing the number with `0x`, or an octal number may be used if a leading `0` is present. @@ -56,7 +56,7 @@ Without a size suffix, the default will ### String Many parameters are more complicated and require more intricate -configuration. The detailed description of each individual paramter +configuration. The detailed description of each individual parameter specify which values are valid. ### List @@ -96,7 +96,7 @@ from the MP tables. Finally, any of the boolean false options can be used to disable ACPI usage entirely. -Because responsiblity for ACPI processing is shared between Xen and +Because responsibility for ACPI processing is shared between Xen and the domain 0 kernel this option is automatically propagated to the domain 0 command line @@ -112,7 +112,7 @@ than one is present. Instruct Xen to ignore timer-interrupt override. -Because responsiblity for ACPI processing is shared between Xen and +Because responsibility for ACPI processing is shared between Xen and the domain 0 kernel this option is automatically propagated to the domain 0 command line @@ -178,7 +178,7 @@ Both option `com1` and `com2` follow the * `pci` indicates that Xen should scan the PCI bus for the UART, avoiding Intel AMT devices. * `amt` indicated that Xen should scan the PCI bus for the UART, - including Intel AMT devices if presetn. + including Intel AMT devices if present. A typical setup for most situations might be `com1=115200,8n1` @@ -200,10 +200,10 @@ Specify which console(s) Xen should use. `vga` indicates that Xen should try and use the vga graphics adapter. `com1` and `com2` indicates that Xen should use serial ports 1 and 2 -respectivly. Optionally, these arguments may be followed by an `H` or +respectively. Optionally, these arguments may be followed by an `H` or `L`. `H` indicates that transmitted characters will have their MSB -set, while recieved characters must have their MSB set. `L` indicates -the converse; transmitted and recieved characters will have their MSB +set, while received characters must have their MSB set. `L` indicates +the converse; transmitted and received characters will have their MSB cleared. This allows a single port to be shared by two subsystems (e.g. console and debugger). @@ -255,7 +255,7 @@ console during dom0 boot. > Default: `4G` -Specify the maximum address to allocate certain strucutres, if used in +Specify the maximum address to allocate certain structures, if used in combination with the `low_crashinfo` command line option. ### crashkernel @@ -274,7 +274,7 @@ Specify the bit width of the DMA heap. ### dom0\_max\_vcpus > `= <integer>` -Specifiy the maximum number of vcpus to give to dom0. This defaults +Specify the maximum number of vcpus to give to dom0. This defaults to the number of pcpus on the host. ### dom0\_mem (ia64) @@ -345,7 +345,9 @@ Increase the number of PIRQs available f Set the logging level for Xen guests. Any log message with equal more more importance will be printed. -The optional `<rate-limited level>` options instructs which severities should be rate limited. +The optional `<rate-limited level>` option instructs which severities +should be rate limited. + ### hap\_1gb ### hap\_2mb ### hpetbroadcast @@ -373,7 +375,7 @@ all. Set the logging level for Xen. Any log message with equal more more importance will be printed. -The optional `<rate-limited level>` options instructs which severities +The optional `<rate-limited level>` option instructs which severities should be rate limited. ### low\_crashinfo @@ -383,7 +385,7 @@ should be rate limited. This option is only useful for hosts with a 32bit dom0 kernel, wishing to use kexec functionality in the case of a crash. It represents -which data structures should be deliberatly allocated in low memory, +which data structures should be deliberately allocated in low memory, so the crash kernel may find find them. Should be used in combination with `crashinfo_maxaddr`. @@ -416,7 +418,7 @@ Instruct Xen to ignore any IOAPICs that instead continue to use the legacy PIC. This is _not_ recommended with pvops type kernels. -Because responsiblity for APIC setup is shared between Xen and the +Because responsibility for APIC setup is shared between Xen and the domain 0 kernel this option is automatically propagated to the domain 0 command line. @@ -474,7 +476,7 @@ Choose the default scheduler. ### serial\_tx\_buffer > `= <size>` -Set the serial tramsit buffer size. Defaults to 16kB. +Set the serial transmit buffer size. Defaults to 16kB. ### smep ### snb\_igd\_quirk @@ -526,7 +528,7 @@ with the specified width, height and dep `mode-<mode>` instructs Xen to use a specific mode, as shown with the `ask` option. (N.B menu modes are displayed in hex, so `<mode>` -should be a hexidecimal number) +should be a hexadecimal number) The optional `keep` parameter causes Xen to continue using the vga console even after dom0 has been started. The default behaviour is to
Andrew Cooper
2012-Mar-26 16:16 UTC
Re: [PATCH 0 of 3 DOCDAY] updates to Xen command line argument documentation
Acked-by: Andrew Cooper <andrew.cooper3@citrix.com> On 26/03/12 17:12, Ian Campbell wrote:> The following patches update misc/xen-command-line.markdown. Resend > with Andrew Coopers comments addressed.-- Andrew Cooper - Dom0 Kernel Engineer, Citrix XenServer T: +44 (0)1223 225 900, http://www.citrix.com
Ian Jackson
2012-Apr-02 16:02 UTC
Re: [PATCH 0 of 3 DOCDAY] updates to Xen command line argument documentation
Ian Campbell writes ("[Xen-devel] [PATCH 0 of 3 DOCDAY] updates to Xen
command line argument documentation"):> The following patches update misc/xen-command-line.markdown. Resend
> with Andrew Coopers comments addressed.
Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>