Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / it / groupmod.8
1 '\" t
2 .\"     Title: groupmod
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 "GROUPMOD" "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 groupmod \- modify a group definition on the system
32 .SH "SINOSSI"
33 .HP \w'\fBgroupmod\fR\ 'u
34 \fBgroupmod\fR [\fIopzioni\fR] \fIGROUP\fR
35 .SH "DESCRIZIONE"
36 .PP
37 The
38 \fBgroupmod\fR
39 command modifies the definition of the specified
40 \fIGROUP\fR
41 by modifying the appropriate entry in the group database\&.
42 .SH "OPZIONI"
43 .PP
44 Il comando
45 \fBgroupmod\fR
46 accetta le seguenti opzioni:
47 .PP
48 \fB\-g\fR, \fB\-\-gid\fR \fIGID\fR
49 .RS 4
50 The group ID of the given
51 \fIGROUP\fR
52 will be changed to
53 \fIGID\fR\&.
54 .sp
55 The value of
56 \fIGID\fR
57 must be a non\-negative decimal integer\&. This value must be unique, unless the
58 \fB\-o\fR
59 option is used\&. Values between 0 and 999 are typically reserved for system groups\&.
60 .sp
61 Any files that have the old group ID and must continue to belong to
62 \fIGROUP\fR, must have their group ID changed manually\&.
63 .RE
64 .PP
65 \fB\-h\fR, \fB\-\-help\fR
66 .RS 4
67 Mostra un messaggio di aiuto ed esce\&.
68 .RE
69 .PP
70 \fB\-n\fR, \fB\-\-new\-name\fR \fINEW_GROUP\fR
71 .RS 4
72 Il nome del gruppo verr\(`a modificato da
73 \fIgruppo\fR
74 a
75 \fInome_gruppo\fR\&.
76 .RE
77 .PP
78 \fB\-o\fR, \fB\-\-non\-unique\fR
79 .RS 4
80 When used with the
81 \fB\-g\fR
82 option, allow to change the group
83 \fIGID\fR
84 to a non\-unique value\&.
85 .RE
86 .PP
87 \fB\-p\fR, \fB\-\-password\fR \fIPASSWORD\fR
88 .RS 4
89 The encrypted password, as returned by
90 \fBcrypt\fR(3)\&.
91 .sp
92
93 \fBNote:\fR
94 This option is not recommended because the password (or encrypted password) will be visible by users listing the processes\&.
95 .sp
96 You should make sure the password respects the system\*(Aqs password policy\&.
97 .RE
98 .SH "CONFIGURATION"
99 .PP
100 The following configuration variables in
101 /etc/login\&.defs
102 change the behavior of this tool:
103 .PP
104 \fBMAX_MEMBERS_PER_GROUP\fR (number)
105 .RS 4
106 Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
107 /etc/group
108 (with the same name, same password, and same GID)\&.
109 .sp
110 The default value is 0, meaning that there are no limits in the number of members in a group\&.
111 .sp
112 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\&.
113 .sp
114 If you need to enforce such limit, you can use 25\&.
115 .sp
116 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\&.
117 .RE
118 .SH "FILE"
119 .PP
120 /etc/group
121 .RS 4
122 Informazioni sugli account di gruppo\&.
123 .RE
124 .PP
125 /etc/gshadow
126 .RS 4
127 Informazioni sicure sugli account di gruppo\&.
128 .RE
129 .SH "VALORI RESTITUITI"
130 .PP
131 The
132 \fBgroupmod\fR
133 command exits with the following values:
134 .PP
135 \fI0\fR
136 .RS 4
137 successo
138 .RE
139 .PP
140 \fI2\fR
141 .RS 4
142 sintassi del comando errata
143 .RE
144 .PP
145 \fI3\fR
146 .RS 4
147 invalid argument to option
148 .RE
149 .PP
150 \fI4\fR
151 .RS 4
152 il gruppo specificato non esiste
153 .RE
154 .PP
155 \fI6\fR
156 .RS 4
157 il gruppo specificato non esiste
158 .RE
159 .PP
160 \fI9\fR
161 .RS 4
162 group name already in use
163 .RE
164 .PP
165 \fI10\fR
166 .RS 4
167 non \(`e possibile aggiornare il file group
168 .RE
169 .SH "VEDERE ANCHE"
170 .PP
171 \fBchfn\fR(1),
172 \fBchsh\fR(1),
173 \fBpasswd\fR(1),
174 \fBgpasswd\fR(8),
175 \fBgroupadd\fR(8),
176 \fBgroupdel\fR(8),
177 \fBuseradd\fR(8),
178 \fBuserdel\fR(8),
179 \fBusermod\fR(8)\&.