~xnox/ubuntu/quantal/shadow/clear-locks

« back to all changes in this revision

Viewing changes to man/sv/gpasswd.1

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2009-05-05 09:45:21 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20090505094521-wpk2wn3q7957tlah
Tags: 1:4.1.3.1-1ubuntu1
* Merge from debian unstable, remaining changes:
  - Ubuntu specific:
    + debian/login.defs: use SHA512 by default for password crypt routine.
  - debian/patches/stdout-encrypted-password.patch: chpasswd can report
    password hashes on stdout (debian bug 505640).
  - debian/login.pam: Enable SELinux support (debian bug 527106).
  - debian/securetty.linux: support Freescale MX-series (debian bug 527095).
* Add debian/patches/300_lastlog_failure: fixed upstream (debian bug 524873).
* Drop debian/patches/593_omit_lastchange_field_if_clock_is_misset: fixed
  upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\"     Title: gpasswd
2
2
.\"    Author: 
3
3
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
4
 
.\"      Date: 03-04-2008
 
4
.\"      Date: 15-04-2009
5
5
.\"    Manual: Användarkommandon
6
6
.\"    Source: Användarkommandon
7
7
.\"
8
 
.TH "GPASSWD" "1" "03-04-2008" "Användarkommandon" "Användarkommandon"
 
8
.TH "GPASSWD" "1" "15-04-2009" "Användarkommandon" "Användarkommandon"
9
9
.\" disable hyphenation
10
10
.nh
11
11
.\" disable justification (adjust text to left margin only)
20
20
The
21
21
\fBgpasswd\fR
22
22
command is used to administer
23
 
\fI/etc/group\fR, and \fI/etc/gshadow\fR\. Every group can have
 
23
\fI/etc/group\fR, and \fI/etc/gshadow\fR\&. Every group can have
24
24
administrators,
25
 
members and a password\.
 
25
members and a password\&.
26
26
.PP
27
27
System administrator can use the
28
28
\fB\-A\fR
29
29
option to define group administrator(s) and the
30
30
\fB\-M\fR
31
 
option to define members and has all rights of group administrators and members\.
 
31
option to define members and has all rights of group administrators and members\&.
32
32
.PP
33
33
 
34
34
\fBgpasswd\fR
35
35
called by
36
36
a group administrator
37
37
with a group name only prompts for the new password of the
38
 
\fIgroup\fR\.
 
38
\fIgroup\fR\&.
39
39
.PP
40
40
If a password is set the members can still
41
41
\fBnewgrp\fR(1)
42
 
without a password, and non\-members must supply the password\.
 
42
without a password, and non\-members must supply the password\&.
43
43
.SS "Noteringar angående grupplösenord"
44
44
.PP
45
 
Group passwords are an inherent security problem since more than one person is permitted to know the password\. However, groups are a useful tool for permitting co\-operation between different users\.
 
45
Group passwords are an inherent security problem since more than one person is permitted to know the password\&. However, groups are a useful tool for permitting co\-operation between different users\&.
46
46
.SH "FLAGGOR"
47
47
.PP
48
48
Except for the
49
49
\fB\-A\fR
50
50
and
51
51
\fB\-M\fR
52
 
options, the options cannot be combined\.
 
52
options, the options cannot be combined\&.
53
53
.PP
54
54
The options which apply to the
55
55
\fBgpasswd\fR
56
56
command are:
57
57
.PP
58
 
\fB\-a\fR \fIanvändare\fR
 
58
\fB\-a\fR, \fB\-\-add\fR \fIuser\fR
59
59
.RS 4
60
60
Add the
61
61
\fIuser\fR
62
62
to the named
63
 
\fIgroup\fR\.
 
63
\fIgroup\fR\&.
64
64
.RE
65
65
.PP
66
 
\fB\-d\fR \fIanvändare\fR
 
66
\fB\-d\fR, \fB\-\-delete\fR \fIuser\fR
67
67
.RS 4
68
68
Remove the
69
69
\fIuser\fR
70
70
from the named
71
 
