Skip to contentSkip to conversation

Documentation: Explain the [KMG] parameters suffix

PATCH New Ahmed S. Darwish 2 participants 4 messages Feb 6, 2011 – Feb 7, 2011 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Documentation: Explain the [KMG] parameters suffix

(Also applicable over 2.6.38-rc3)

The '[KMG]' suffix is commonly described after a number of kernel parameter values documentation. Explicitly state its semantics.

---

Documentation/kernel-parameters.txt +5 -0
index 89835a4..3deedce 100644
@@ -144,6 +144,11 @@ a fixed number of characters. This limit depends on the architecture
 and is between 256 and 4096 characters. It is defined in the file
 ./include/asm/setup.h as COMMAND_LINE_SIZE.
 
+Finally, the [KMG] suffix is commonly described after a number of kernel
+parameter values. These 'K', 'M', and 'G' letters represent the _binary_
+multipliers 'Kilo', 'Mega', and 'Giga', equalling 2^10, 2^20, and 2^30
+bytes respectively. Such letter suffixes can also be entirely omitted.
+
 
 	acpi=		[HW,ACPI,X86]
 			Advanced Configuration and Power Interface

regards,

Signature · 2 lines
Darwish
http://darwish.07.googlepages.com
#1 lore raw

PATCH 1/1 Documentation: log_buf_len accepts [KMG]

From: Randy Dunlap <[email protected]>

Update the "log_buf_len" description to use [KMG] syntax for the buffer size.

---
 Documentation/kernel-parameters.txt |    7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)
Documentation/kernel-parameters.txt +3 -4
@@ -1262,10 +1262,9 @@ and is between 256 and 4096 characters. 
 			6 (KERN_INFO)		informational
 			7 (KERN_DEBUG)		debug-level messages
 
-	log_buf_len=n	Sets the size of the printk ring buffer, in bytes.
-			Format: { n | nk | nM }
-			n must be a power of two.  The default size
-			is set in the kernel config file.
+	log_buf_len=n[KMG]	Sets the size of the printk ring buffer,
+			in bytes.  n must be a power of two.  The default
+			size is set in the kernel config file.
 
 	logo.nologo	[FB] Disables display of the built-in Linux logo.
 			This may be used to provide more screen space for
#2 lore raw

Re: [PATCH] Documentation: log_buf_len accepts [KMG]

Quoted 7 lines · Randy Dunlap

Update the "log_buf_len" description to use [KMG] syntax for the buffer size.

---

This implies an ACK for the original patch?

Signature · 2 lines
Darwish
http://darwish.07.googlepages.com
#3 lore raw

Re: [PATCH] Documentation: log_buf_len accepts [KMG]

Quoted 10 lines · Ahmed S. Darwish
Quoted 7 lines · Randy Dunlap

Update the "log_buf_len" description to use [KMG] syntax for the buffer size.

---

This implies an ACK for the original patch?

Sorry, I meant to do that separately, but yes, I'll merge it.

Signature · 2 lines
~Randy
*** Remember to use Documentation/SubmitChecklist when testing your code ***