← Back to branch summary

~serge-hallyn/ubuntu/raring/shadow/shadow-userns

« back to all changes in this revision

Viewing changes to debian/patches/userns/02_userns_doc_login.defs

  • Committer: Serge Hallyn
  • Date: 2013-02-01 21:31:48 UTC
  • Revision ID: serge.hallyn@canonical.com-20130201213148-6ms9125tjn2lngnq
Add patchset by Eric Biederman to support subids for use by unprivileged
users to administer private user namespaces.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/patches/userns/02_userns_doc_login.defs
 
1
From ebiederm@xmission.com  Tue Jan 22 09:14:55 2013
 
2
Return-Path: <ebiederm@xmission.com>
 
3
X-Original-To: serge@hallyn.com
 
4
Delivered-To: serge@hallyn.com
 
5
Received: by mail.hallyn.com (Postfix, from userid 5001)
 
6
        id 140DBC80F4; Tue, 22 Jan 2013 09:14:55 +0000 (UTC)
 
7
X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail
 
8
X-Spam-Level: 
 
9
X-Spam-Status: No, score=0.1 required=8.0 tests=BAD_ENC_HEADER,BAYES_00
 
10
        autolearn=no version=3.3.1
 
11
Received: from out02.mta.xmission.com (out02.mta.xmission.com [166.70.13.232])
 
12
        (using TLSv1 with cipher AES256-SHA (256/256 bits))
 
13
        (No client certificate requested)
 
14
        by mail.hallyn.com (Postfix) with ESMTPS id 5D815C80D1
 
15
        for <serge@hallyn.com>; Tue, 22 Jan 2013 09:14:50 +0000 (UTC)
 
16
Received: from out03.mta.xmission.com ([166.70.13.233])
 
17
        by out02.mta.xmission.com with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
 
18
        (Exim 4.76)
 
19
        (envelope-from <ebiederm@xmission.com>)
 
20
        id 1TxZum-0006il-0f; Tue, 22 Jan 2013 02:13:08 -0700
 
21
Received: from in02.mta.xmission.com ([166.70.13.52])
 
22
        by out03.mta.xmission.com with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
 
23
        (Exim 4.76)
 
24
        (envelope-from <ebiederm@xmission.com>)
 
25
        id 1TxZul-0004GF-Id; Tue, 22 Jan 2013 02:13:07 -0700
 
26
Received: from c-98-207-153-68.hsd1.ca.comcast.net ([98.207.153.68] helo=eric-ThinkPad-X220.xmission.com)
 
27
        by in02.mta.xmission.com with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16)
 
28
        (Exim 4.76)
 
29
        (envelope-from <ebiederm@xmission.com>)
 
30
        id 1TxZuf-0004T0-MS; Tue, 22 Jan 2013 02:13:07 -0700
 
31
From: ebiederm@xmission.com (Eric W. Biederman)
 
32
To: Nicolas =?utf-8?Q?Fran=C3=A7ois?= <nicolas.francois@centraliens.net>
 
33
Cc: <Pkg-shadow-devel@lists.alioth.debian.org>,  Linux Containers <containers@lists.linux-foundation.org>,  "Michael Kerrisk \(man-pages\)" <mtk.manpages@gmail.com>,  "Serge E. Hallyn" <serge@hallyn.com>
 
34
References: <87d2wxshu0.fsf@xmission.com>
 
35
Date: Tue, 22 Jan 2013 01:12:58 -0800
 
36
In-Reply-To: <87d2wxshu0.fsf@xmission.com> (Eric W. Biederman's message of
 
37
        "Tue, 22 Jan 2013 01:11:19 -0800")
 
38
Message-ID: <871uddshr9.fsf@xmission.com>
 
39
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1 (gnu/linux)
 
40
MIME-Version: 1.0
 
41
Content-Type: text/plain
 
42
X-XM-AID: U2FsdGVkX19iYyOCEx6dl2v1Ya/KIGpixG5+3MVA1bY=
 
43
X-SA-Exim-Connect-IP: 98.207.153.68
 
44
X-SA-Exim-Mail-From: ebiederm@xmission.com
 
45
Subject: [PATCH 02/11] login.defs.5: Document the new variables in login.defs
 
46
X-SA-Exim-Version: 4.2.1 (built Wed, 14 Nov 2012 14:26:46 -0700)
 
47
X-SA-Exim-Scanned: Yes (on in02.mta.xmission.com)
 
48
X-UID: 2072                                                  
 
49
Status: RO
 
50
Content-Length: 7615
 
51
Lines: 170
 
52
 
 
53
 
 
54
Signed-off-by: "Eric W. Biederman" <ebiederm@xmission.com>
 
55
---
 
56
 man/Makefile.am                    |    2 +
 
