Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / fr / gpasswd.1
1 '\" t
2 .\"     Title: gpasswd
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: Commandes utilisateur
7 .\"    Source: Commandes utilisateur
8 .\"  Language: French
9 .\"
10 .TH "GPASSWD" "1" "16/02/2011" "Commandes utilisateur" "Commandes utilisateur"
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 "NOM"
31 gpasswd \- administer /etc/group and /etc/gshadow
32 .SH "SYNOPSIS"
33 .HP \w'\fBgpasswd\fR\ 'u
34 \fBgpasswd\fR [\fIoption\fR] \fIgroupe\fR
35 .SH "DESCRIPTION"
36 .PP
37 The
38 \fBgpasswd\fR
39 command is used to administer
40 /etc/group, and /etc/gshadow\&. Every group can have
41 administrators,
42 members and a password\&.
43 .PP
44 System administrators can use the
45 \fB\-A\fR
46 option to define group administrator(s) and the
47 \fB\-M\fR
48 option to define members\&. They have all rights of group administrators and members\&.
49 .PP
50
51 \fBgpasswd\fR
52 called by
53 a group administrator
54 with a group name only prompts for the new password of the
55 \fIgroup\fR\&.
56 .PP
57 If a password is set the members can still use
58 \fBnewgrp\fR(1)
59 without a password, and non\-members must supply the password\&.
60 .SS "Notes sur les mots de passe de groupe"
61 .PP
62 Les mots de passe de groupe repr\('esentent naturellement un risque en mati\(`ere de s\('ecurit\('e, puisque plusieurs personnes ont connaissance du mot de passe\&. Cependant, les groupes sont utiles pour permettre la coop\('eration entre diff\('erents utilisateurs\&.
63 .SH "OPTIONS"
64 .PP
65 Except for the
66 \fB\-A\fR
67 and
68 \fB\-M\fR
69 options, the options cannot be combined\&.
70 .PP
71 The options which apply to the
72 \fBgpasswd\fR
73 command are:
74 .PP
75 \fB\-a\fR, \fB\-\-add\fR\fIutilisateur\fR
76 .RS 4
77 Add the
78 \fIuser\fR
79 to the named
80 \fIgroup\fR\&.
81 .RE
82 .PP
83 \fB\-d\fR, \fB\-\-delete\fR\fIutilisateur\fR
84 .RS 4
85 Remove the
86 \fIuser\fR
87 from the named
88 \fIgroup\fR\&.
89 .RE
90 .PP
91 \fB\-r\fR, \fB\-\-remove\-password\fR
92 .RS 4
93 Remove the password from the named
94 \fIgroup\fR\&. Only group members will be allowed to use
95 \fBnewgrp\fR
96 to join the named
97 \fIgroup\fR\&.
98 .RE
99 .PP
100 \fB\-R\fR, \fB\-\-restrict\fR
101 .RS 4
102 Restrict the access to the named
103 \fIgroup\fR\&. Only group members will be allowed to use
104 \fBnewgrp\fR
105 to join the named
106 \fIgroup\fR\&.
107 .RE
108 .PP
109 \fB\-A\fR, \fB\-\-administrators\fR\fIutilisateur\fR,\&.\&.\&.
110 .RS 4
111 Set the list of administrative users\&.
112 .RE
113 .PP
114 \fB\-M\fR, \fB\-\-members\fR\fIutilisateur\fR,\&.\&.\&.
115 .RS 4
116 Set the list of group members\&.
117 .RE
118 .SH "AVERTISSEMENTS"
119 .PP
120 This tool only operates on the
121 /etc/group
122 and /etc/gshadow files\&.
123 Thus you cannot change any NIS or LDAP group\&. This must be performed on the corresponding server\&.
124 .SH "CONFIGURATION"
125 .PP
126 Les variables de configuration suivantes de
127 /etc/login\&.defs
128 modifient le comportement de cet outil\ \&:
129 .PP
130 \fBENCRYPT_METHOD\fR (cha\(^ine ce caract\(`eres)
131 .RS 4
132 D\('efinit les algorithmes de chiffrement par d\('efaut du syst\(`eme pour coder les mots de passes (si aucun algorithme n\*(Aqa \('et\('e indiqu\('e sur la ligne de commandes)\&.
133 .sp
134 Il peut prendre une de ces valeurs\ \&:
135 .sp
136 .RS 4
137 .ie n \{\
138 \h'-04'\(bu\h'+03'\c
139 .\}
140 .el \{\
141 .sp -1
142 .IP \(bu 2.3
143 .\}
144 \fIDES\fR
145 (par d\('efaut)
146 .RE
147 .sp
148 .RS 4
149 .ie n \{\
150 \h'-04'\(bu\h'+03'\c
151 .\}
152 .el \{\
153 .sp -1
154 .IP \(bu 2.3
155 .\}
156 \fIMD5\fR
157 .RE
158 .sp
159 .RS 4
160 .ie n \{\
161 \h'-04'\(bu\h'+03'\c
162 .\}
163 .el \{\
164 .sp -1
165 .IP \(bu 2.3
166 .\}
167 \fISHA256\fR
168 .RE
169 .sp
170 .RS 4
171 .ie n \{\
172 \h'-04'\(bu\h'+03'\c
173 .\}
174 .el \{\
175 .sp -1
176 .IP \(bu 2.3
177 .\}
178 \fISHA512\fR
179 .RE
180 .sp
181 Remarque\ \&: ce param\(`etre remplace la variable
182 \fBMD5_CRYPT_ENAB\fR\&.
183 .RE
184 .PP
185 \fBMAX_MEMBERS_PER_GROUP\fR (nombre)
186 .RS 4
187 Nombre maximum de membres par entr\('ee de groupe\&. Lorsque le maximum est atteint, une nouvelle entr\('ee de groupe (ligne) est d\('emarr\('ee dans
188 /etc/group
189 (avec le m\(^eme nom, m\(^eme mot de passe, et m\(^eme GID)\&.
190 .sp
191 La valeur par d\('efaut est 0, ce qui signifie qu\*(Aqil n\*(Aqy a pas de limites pour le nombre de membres dans un groupe\&.
192 .sp
193 Cette fonctionnalit\('e (groupe d\('ecoup\('e) permet de limiter la longueur des lignes dans le fichier de groupes\&. Ceci est utile pour s\*(Aqassurer que les lignes pour les groupes NIS ne sont pas plus grandes que 1024 caract\(`eres\&.
194 .sp
195 Si vous avez besoin de fixer cette limite, vous pouvez utiliser 25\&.
196 .sp
197 Remarque\ \&: les groupes d\('ecoup\('es ne sont peut\-\(^etre pas pris en charge par tous les outils (m\(^eme dans la suite d\*(Aqoutils Shadow)\&. Vous ne devriez pas utiliser cette variable, sauf si vous en avez vraiment besoin\&.
198 .RE
199 .PP
200 \fBMD5_CRYPT_ENAB\fR (bool\('een)
201 .RS 4
202 Indicate if passwords must be encrypted using the MD5\-based algorithm\&. If set to
203 \fIyes\fR, new passwords will be encrypted using the MD5\-based algorithm compatible with the one used by recent releases of FreeBSD\&. It supports passwords of unlimited length and longer salt strings\&. Set to
204 \fIno\fR
205 if you need to copy encrypted passwords to other systems which don\*(Aqt understand the new algorithm\&. Default is
206 \fIno\fR\&.
207 .sp
208 This variable is superceded by the
209 \fBENCRYPT_METHOD\fR
210 variable or by any command line option used to configure the encryption algorithm\&.
211 .sp
212 This variable is deprecated\&. You should use
213 \fBENCRYPT_METHOD\fR\&.
214 .RE
215 .PP
216 \fBSHA_CRYPT_MIN_ROUNDS\fR (nombre), \fBSHA_CRYPT_MAX_ROUNDS\fR (nombre)
217 .RS 4
218 When
219 \fBENCRYPT_METHOD\fR
220 is set to
221 \fISHA256\fR
222 or
223 \fISHA512\fR, this defines the number of SHA rounds used by the encryption algorithm by default (when the number of rounds is not specified on the command line)\&.
224 .sp
225 With a lot of rounds, it is more difficult to brute forcing the password\&. But note also that more CPU resources will be needed to authenticate users\&.
226 .sp
227 If not specified, the libc will choose the default number of rounds (5000)\&.
228 .sp
229 The values must be inside the 1000\-999999999 range\&.
230 .sp
231 If only one of the
232 \fBSHA_CRYPT_MIN_ROUNDS\fR
233 or
234 \fBSHA_CRYPT_MAX_ROUNDS\fR
235 values is set, then this value will be used\&.
236 .sp
237 If
238 \fBSHA_CRYPT_MIN_ROUNDS\fR
239 >
240 \fBSHA_CRYPT_MAX_ROUNDS\fR, the highest value will be used\&.
241 .RE
242 .SH "FICHIERS"
243 .PP
244 /etc/group
245 .RS 4
246 Informations sur les groupes\&.
247 .RE
248 .PP
249 /etc/gshadow
250 .RS 4
251 Informations s\('ecuris\('ees sur les groupes\&.
252 .RE
253 .SH "VOIR AUSSI"
254 .PP
255 \fBnewgrp\fR(1),
256 \fBgroupadd\fR(8),
257 \fBgroupdel\fR(8),
258 \fBgroupmod\fR(8),
259 \fBgrpck\fR(8),
260 \fBgroup\fR(5), \fBgshadow\fR(5)\&.