Re: [PATCH 2.6.25-rc2 3/9] config: Improve init/Kconfig help descriptions - namespaces

Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]
From: Nick Andrew
Date: Wednesday, February 20, 2008 - 4:10 pm

On Wed, Feb 20, 2008 at 10:50:34AM -0600, serge@hallyn.com wrote:

I'm sure you're right, but my goal is to improve all the Kconfig help
messages (clarity, accuracy, consistency) and so at this time I want
to limit myself to changes to the help descriptions.

If somebody will add documentation for this or any other subsystem
I will gladly refer to it but in the meantime I'm sure we can come up
with a wording which everybody can agree with.

The point of view I'm coming from is that of a non-kernel-developer
who has to make a choice about some feature of the kernel which they
don't understand. When I'm configuring a kernel I appreciate a bit more
detail in the help text.  I want to provide enough information to help
the user make a rational choice, or give them some idea about what they
are agreeing to put into their kernel. If they still don't understand,
there will be a suggested safe answer.

I'll see if I can make it briefer, if there's any fat which can be
trimmed away.

Current wording:

@@ -446,12 +486,20 @@ config PID_NS
        default n
        depends on NAMESPACES && EXPERIMENTAL
        help
-         Suport process id namespaces.  This allows having multiple
-         process with the same pid as long as they are in different
-         pid namespaces.  This is a building block of containers.
+         Enable experimental support for hierarchical process id namespaces.

-         Unless you want to work with an experimental feature
-         say N here.
+         Process IDs will be unique only within each PID namespace.
+         This allows multiple processes to have the same PID
+         so long as they are in different PID namespaces. Furthermore,
+         each process will have a distinct PID in each namespace
+         the process is in.
+
+         This is used by container systems (i.e. vservers).
+         Tasks in the container are placed in the PID namespace
+         corresponding to the container, and cannot see or
+         affect processes in any parent PID namespaces.
+
+         If unsure, say N.

 config BLK_DEV_INITRD
        bool "Initial RAM filesystem and RAM disk (initramfs/initrd) support"


Nick.
--
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]

Messages in current thread:
Improve init/Kconfig help descriptions [PATCH 0/9], Nick Andrew, (Tue Feb 19, 7:06 am)
Improve init/Kconfig help descriptions [PATCH 1/9], Nick Andrew, (Tue Feb 19, 7:09 am)
Re: Improve init/Kconfig help descriptions [PATCH 2/9], Nick Andrew, (Tue Feb 19, 7:11 am)
Improve init/Kconfig help descriptions [PATCH 3/9], Nick Andrew, (Tue Feb 19, 7:33 am)
Improve init/Kconfig help descriptions [PATCH 4/9], Nick Andrew, (Tue Feb 19, 7:38 am)
Re: Improve init/Kconfig help descriptions [PATCH 3/9], Pavel Emelyanov, (Tue Feb 19, 7:42 am)
Improve init/Kconfig help descriptions [PATCH 5/9], Nick Andrew, (Tue Feb 19, 7:53 am)
Re: Improve init/Kconfig help descriptions [PATCH 3/9], Nick Andrew, (Tue Feb 19, 8:10 am)
Improve init/Kconfig help descriptions [PATCH 6/9], Nick Andrew, (Tue Feb 19, 8:12 am)
Improve init/Kconfig help descriptions [PATCH 7/9], Nick Andrew, (Tue Feb 19, 8:15 am)
Re: Improve init/Kconfig help descriptions [PATCH 3/9], Pavel Emelyanov, (Tue Feb 19, 8:16 am)
Improve init/Kconfig help descriptions [PATCH 8/9], Nick Andrew, (Tue Feb 19, 8:21 am)
Improve init/Kconfig help descriptions [PATCH 9/9], Nick Andrew, (Tue Feb 19, 8:27 am)
Re: Improve init/Kconfig help descriptions [PATCH 6/9], Paul Jackson, (Tue Feb 19, 8:39 am)
Re: Improve init/Kconfig help descriptions [PATCH 3/9], Serge E. Hallyn, (Tue Feb 19, 8:50 am)
Re: Improve init/Kconfig help descriptions [PATCH 3/9], Randy Dunlap, (Tue Feb 19, 9:44 am)
Re: Improve init/Kconfig help descriptions [PATCH 5/9], Randy Dunlap, (Tue Feb 19, 1:17 pm)
Re: Improve init/Kconfig help descriptions [PATCH 3/9], Nick Andrew, (Tue Feb 19, 3:41 pm)
Re: Improve init/Kconfig help descriptions [PATCH 6/9], Paul Menage, (Tue Feb 19, 7:04 pm)
Re: Improve init/Kconfig help descriptions [PATCH 6/9], Nick Andrew, (Tue Feb 19, 7:54 pm)
Re: Improve init/Kconfig help descriptions [PATCH 6/9], Paul Menage, (Tue Feb 19, 8:12 pm)
Re: Improve init/Kconfig help descriptions [PATCH 4/9], Valdis.Kletnieks, (Tue Feb 19, 8:42 pm)
Re: Improve init/Kconfig help descriptions [PATCH 6/9], Nick Andrew, (Wed Feb 20, 5:41 am)
Re: Improve init/Kconfig help descriptions [PATCH 6/9], Paul Jackson, (Wed Feb 20, 9:43 am)
Re: Improve init/Kconfig help descriptions [PATCH 6/9], Nick Andrew, (Wed Feb 20, 2:31 pm)
Re: Improve init/Kconfig help descriptions [PATCH 4/9], Nick Andrew, (Wed Feb 20, 3:17 pm)
Re: [PATCH 2.6.25-rc2 3/9] config: Improve init/Kconfig he ..., Nick Andrew, (Wed Feb 20, 4:10 pm)