\fIgroup\fR\.
 
71
\fIgroup\fR\&.
72
72
.RE
73
73
.PP
74
 
\fB\-r\fR
 
74
\fB\-r\fR, \fB\-\-remove\-password\fR
75
75
.RS 4
76
76
Remove the password from the named
77
 
\fIgroup\fR\. Only group members will be allowed to use
 
77
\fIgroup\fR\&. Only group members will be allowed to use
78
78
\fBnewgrp\fR
79
79
to join the named
80
 
\fIgroup\fR\.
 
80
\fIgroup\fR\&.
81
81
.RE
82
82
.PP
83
 
\fB\-R\fR
 
83
\fB\-R\fR, \fB\-\-restrict\fR
84
84
.RS 4
85
85
Restrict the access to the named
86
 
\fIgroup\fR\. Only group members will be allowed to use
 
86
\fIgroup\fR\&. Only group members will be allowed to use
87
87
\fBnewgrp\fR
88
88
to join the named
89
 
\fIgroup\fR\.
90
 
.RE
91
 
.PP
92
 
\fB\-A\fR \fIuser\fR,\.\.\.
93
 
.RS 4
94
 
Set the list of administrative users\.
95
 
.RE
96
 
.PP
97
 
\fB\-M\fR \fIuser\fR,\.\.\.
98
 
.RS 4
99
 
Set the list of group members\.
 
89
\fIgroup\fR\&.
 
90
.RE
 
91
.PP
 
92
\fB\-A\fR, \fB\-\-administrators\fR \fIuser\fR,\&.\&.\&.
 
93
.RS 4
 
94
Set the list of administrative users\&.
 
95
.RE
 
96
.PP
 
97
\fB\-M\fR, \fB\-\-members\fR \fIuser\fR,\&.\&.\&.
 
98
.RS 4
 
99
Set the list of group members\&.
100
100
.RE
101
101
.SH "TÄNK PÅ"
102
102
.PP
103
103
This tool only operates on the
104
104
\fI/etc/group\fR
105
 
and \fI/etc/gshadow\fR files\.
106
 
Thus you cannot change any NIS or LDAP group\. This must be performed on the corresponding server\.
 
105
and \fI/etc/gshadow\fR files\&.
 
106
Thus you cannot change any NIS or LDAP group\&. This must be performed on the corresponding server\&.
107
107
.SH "CONFIGURATION"
108
108
.PP
109
109
The following configuration variables in
110
 
\fI/etc/login\.defs\fR
 
110
\fI/etc/login\&.defs\fR
111
111
change the behavior of this tool:
112
112
.PP
113
113
\fBENCRYPT_METHOD\fR (string)
114
114
.RS 4
115
 
This defines the system default encryption algorithm for encrypting passwords (if no algorithm are specified on the command line)\.
 
115
This defines the system default encryption algorithm for encrypting passwords (if no algorithm are specified on the command line)\&.
116
116
.sp
117
117
It can take one of these values:
118
118
.sp
136
136
.sp
137
137
Note: this parameter overrides the
138
138
\fBMD5_CRYPT_ENAB\fR
139
 
variable\.
 
139
variable\&.
140
140
.sp
141
 
Note: if you use PAM, it is recommended to set this variable consistently with the PAM modules configuration\.
 
141
Note: if you use PAM, it is recommended to set this variable consistently with the PAM modules configuration\&.
142
142
.RE
143
143
.PP
144
144
\fBMAX_MEMBERS_PER_GROUP\fR (number)
145
145
.RS 4
146
 
Maximum members per group entry\. When the maximum is reached, a new group entry (line) is started in
 
146
Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
147
147
\fI/etc/group\fR
148
 
(with the same name, same password, and same GID)\.
149
 
.sp
150
 
The default value is 0, meaning that there are no limits in the number of members in a group\.
151
 
.sp
152
 
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\.
153
 
.sp
154
 
If you need to enforce such limit, you can use 25\.
155
 
