Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / it / groupadd.8
1 '\" t
2 .\"     Title: groupadd
3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5 .\"      Date: 16/02/2011
6 .\"    Manual: System Management Commands
7 .\"    Source: System Management Commands
8 .\"  Language: Italian
9 .\"
10 .TH "GROUPADD" "8" "16/02/2011" "System Management Commands" "System Management Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NOME"
31 groupadd \- Crea un nuovo gruppo
32 .SH "SINOSSI"
33 .HP \w'\fBgroupadd\fR\ 'u
34 \fBgroupadd\fR [\fIopzioni\fR] \fIgroup\fR
35 .SH "DESCRIZIONE"
36 .PP
37 The
38 \fBgroupadd\fR
39 command creates a new group account using the values specified on the command line plus the default values from the system\&. The new group will be entered into the system files as needed\&.
40 .SH "OPZIONI"
41 .PP
42 Il comando
43 \fBgroupadd\fR
44 accetta le seguenti opzioni:
45 .PP
46 \fB\-f\fR, \fB\-\-force\fR
47 .RS 4
48 This option causes the command to simply exit with success status if the specified group already exists\&. When used with
49 \fB\-g\fR, and the specified GID already exists, another (unique) GID is chosen (i\&.e\&.
50 \fB\-g\fR
51 is turned off)\&.
52 .RE
53 .PP
54 \fB\-g\fR, \fB\-\-gid\fR \fIGID\fR
55 .RS 4
56 Il valore numerico dell\*(Aqidentificatore (ID) del gruppo\&. Questo valore deve essere univoco, a meno che non venga usata l\*(Aqopzione
57 \fB\-o\fR\&. Il valore deve essere non\-negativo\&. La scelta predefinita \(`e quella di usare il minimo valore di ID superiore a 999 e superiore a qualunque altro gruppo\&. Valori tra 0 e 999 sono tipicamente riservati per account di sistema\&.
58 .RE
59 .PP
60 \fB\-h\fR, \fB\-\-help\fR
61 .RS 4
62 Mostra un messaggio di aiuto ed esce\&.
63 .RE
64 .PP
65 \fB\-K\fR, \fB\-\-key\fR \fIKEY\fR=\fIVALUE\fR
66 .RS 4
67 Overrides
68 /etc/login\&.defs
69 defaults (GID_MIN, GID_MAX and others)\&. Multiple
70 \fB\-K\fR
71 options can be specified\&.
72 .sp
73 Example:
74 \fB\-K \fR\fIGID_MIN\fR=\fI100\fR
75 \fB\-K \fR\fIGID_MAX\fR=\fI499\fR
76 .sp
77 Note:
78 \fB\-K \fR
79 \fIGID_MIN\fR=\fI10\fR,\fIGID_MAX\fR=\fI499\fR
80 doesn\*(Aqt work yet\&.
81 .RE
82 .PP
83 \fB\-o\fR, \fB\-\-non\-unique\fR
84 .RS 4
85 This option permits to add a group with a non\-unique GID\&.
86 .RE
87 .PP
88 \fB\-p\fR, \fB\-\-password\fR \fIPASSWORD\fR
89 .RS 4
90 The encrypted password, as returned by
91 \fBcrypt\fR(3)\&. The default is to disable the password\&.
92 .sp
93
94 \fBNote:\fR
95 This option is not recommended because the password (or encrypted password) will be visible by users listing the processes\&.
96 .sp
97 You should make sure the password respects the system\*(Aqs password policy\&.
98 .RE
99 .PP
100 \fB\-r\fR, \fB\-\-system\fR
101 .RS 4
102 Create a system group\&.
103 .sp
104 The numeric identifiers of new system groups are choosen in the
105 \fBSYS_GID_MIN\fR\-\fBSYS_GID_MAX\fR
106 range, defined in
107 login\&.defs, instead of
108 \fBGID_MIN\fR\-\fBGID_MAX\fR\&.
109 .RE
110 .SH "CONFIGURATION"
111 .PP
112 The following configuration variables in
113 /etc/login\&.defs
114 change the behavior of this tool:
115 .PP
116 \fBGID_MAX\fR (number), \fBGID_MIN\fR (number)
117 .RS 4
118 Range of group IDs used for the creation of regular groups by
119 \fBuseradd\fR,
120 \fBgroupadd\fR, or
121 \fBnewusers\fR\&.
122 .RE
123 .PP
124 \fBMAX_MEMBERS_PER_GROUP\fR (number)
125 .RS 4
126 Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
127 /etc/group
128 (with the same name, same password, and same GID)\&.
129 .sp
130 The default value is 0, meaning that there are no limits in the number of members in a group\&.
131 .sp
132 This feature (split group) permits to limit the length of lines in the group file\&. This is useful to make sure that lines for NIS groups are not larger than 1024 characters\&.
133 .sp
134 If you need to enforce such limit, you can use 25\&.
135 .sp
136 Note: split groups may not be supported by all tools (even in the Shadow toolsuite)\&. You should not use this variable unless you really need it\&.
137 .RE
138 .PP
139 \fBSYS_GID_MAX\fR (number), \fBSYS_GID_MIN\fR (number)
140 .RS 4
141 Range of group IDs used for the creation of system groups by
142 \fBuseradd\fR,
143 \fBgroupadd\fR, or
144 \fBnewusers\fR\&.
145 .RE
146 .SH "FILE"
147 .PP
148 /etc/group
149 .RS 4
150 Informazioni sugli account di gruppo\&.
151 .RE
152 .PP
153 /etc/gshadow
154 .RS 4
155 Informazioni sicure sugli account di gruppo\&.
156 .RE
157 .PP
158 /etc/login\&.defs
159 .RS 4
160 Shadow password suite configuration\&.
161 .RE
162 .SH "AVVISI/CAVEAT"
163 .PP
164 Groupnames must start with a lower case letter or an underscore, followed by lower case letters, digits, underscores, or dashes\&. They can end with a dollar sign\&. In regular expression terms: [a\-z_][a\-z0\-9_\-]*[$]?
165 .PP
166 Groupnames may only be up to characters long\&.
167 .PP
168 You may not add a NIS or LDAP group\&. This must be performed on the corresponding server\&.
169 .PP
170 If the groupname already exists in an external group database such as NIS or LDAP,
171 \fBgroupadd\fR
172 will deny the group creation request\&.
173 .SH "VALORI RESTITUITI"
174 .PP
175 The
176 \fBgroupadd\fR
177 command exits with the following values:
178 .PP
179 \fI0\fR
180 .RS 4
181 successo
182 .RE
183 .PP
184 \fI2\fR
185 .RS 4
186 sintassi del comando errata
187 .RE
188 .PP
189 \fI3\fR
190 .RS 4
191 invalid argument to option
192 .RE
193 .PP
194 \fI4\fR
195 .RS 4
196 GID not unique (when
197 \fB\-o\fR
198 not used)
199 .RE
200 .PP
201 \fI9\fR
202 .RS 4
203 group name not unique
204 .RE
205 .PP
206 \fI10\fR
207 .RS 4
208 non \(`e possibile aggiornare il file group
209 .RE
210 .SH "VEDERE ANCHE"
211 .PP
212 \fBchfn\fR(1),
213 \fBchsh\fR(1),
214 \fBpasswd\fR(1),
215 \fBgpasswd\fR(8),
216 \fBgroupdel\fR(8),
217 \fBgroupmod\fR(8),
218 \fBlogin.defs\fR(5),
219 \fBuseradd\fR(8),
220 \fBuserdel\fR(8),
221 \fBusermod\fR(8)\&.