57
 man/login.defs.5.xml               |    8 ++++++
 
58
 man/login.defs.d/SUB_GID_COUNT.xml |   46 ++++++++++++++++++++++++++++++++++++
 
59
 man/login.defs.d/SUB_UID_COUNT.xml |   46 ++++++++++++++++++++++++++++++++++++
 
60
 4 files changed, 102 insertions(+), 0 deletions(-)
 
61
 create mode 100644 man/login.defs.d/SUB_GID_COUNT.xml
 
62
 create mode 100644 man/login.defs.d/SUB_UID_COUNT.xml
 
63
 
 
64
Index: shadow/man/Makefile.am
 
65
===================================================================
 
66
--- shadow.orig/man/Makefile.am 2013-02-01 15:27:51.048080390 -0600
 
67
+++ shadow/man/Makefile.am      2013-02-01 15:27:51.040080390 -0600
 
68
@@ -163,6 +163,8 @@
 
69
        USERDEL_CMD.xml \
 
70
        USERGROUPS_ENAB.xml \
 
71
        USE_TCB.xml \
 
72
+       SUB_GID_COUNT.xml \
 
73
+       SUB_UID_COUNT.xml \
 
74
        SYS_GID_MAX.xml \
 
75
        SYS_UID_MAX.xml
 
76
 
 
77
Index: shadow/man/login.defs.5.xml
 
78
===================================================================
 
79
--- shadow.orig/man/login.defs.5.xml    2013-02-01 15:27:51.048080390 -0600
 
80
+++ shadow/man/login.defs.5.xml 2013-02-01 15:27:51.044080390 -0600
 
81
@@ -78,6 +78,8 @@
 
82
 <!ENTITY SULOG_FILE            SYSTEM "login.defs.d/SULOG_FILE.xml">
 
83
 <!ENTITY SU_NAME               SYSTEM "login.defs.d/SU_NAME.xml">
 
84
 <!ENTITY SU_WHEEL_ONLY         SYSTEM "login.defs.d/SU_WHEEL_ONLY.xml">
 
85
+<!ENTITY SUB_GID_COUNT         SYSTEM "login.defs.d/SUB_GID_COUNT.xml">
 
86
+<!ENTITY SUB_UID_COUNT         SYSTEM "login.defs.d/SUB_UID_COUNT.xml">
 
87
 <!ENTITY SYS_GID_MAX           SYSTEM "login.defs.d/SYS_GID_MAX.xml">
 
88
 <!ENTITY SYSLOG_SG_ENAB        SYSTEM "login.defs.d/SYSLOG_SG_ENAB.xml">
 
89
 <!ENTITY SYSLOG_SU_ENAB        SYSTEM "login.defs.d/SYSLOG_SU_ENAB.xml">
 
90
@@ -216,6 +218,8 @@
 
91
       &SULOG_FILE;
 
92
       &SU_NAME;
 
93
       &SU_WHEEL_ONLY;
 
94
+      &SUB_GID_COUNT; <!-- documents also SUB_GID_MIN SUB_GID_MAX -->
 
95
+      &SUB_UID_COUNT; <!-- documents also SUB_UID_MIN SUB_UID_MAX -->
 
96
       &SYS_GID_MAX; <!-- documents also SYS_GID_MIN -->
 
97
       &SYS_UID_MAX; <!-- documents also SYS_UID_MIN -->
 
98
       &SYSLOG_SG_ENAB;
 
99
@@ -393,6 +397,8 @@
 
100
            PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
 
101
            <phrase condition="sha_crypt">SHA_CRYPT_MAX_ROUNDS
 
102
            SHA_CRYPT_MIN_ROUNDS</phrase>
 
103
+           SUB_GID_COUNT SUB_GID_MAX SUB_GID_MIN
 
104
+           SUB_UID_COUNT SUB_UID_MAX SUB_UID_MIN
 
105
            SYS_GID_MAX SYS_GID_MIN SYS_UID_MAX SYS_UID_MIN UID_MAX UID_MIN
 
106
            UMASK
 
107
          </para>
 
108
@@ -470,6 +476,8 @@
 
109
            GID_MAX GID_MIN
 
110
            MAIL_DIR MAX_MEMBERS_PER_GROUP
 
111
            PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
 
112
+           SUB_GID_COUNT SUB_GID_MAX SUB_GID_MIN
 
113
+           SUB_UID_COUNT SUB_UID_MAX SUB_UID_MIN
 
114
            SYS_GID_MAX SYS_GID_MIN SYS_UID_MAX SYS_UID_MIN UID_MAX UID_MIN
 
115
            UMASK
 
116
            <phrase condition="tcb">TCB_AUTH_GROUP TCB_SYMLINK USE_TCB</phrase>
 
