Skip to contentSkip to conversation

Documentation and source code comments updates (v1)

PATCH In review Konrad Rzeszutek Wilk 3 participants 9 messages Feb 25, 2013 – Feb 26, 2013

Subsystems (3)
lore
Share & tools
lore
#0 lore raw

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.

#1 lore raw

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
index 7660877..73d51ed 100644
@@ -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
#2 lore raw

[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
index 6c72381..c4cc199 100644
@@ -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
 
#3 lore raw

PATCH 2/3 kernel-parameters: Document 'console=hvc<n>'

In reply to Konrad Rzeszutek Wilk

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
index 73d51ed..7b41fba 100644
@@ -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
#4 lore raw

[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
index c4cc199..986614d 100644
@@ -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
#5 lore raw

PATCH 3/3 docs: Fix incorrect comment about 64-bit code segment descriptors.

In reply to Konrad Rzeszutek Wilk

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
index b7de3b2..6859e96 100644
@@ -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
#6 lore raw

[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
index 980053c..37f5304 100644
@@ -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.
#7 lore raw
In reply to Konrad Rzeszutek Wilk
Quoted 6 lines · Konrad Rzeszutek Wilk

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.

Did I miss an attachment?

Rob

#8 lore raw
Quoted 9 lines · Rob Landley
Quoted 6 lines · Konrad Rzeszutek Wilk

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.

Did I miss an attachment?

No? They were part of the email thread.

Quoted 2 lines

Rob