Documentation and source code comments updates (v1)
Subsystems (3)
PATCH 1/1 Documentation and source code comments updates (v1)
Hey,
Three little patches to update the Documentation/kernel-parameters and also some of the complex x86 trampoline code.
Nothing serious, just a little cleanup.
PATCH 1/3 xen/documentation: Mention 'earlyprintk=xen' in the documentation.
The earlyprintk for Xen PV guests utilizes a simple hypercall (console_io) to provide output to Xen emergency console.
Note that the Xen hypervisor should be booted with 'loglevel=all' to output said information.
--- Documentation/kernel-parameters.txt | 3 +++ 1 file changed, 3 insertions(+)
Documentation/kernel-parameters.txt +3 -0
@@ -757,6 +757,7 @@ bytes respectively. Such letter suffixes can also be entirely omitted. earlyprintk= [X86,SH,BLACKFIN] earlyprintk=vga + earlyprintk=xen earlyprintk=serial[,ttySn[,baudrate]] earlyprintk=ttySn[,baudrate] earlyprintk=dbgp[debugController#]
@@ -774,6 +775,8 @@ bytes respectively. Such letter suffixes can also be entirely omitted. The VGA output is eventually overwritten by the real console. + The xen output can only be used by Xen PV guests. + ekgdboc= [X86,KGDB] Allow early kernel console debugging ekgdboc=kbd
Signature · 1 line
1.8.0.2
tip-bot for Konrad Rzeszutek Wilk
merge bot[tip:x86/urgent] doc, xen: Mention 'earlyprintk=xen' in the documentation.
doc, xen: Mention 'earlyprintk=xen' in the documentation.
Commit-ID: 2482a92e7d17187301d7313cfe5021b13393a0b4 Gitweb: http://git.kernel.org/tip/2482a92e7d17187301d7313cfe5021b13393a0b4 Author: Konrad Rzeszutek Wilk <[email protected]> AuthorDate: Mon, 25 Feb 2013 15:54:08 -0500 Committer: H. Peter Anvin <[email protected]> CommitDate: Mon, 25 Feb 2013 13:41:18 -0800
doc, xen: Mention 'earlyprintk=xen' in the documentation.
The earlyprintk for Xen PV guests utilizes a simple hypercall (console_io) to provide output to Xen emergency console.
Note that the Xen hypervisor should be booted with 'loglevel=all' to output said information.
--- Documentation/kernel-parameters.txt | 3 +++ 1 file changed, 3 insertions(+)
Documentation/kernel-parameters.txt +3 -0
@@ -754,6 +754,7 @@ bytes respectively. Such letter suffixes can also be entirely omitted. earlyprintk= [X86,SH,BLACKFIN] earlyprintk=vga + earlyprintk=xen earlyprintk=serial[,ttySn[,baudrate]] earlyprintk=ttySn[,baudrate] earlyprintk=dbgp[debugController#]
@@ -771,6 +772,8 @@ bytes respectively. Such letter suffixes can also be entirely omitted. The VGA output is eventually overwritten by the real console. + The xen output can only be used by Xen PV guests. + ekgdboc= [X86,KGDB] Allow early kernel console debugging ekgdboc=kbd
PATCH 2/3 kernel-parameters: Document 'console=hvc<n>'
In reply to Konrad Rzeszutek WilkBoth the PowerPC hypervisor and Xen hypervisor can utilize the hvc driver.
--- Documentation/kernel-parameters.txt | 2 ++ 1 file changed, 2 insertions(+)
Documentation/kernel-parameters.txt +2 -0
@@ -564,6 +564,8 @@ bytes respectively. Such letter suffixes can also be entirely omitted. UART at the specified I/O port or MMIO address, switching to the matching ttyS device later. The options are the same as for ttyS, above. + hvc<n> Use the hypervisor console device <n>. This is for + both Xen and PowerPC hypervisors. If the device connected to the port is not a TTY but a braille device, prepend "brl," before the device type, for instance
Signature · 1 line
1.8.0.2
tip-bot for Konrad Rzeszutek Wilk
merge bot[tip:x86/urgent] doc, kernel-parameters: Document 'console=hvc<n> '
doc, kernel-parameters: Document 'console=hvc<n>'
Commit-ID: a2fd6419174470f5ae6383f5037d0ee21ed9833f Gitweb: http://git.kernel.org/tip/a2fd6419174470f5ae6383f5037d0ee21ed9833f Author: Konrad Rzeszutek Wilk <[email protected]> AuthorDate: Mon, 25 Feb 2013 15:54:09 -0500 Committer: H. Peter Anvin <[email protected]> CommitDate: Mon, 25 Feb 2013 13:42:15 -0800
doc, kernel-parameters: Document 'console=hvc<n>'
Both the PowerPC hypervisor and Xen hypervisor can utilize the hvc driver.
--- Documentation/kernel-parameters.txt | 2 ++ 1 file changed, 2 insertions(+)
Documentation/kernel-parameters.txt +2 -0
@@ -564,6 +564,8 @@ bytes respectively. Such letter suffixes can also be entirely omitted. UART at the specified I/O port or MMIO address, switching to the matching ttyS device later. The options are the same as for ttyS, above. + hvc<n> Use the hypervisor console device <n>. This is for + both Xen and PowerPC hypervisors. If the device connected to the port is not a TTY but a braille device, prepend "brl," before the device type, for instance
PATCH 3/3 docs: Fix incorrect comment about 64-bit code segment descriptors.
In reply to Konrad Rzeszutek WilkThe AMD64 Architecture Programmer's Manual Volume 2, on page 89 mentions: "If the processor is running in 64-bit mode (L=1), the only valid setting of the D bit is 0." This matches with what the code does.
--- arch/x86/kernel/head_64.S | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
arch/x86/kernel/head_64.S +2 -2
@@ -48,7 +48,7 @@ L3_START_KERNEL = pud_index(__START_KERNEL_map) .globl startup_64 startup_64: /* - * At this point the CPU runs in 64bit mode CS.L = 1 CS.D = 1, + * At this point the CPU runs in 64bit mode CS.L = 1 CS.D = 0, * and someone has loaded an identity mapped page table * for us. These identity mapped page tables map all of the * kernel pages and possibly all of memory.
@@ -159,7 +159,7 @@ startup_64: jmp 1f ENTRY(secondary_startup_64) /* - * At this point the CPU runs in 64bit mode CS.L = 1 CS.D = 1, + * At this point the CPU runs in 64bit mode CS.L = 1 CS.D = 0, * and someone has loaded a mapped page table. * * %rsi holds a physical pointer to real_mode_data.
Signature · 1 line
1.8.0.2
tip-bot for Konrad Rzeszutek Wilk
merge bot[tip:x86/urgent] x86, doc: Fix incorrect comment about 64-bit code segment descriptors
x86, doc: Fix incorrect comment about 64-bit code segment descriptors
Commit-ID: 1256276c98dbcfb009ac8e0687df9a1e291fd149 Gitweb: http://git.kernel.org/tip/1256276c98dbcfb009ac8e0687df9a1e291fd149 Author: Konrad Rzeszutek Wilk <[email protected]> AuthorDate: Mon, 25 Feb 2013 15:54:10 -0500 Committer: H. Peter Anvin <[email protected]> CommitDate: Mon, 25 Feb 2013 13:42:37 -0800
x86, doc: Fix incorrect comment about 64-bit code segment descriptors
The AMD64 Architecture Programmer's Manual Volume 2, on page 89 mentions: "If the processor is running in 64-bit mode (L=1), the only valid setting of the D bit is 0." This matches with what the code does.
--- arch/x86/kernel/head_64.S | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
arch/x86/kernel/head_64.S +2 -2
@@ -49,7 +49,7 @@ L3_START_KERNEL = pud_index(__START_KERNEL_map) startup_64: /* - * At this point the CPU runs in 64bit mode CS.L = 1 CS.D = 1, + * At this point the CPU runs in 64bit mode CS.L = 1 CS.D = 0, * and someone has loaded an identity mapped page table * for us. These identity mapped page tables map all of the * kernel pages and possibly all of memory.
@@ -146,7 +146,7 @@ ident_complete: jmp secondary_startup_64 ENTRY(secondary_startup_64) /* - * At this point the CPU runs in 64bit mode CS.L = 1 CS.D = 1, + * At this point the CPU runs in 64bit mode CS.L = 1 CS.D = 0, * and someone has loaded a mapped page table. * * %esi holds a physical pointer to real_mode_data.
Quoted 6 lines · Konrad Rzeszutek Wilk
Hey,
Three little patches to update the
Documentation/kernel-parametersand also some of the complex x86 trampoline code.Nothing serious, just a little cleanup.
Did I miss an attachment?
Rob
Quoted 9 lines · Rob Landley
Quoted 6 lines · Konrad Rzeszutek Wilk
Hey,
Three little patches to update the
Documentation/kernel-parametersand also some of the complex x86 trampoline code.Nothing serious, just a little cleanup.
Did I miss an attachment?
No? They were part of the email thread.
Quoted 2 lines
Rob