From mboxrd@z Thu Jan 1 00:00:00 1970 From: ebiederm-aS9lmoZGLiVWk0Htik3J/w@public.gmane.org (Eric W. Biederman) Subject: [PATCH 01/11] Documentation for /etc/subuid and /etc/subgid Date: Tue, 22 Jan 2013 01:12:23 -0800 Message-ID: <877gn5shs8.fsf@xmission.com> References: <87d2wxshu0.fsf@xmission.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: <87d2wxshu0.fsf-aS9lmoZGLiVWk0Htik3J/w@public.gmane.org> (Eric W. Biederman's message of "Tue, 22 Jan 2013 01:11:19 -0800") List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: containers-bounces-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org Errors-To: containers-bounces-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org To: Nicolas =?utf-8?Q?Fran=C3=A7ois?= Cc: Linux Containers , Pkg-shadow-devel-XbBxUvOt3X2LieD7tvxI8l/i77bcL1HB@public.gmane.org, "Michael Kerrisk (man-pages)" List-Id: containers.vger.kernel.org Signed-off-by: "Eric W. Biederman" --- man/Makefile.am | 4 ++ man/subgid.5.xml | 120 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ man/subuid.5.xml | 120 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 244 insertions(+), 0 deletions(-) create mode 100644 man/subgid.5.xml create mode 100644 man/subuid.5.xml diff --git a/man/Makefile.am b/man/Makefile.am index b39043e..be7f5e2 100644 --- a/man/Makefile.am +++ b/man/Makefile.am @@ -43,6 +43,8 @@ man_MANS = \ man5/shadow.5 \ man1/su.1 \ man5/suauth.5 \ + man5/subgid.5 \ + man5/subuid.5 \ man8/useradd.8 \ man8/userdel.8 \ man8/usermod.8 \ @@ -94,6 +96,8 @@ man_XMANS = \ sg.1.xml \ su.1.xml \ suauth.5.xml \ + subgid.5.xml \ + subuid.5.xml \ useradd.8.xml \ userdel.8.xml \ usermod.8.xml \ diff --git a/man/subgid.5.xml b/man/subgid.5.xml new file mode 100644 index 0000000..3855319 --- /dev/null +++ b/man/subgid.5.xml @@ -0,0 +1,120 @@ + + + +]> + + + subgid + 5 + File Formats and Conversions + shadow-utils + &SHADOW_UTILS_VERSION; + + + subgid + the subordinate gid file + + + + DESCRIPTION + + Each line in /etc/subgid contains + a user id and a range of suboridinate user ids that user + is allowed to use. + + This is specified with three fields delimited by colons + (:). + These fields are: + + + + login name + + + numerical subordinate user ID + + + numerical subordinate user ID count + + + + + This file specifies the group IDs to be that each user may use + with the newgidmap command that ordinary users can use to + configure gid mapping in a user namespace. + + + + Multiple ranges may be specified per user ID. + + + + + + FILES + + + /etc/subgid + + Per user subordinate group IDs. + + + + /etc/subgid- + + Backup file for /etc/subgid. + + + + + + + SEE ALSO + + + subuid5 + , + + logindefs5 + , + + newuidmap1 + , + + newgidmap1 + , + + usermod8 + , + + + diff --git a/man/subuid.5.xml b/man/subuid.5.xml new file mode 100644 index 0000000..60f139f --- /dev/null +++ b/man/subuid.5.xml @@ -0,0 +1,120 @@ + + + +]> + + + subuid + 5 + File Formats and Conversions + shadow-utils + &SHADOW_UTILS_VERSION; + + + subuid + the subordinate uid file + + + + DESCRIPTION + + Each line in /etc/subuid contains + a user id and a range of suboridinate user ids that user + is allowed to use. + + This is specified with three fields delimited by colons + (:). + These fields are: + + + + login name + + + numerical subordinate user ID + + + numerical subordinate user ID count + + + + + This file specifies the user IDs to be that each user may use + with the newuidmap command that ordinary users can use to + configure uid mapping in a user namespace. + + + + Multiple ranges may be specified per user ID. + + + + + + FILES + + + /etc/subuid + + Per user subordinate user IDs. + + + + /etc/subuid- + + Backup file for /etc/subuid. + + + + + + + SEE ALSO + + + subgid5 + , + + logindefs5 + , + + newuidmap1 + , + + newgidmap1 + , + + usermod8 + , + + + -- 1.7.5.4