proc.5: Clarify that boot arguments can be embedded in image

Message ID 433d742b-743b-4335-878f-1ca0f45698f7@paulmck-laptop
State New
Headers
Series proc.5: Clarify that boot arguments can be embedded in image |

Commit Message

Paul E. McKenney June 30, 2023, 11:33 p.m. UTC
  With the advent of the CONFIG_BOOT_CONFIG Kconfig option, kernel boot
arguments can now be embedded in the kernel image, either attached
to the end of initramfs or embedded in the kernel itself.  Document
this possibility in the /proc/cmdline entry of proc.5.

Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
Cc: Michael Kerrisk <mtk.manpages@gmail.com>
Cc: Masami Hiramatsu <mhiramat@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: Nick Desaulniers <ndesaulniers@google.com>
Cc: Vlastimil Babka <vbabka@suse.cz>
Cc: Johannes Weiner <hannes@cmpxchg.org>
  

Comments

Masami Hiramatsu (Google) July 4, 2023, 12:59 p.m. UTC | #1
On Fri, 30 Jun 2023 16:33:28 -0700
"Paul E. McKenney" <paulmck@kernel.org> wrote:

> With the advent of the CONFIG_BOOT_CONFIG Kconfig option, kernel boot
> arguments can now be embedded in the kernel image, either attached
> to the end of initramfs or embedded in the kernel itself.  Document
> this possibility in the /proc/cmdline entry of proc.5.

Thanks for update!

Reviewed-by: Masami Hiramatsu (Google) <mhiramat@kernel.org>

> 
> Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> Cc: Masami Hiramatsu <mhiramat@kernel.org>
> Cc: Jonathan Corbet <corbet@lwn.net>
> Cc: Andrew Morton <akpm@linux-foundation.org>
> Cc: Nick Desaulniers <ndesaulniers@google.com>
> Cc: Vlastimil Babka <vbabka@suse.cz>
> Cc: Johannes Weiner <hannes@cmpxchg.org>
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index c6684620e..141a2983c 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -3100,6 +3100,9 @@ Often done via a boot manager such as
>  .BR lilo (8)
>  or
>  .BR grub (8).
> +Any arguments embedded in the kernel image or initramfs via 
> +.B CONFIG_BOOT_CONFIG
> +will also be displayed.
>  .TP
>  .IR /proc/config.gz " (since Linux 2.6)"
>  This file exposes the configuration options that were used
  
Paul E. McKenney July 5, 2023, 8:33 p.m. UTC | #2
On Tue, Jul 04, 2023 at 09:59:32PM +0900, Masami Hiramatsu wrote:
> On Fri, 30 Jun 2023 16:33:28 -0700
> "Paul E. McKenney" <paulmck@kernel.org> wrote:
> 
> > With the advent of the CONFIG_BOOT_CONFIG Kconfig option, kernel boot
> > arguments can now be embedded in the kernel image, either attached
> > to the end of initramfs or embedded in the kernel itself.  Document
> > this possibility in the /proc/cmdline entry of proc.5.
> 
> Thanks for update!
> 
> Reviewed-by: Masami Hiramatsu (Google) <mhiramat@kernel.org>

Thank you, Masami!

Adding Alejandro and linux-man on CC.

							Thanx, Paul

> > Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
> > Cc: Michael Kerrisk <mtk.manpages@gmail.com>
> > Cc: Masami Hiramatsu <mhiramat@kernel.org>
> > Cc: Jonathan Corbet <corbet@lwn.net>
> > Cc: Andrew Morton <akpm@linux-foundation.org>
> > Cc: Nick Desaulniers <ndesaulniers@google.com>
> > Cc: Vlastimil Babka <vbabka@suse.cz>
> > Cc: Johannes Weiner <hannes@cmpxchg.org>
> > 
> > diff --git a/man5/proc.5 b/man5/proc.5
> > index c6684620e..141a2983c 100644
> > --- a/man5/proc.5
> > +++ b/man5/proc.5
> > @@ -3100,6 +3100,9 @@ Often done via a boot manager such as
> >  .BR lilo (8)
> >  or
> >  .BR grub (8).
> > +Any arguments embedded in the kernel image or initramfs via 
> > +.B CONFIG_BOOT_CONFIG
> > +will also be displayed.
> >  .TP
> >  .IR /proc/config.gz " (since Linux 2.6)"
> >  This file exposes the configuration options that were used
> 
> 
> -- 
> Masami Hiramatsu (Google) <mhiramat@kernel.org>
  
Alejandro Colomar July 8, 2023, 5:19 p.m. UTC | #3
Hi Paul!

On 7/5/23 22:33, Paul E. McKenney wrote:
> On Tue, Jul 04, 2023 at 09:59:32PM +0900, Masami Hiramatsu wrote:
>> On Fri, 30 Jun 2023 16:33:28 -0700
>> "Paul E. McKenney" <paulmck@kernel.org> wrote:
>>
>>> With the advent of the CONFIG_BOOT_CONFIG Kconfig option, kernel boot
>>> arguments can now be embedded in the kernel image, either attached
>>> to the end of initramfs or embedded in the kernel itself.  Document
>>> this possibility in the /proc/cmdline entry of proc.5.
>>
>> Thanks for update!
>>
>> Reviewed-by: Masami Hiramatsu (Google) <mhiramat@kernel.org>
> 

Thanks for the review!  Tag added.

> Thank you, Masami!
> 
> Adding Alejandro and linux-man on CC.
> 
> 							Thanx, Paul
> 
>>> Signed-off-by: Paul E. McKenney <paulmck@kernel.org>
>>> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
>>> Cc: Masami Hiramatsu <mhiramat@kernel.org>
>>> Cc: Jonathan Corbet <corbet@lwn.net>
>>> Cc: Andrew Morton <akpm@linux-foundation.org>
>>> Cc: Nick Desaulniers <ndesaulniers@google.com>
>>> Cc: Vlastimil Babka <vbabka@suse.cz>
>>> Cc: Johannes Weiner <hannes@cmpxchg.org>
>>>

Thanks!  Patch applied.

Cheers,
Alex

>>> diff --git a/man5/proc.5 b/man5/proc.5
>>> index c6684620e..141a2983c 100644
>>> --- a/man5/proc.5
>>> +++ b/man5/proc.5
>>> @@ -3100,6 +3100,9 @@ Often done via a boot manager such as
>>>   .BR lilo (8)
>>>   or
>>>   .BR grub (8).
>>> +Any arguments embedded in the kernel image or initramfs via
>>> +.B CONFIG_BOOT_CONFIG
>>> +will also be displayed.
>>>   .TP
>>>   .IR /proc/config.gz " (since Linux 2.6)"
>>>   This file exposes the configuration options that were used
>>
>>
>> -- 
>> Masami Hiramatsu (Google) <mhiramat@kernel.org>

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5
  

Patch

diff --git a/man5/proc.5 b/man5/proc.5
index c6684620e..141a2983c 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -3100,6 +3100,9 @@  Often done via a boot manager such as
 .BR lilo (8)
 or
 .BR grub (8).
+Any arguments embedded in the kernel image or initramfs via 
+.B CONFIG_BOOT_CONFIG
+will also be displayed.
 .TP
 .IR /proc/config.gz " (since Linux 2.6)"
 This file exposes the configuration options that were used