117
Index: shadow/man/login.defs.d/SUB_GID_COUNT.xml
 
118
===================================================================
 
119
--- /dev/null   1970-01-01 00:00:00.000000000 +0000
 
120
+++ shadow/man/login.defs.d/SUB_GID_COUNT.xml   2013-02-01 15:27:51.044080390 -0600
 
121
@@ -0,0 +1,46 @@
 
122
+<!--
 
123
+   Copyright (c) 2013, Eric W. Biederman
 
124
+   All rights reserved.
 
125
+  
 
126
+   Redistribution and use in source and binary forms, with or without
 
127
+   modification, are permitted provided that the following conditions
 
128
+   are met:
 
129
+   1. Redistributions of source code must retain the above copyright
 
130
+      notice, this list of conditions and the following disclaimer.
 
131
+   2. Redistributions in binary form must reproduce the above copyright
 
132
+      notice, this list of conditions and the following disclaimer in the
 
133
+      documentation and/or other materials provided with the distribution.
 
134
+   3. The name of the copyright holders or contributors may not be used to
 
135
+      endorse or promote products derived from this software without
 
136
+      specific prior written permission.
 
137
+  
 
138
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 
139
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 
140
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
 
141
+   PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
 
142
+   HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 
143
+   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 
144
+   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 
145
+   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 
146
+   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 
147
+   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 
148
+   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
149
+-->
 
150
+<varlistentry>
 
151
+  <term><option>SUB_GID_MIN</option> (number)</term>
 
152
+  <term><option>SUB_GID_MAX</option> (number)</term>
 
153
+  <term><option>SUB_GID_COUNT</option> (number)</term>
 
154
+  <listitem>
 
155
+    <para>
 
156
+      The commands <command>useradd</command> and <command>newusers</command>
 
157
+      allocate <option>SUB_GID_COUNT</option> unused group IDs from the range
 
158
+      <option>SUB_GID_MIN</option> to <option>SUB_GID_MAX</option> for each
 
159
+      new user.
 
160
+    </para>
 
161
+    <para>
 
162
+      The default values for <option>SUB_GID_MAN</option>,
 
163
+      <option>SUB_GID_MIN</option>, <option>SUB_GID_COUNT</option>
 
164
+      are respectively 100000, 600100000 and 10000.
 
165
+    </para>
 
166
+  </listitem>
 
167
+</varlistentry>
 
168
Index: shadow/man/login.defs.d/SUB_UID_COUNT.xml
 
169
===================================================================
 
170
--- /dev/null   1970-01-01 00:00:00.000000000 +0000
 
171
+++ shadow/man/login.defs.d/SUB_UID_COUNT.xml   2013-02-01 15:27:51.044080390 -0600
 
172
@@ -0,0 +1,46 @@
 
173
+<!--
 
174
+   Copyright (c) 2013, Eric W. Biederman
 
175
+   All rights reserved.
 
176
+  
 
177
+   Redistribution and use in source and binary forms, with or without
 
178
+   modification, are permitted provided that the following conditions
 
179
+   are met:
 
180
+   1. Redistributions of source code must retain the above copyright
 
181
+      notice, this list of conditions and the following disclaimer.
 
182
+   2. Redistributions in binary form must reproduce the above copyright
 
183
+      notice, this list of conditions and the following disclaimer in the
 
184
+      documentation and/or other materials provided with the distribution.
 
185
+   3. The name of the copyright holders or contributors may not be used to
 
186
+      endorse or promote products derived from this software without
 
187
+      specific prior written permission.
 
188
+  
 
189
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 
190
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 
191
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
 
192
+   PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
 
193
+   HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 
194
+   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 
195
+   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 
196
+   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 
197
+   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 
198
+   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 
199
+   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
200
+-->
 
201
+<varlistentry>
 
202
+  <term><option>SUB_UID_MIN</option> (number)</term>
 
203
+  <term><option>SUB_UID_MAX</option> (number)</term>
 
204
+  <term><option>SUB_UID_COUNT</option> (number)</term>
 
205
+  <listitem>
 
206
+    <para>
 
207
+      The commands <command>useradd</command> and <command>newusers</command>
 
208
+      allocate <option>SUB_UID_COUNT</option> unused user IDs from the range
 
209
+      <option>SUB_UID_MIN</option> to <option>SUB_UID_MAX</option> for each
 
210
+      new user.
 
211
+    </para>
 
212
+    <para>
 
213
+      The default values for <option>SUB_GID_MAN</option>,
 
214
+      <option>SUB_GID_MIN</option>, <option>SUB_GID_COUNT</option>
 
215
+      are respectively 100000, 600100000 and 10000.
 
216
+    </para>
 
217
+  </listitem>
 
218
+</varlistentry>