.sp
156
 
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\.
 
148
(with the same name, same password, and same GID)\&.
 
149
.sp
 
150
The default value is 0, meaning that there are no limits in the number of members in a group\&.
 
151
.sp
 
152
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\&.
 
153
.sp
 
154
If you need to enforce such limit, you can use 25\&.
 
155
.sp
 
156
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\&.
157
157
.RE
158
158
.PP
159
159
\fBMD5_CRYPT_ENAB\fR (boolean)
160
160
.RS 4
161
 
Indicate if passwords must be encrypted using the MD5\-based algorithm\. If set to
162
 
\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
 
161
Indicate if passwords must be encrypted using the MD5\-based algorithm\&. If set to
 
162
\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
163
163
\fIno\fR
164
 
if you need to copy encrypted passwords to other systems which don\'t understand the new algorithm\. Default is
165
 
\fIno\fR\.
 
164
if you need to copy encrypted passwords to other systems which don\'t understand the new algorithm\&. Default is
 
165
\fIno\fR\&.
166
166
.sp
167
167
This variable is superceded by the
168
168
\fBENCRYPT_METHOD\fR
169
 
variable or by any command line option used to configure the encryption algorithm\.
170
 
.sp
171
 
This variable is deprecated\. You should use
172
 
\fBENCRYPT_METHOD\fR\.
173
 
.sp
174
 
Note: if you use PAM, it is recommended to set this variable consistently with the PAM modules configuration\.
 
169
variable or by any command line option used to configure the encryption algorithm\&.
 
170
.sp
 
171
This variable is deprecated\&. You should use
 
172
\fBENCRYPT_METHOD\fR\&.
 
173
.sp
 
174
Note: if you use PAM, it is recommended to set this variable consistently with the PAM modules configuration\&.
175
175
.RE
176
176
.PP
177
177
\fBSHA_CRYPT_MIN_ROUNDS\fR (number), \fBSHA_CRYPT_MAX_ROUNDS\fR (number)
181
181
is set to
182
182
\fISHA256\fR
183
183
or
184
 
\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)\.
185
 
.sp
186
 
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\.
187
 
.sp
188
 
If not specified, the libc will choose the default number of rounds (5000)\.
189
 
.sp
190
 
The values must be inside the 1000\-999999999 range\.
 
184
\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)\&.
 
185
.sp
 
186
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\&.
 
187
.sp
 
188
If not specified, the libc will choose the default number of rounds (5000)\&.
 
189
.sp
 
190
The values must be inside the 1000\-999999999 range\&.
191
191
.sp
192
192
If only one of the
193
193
\fBSHA_CRYPT_MIN_ROUNDS\fR
194
194
or
195
195
\fBSHA_CRYPT_MAX_ROUNDS\fR
196
 
values is set, then this value will be used\.
 
196
values is set, then this value will be used\&.
197
197
.sp
198
198
If
199
199
\fBSHA_CRYPT_MIN_ROUNDS\fR
200
200
>
201
 
\fBSHA_CRYPT_MAX_ROUNDS\fR, the highest value will be used\.
 
201
\fBSHA_CRYPT_MAX_ROUNDS\fR, the highest value will be used\&.
202
202
.RE
203
203
.SH "FILER"
204
204
.PP
205
205
\fI/etc/group\fR
206
206
.RS 4
207
 
Gruppkontoinformation\.
 
207
Gruppkontoinformation\&.
208
208
.RE
209
209
.PP
210
210
\fI/etc/gshadow\fR
211
211
.RS 4
212
 
Säker gruppkontoinformation\.
 
212
Säker gruppkontoinformation\&.
213
213
.RE
214
214
.SH "SE OCKSÅ"
215
215
.PP
219
219
\fBgroupdel\fR(8),
220
220
\fBgroupmod\fR(8),
221
221
\fBgrpck\fR(8),
222
 
\fBgroup\fR(5), \fBgshadow\fR(5)\.
 
222
\fBgroup\fR(5), \fBgshadow\fR(5)\&.