Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / sv / usermod.8
1 '\" t
2 .\"     Title: usermod
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: Systemhanteringskommandon
7 .\"    Source: Systemhanteringskommandon
8 .\"  Language: Swedish
9 .\"
10 .TH "USERMOD" "8" "16-02-2011" "Systemhanteringskommandon" "Systemhanteringskommandon"
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 "NAMN"
31 usermod \- \(:andra ett anv\(:andarkonto
32 .SH "SYNOPSIS"
33 .HP \w'\fBusermod\fR\ 'u
34 \fBusermod\fR [\fIflaggor\fR] \fIINLOGGNINGSNAMN\fR
35 .SH "BESKRIVNING"
36 .PP
37 Kommandot
38 \fBusermod\fR
39 \(:andrar systemkontofiler enligt det som anges p\(oa kommandoraden\&.
40 .SH "FLAGGOR"
41 .PP
42 Flaggorna som g\(:aller f\(:or kommandot
43 \fBusermod\fR
44 \(:ar:
45 .PP
46 \fB\-a\fR, \fB\-\-append\fR
47 .RS 4
48 Add the user to the supplementary group(s)\&. Use only with the
49 \fB\-G\fR
50 option\&.
51 .RE
52 .PP
53 \fB\-c\fR, \fB\-\-comment\fR\fIKOMMENTAR\fR
54 .RS 4
55 Det nya v\(:ardet f\(:or anv\(:andarens kommentarsf\(:alt i l\(:osenordsfilen\&. Vanligtvis \(:andras det med verktyget
56 \fBchfn\fR(1)\&.
57 .RE
58 .PP
59 \fB\-d\fR, \fB\-\-home\fR\fIHEM_KAT\fR
60 .RS 4
61 The user\*(Aqs new login directory\&.
62 .sp
63 If the
64 \fB\-m\fR
65 option is given, the contents of the current home directory will be moved to the new home directory, which is created if it does not already exist\&.
66 .RE
67 .PP
68 \fB\-e\fR, \fB\-\-expiredate\fR\fIUTG\(oANGSDATUM\fR
69 .RS 4
70 The date on which the user account will be disabled\&. The date is specified in the format
71 \fIYYYY\-MM\-DD\fR\&.
72 .RE
73 .PP
74 \fB\-f\fR, \fB\-\-inactive\fR\fIINAKTIV\fR
75 .RS 4
76 The number of days after a password expires until the account is permanently disabled\&.
77 .sp
78 A value of 0 disables the account as soon as the password has expired, and a value of \-1 disables the feature\&.
79 .RE
80 .PP
81 \fB\-g\fR, \fB\-\-gid\fR\fIGRUPP\fR
82 .RS 4
83 The group name or number of the user\*(Aqs new initial login group\&. The group must exist\&.
84 .RE
85 .PP
86 \fB\-G\fR, \fB\-\-groups\fR\fIGRUPP1\fR[\fI,GRUPP2,\&.\&.\&.\fR[\fI,GRUPPN\fR]]]
87 .RS 4
88 A list of supplementary groups which the user is also a member of\&. Each group is separated from the next by a comma, with no intervening whitespace\&. The groups are subject to the same restrictions as the group given with the
89 \fB\-g\fR
90 option\&.
91 .sp
92 If the user is currently a member of a group which is not listed, the user will be removed from the group\&. This behaviour can be changed via the
93 \fB\-a\fR
94 option, which appends the user to the current supplementary group list\&.
95 .RE
96 .PP
97 \fB\-l\fR, \fB\-\-login\fR\fINYTT_INLOGGNINGSNAMN\fR
98 .RS 4
99 The name of the user will be changed from
100 \fILOGIN\fR
101 to
102 \fINEW_LOGIN\fR\&. Nothing else is changed\&. In particular, the user\*(Aqs home directory name should probably be changed manually to reflect the new login name\&.
103 .RE
104 .PP
105 \fB\-L\fR, \fB\-\-lock\fR
106 .RS 4
107 L\(oas en anv\(:andares l\(:osenord\&. Detta s\(:atter ett "!" i b\(:orjan av det krypterade l\(:osenordet som effektivt inaktiverar l\(:osenordet\&. Du kan inte anv\(:anda denna flagga med
108 \fB\-p\fR
109 eller
110 \fB\-U\fR\&.
111 .sp
112 Note: if you wish to lock the account (not only access with a password), you should also set the
113 \fIEXPIRE_DATE\fR
114 to
115 \fI1\fR\&.
116 .RE
117 .PP
118 \fB\-m\fR, \fB\-\-move\-home\fR
119 .RS 4
120 Move the content of the user\*(Aqs home directory to the new location\&.
121 .sp
122 This option is only valid in combination with the
123 \fB\-d\fR
124 (or
125 \fB\-\-home\fR) option\&.
126 .RE
127 .PP
128 \fB\-o\fR, \fB\-\-non\-unique\fR
129 .RS 4
130 When used with the
131 \fB\-u\fR
132 option, this option allows to change the user ID to a non\-unique value\&.
133 .RE
134 .PP
135 \fB\-p\fR, \fB\-\-password\fR\fIL\(:OSENORD\fR
136 .RS 4
137 Det krypterade l\(:osenordet, som returneras av
138 \fBcrypt\fR(3)\&.
139 .sp
140
141 \fBNote:\fR
142 This option is not recommended because the password (or encrypted password) will be visible by users listing the processes\&.
143 .sp
144 You should make sure the password respects the system\*(Aqs password policy\&.
145 .RE
146 .PP
147 \fB\-s\fR, \fB\-\-shell\fR\fISKAL\fR
148 .RS 4
149 The name of the user\*(Aqs new login shell\&. Setting this field to blank causes the system to select the default login shell\&.
150 .RE
151 .PP
152 \fB\-u\fR, \fB\-\-uid\fR\fIUID\fR
153 .RS 4
154 The new numerical value of the user\*(Aqs ID\&.
155 .sp
156 This value must be unique, unless the
157 \fB\-o\fR
158 option is used\&. The value must be non\-negative\&. Values between 0 and 999 are typically reserved for system accounts\&.
159 .sp
160 The user\*(Aqs mailbox, and any files which the user owns and which are located in the user\*(Aqs home directory will have the file user ID changed automatically\&.
161 .sp
162 The ownership of files outside of the user\*(Aqs home directory must be fixed manually\&.
163 .RE
164 .PP
165 \fB\-U\fR, \fB\-\-unlock\fR
166 .RS 4
167 L\(oaser upp en anv\(:andares l\(:osenord\&. Detta tar bort det inledande "!" i det krypterade l\(:osenordet\&. Du kan inte anv\(:anda denna flagga med
168 \fB\-p\fR
169 eller
170 \fB\-L\fR\&.
171 .sp
172 Note: if you wish to unlock the account (not only access with a password), you should also set the
173 \fIEXPIRE_DATE\fR
174 (for example to
175 \fI99999\fR, or to the
176 \fBEXPIRE\fR
177 value from
178 /etc/default/useradd)\&.
179 .RE
180 .PP
181 \fB\-Z\fR, \fB\-\-selinux\-user\fR \fISEUSER\fR
182 .RS 4
183 The SELinux user for the user\*(Aqs login\&. The default is to leave this field the blank, which causes the system to select the default SELinux user\&.
184 .RE
185 .SH "T\(:ANK P\(oA"
186 .PP
187 You must make certain that the named user is not executing any processes when this command is being executed if the user\*(Aqs numerical user ID, the user\*(Aqs name, or the user\*(Aqs home directory is being changed\&.
188 \fBusermod\fR
189 checks this on Linux, but only check if the user is logged in according to utmp on other architectures\&.
190 .PP
191 You must change the owner of any
192 \fBcrontab\fR
193 files or
194 \fBat\fR
195 jobs manually\&.
196 .PP
197 You must make any changes involving NIS on the NIS server\&.
198 .SH "CONFIGURATION"
199 .PP
200 The following configuration variables in
201 /etc/login\&.defs
202 change the behavior of this tool:
203 .PP
204 \fBMAIL_DIR\fR (string)
205 .RS 4
206 The mail spool directory\&. This is needed to manipulate the mailbox when its corresponding user account is modified or deleted\&. If not specified, a compile\-time default is used\&.
207 .RE
208 .PP
209 \fBMAIL_FILE\fR (string)
210 .RS 4
211 Defines the location of the users mail spool files relatively to their home directory\&.
212 .RE
213 .PP
214 The
215 \fBMAIL_DIR\fR
216 and
217 \fBMAIL_FILE\fR
218 variables are used by
219 \fBuseradd\fR,
220 \fBusermod\fR, and
221 \fBuserdel\fR
222 to create, move, or delete the user\*(Aqs mail spool\&.
223 .PP
224 If
225 \fBMAIL_CHECK_ENAB\fR
226 is set to
227 \fIyes\fR, they are also used to define the
228 \fBMAIL\fR
229 environment variable\&.
230 .PP
231 \fBMAX_MEMBERS_PER_GROUP\fR (number)
232 .RS 4
233 Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
234 /etc/group
235 (with the same name, same password, and same GID)\&.
236 .sp
237 The default value is 0, meaning that there are no limits in the number of members in a group\&.
238 .sp
239 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\&.
240 .sp
241 If you need to enforce such limit, you can use 25\&.
242 .sp
243 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\&.
244 .RE
245 .SH "FILER"
246 .PP
247 /etc/group
248 .RS 4
249 Gruppkontoinformation\&.
250 .RE
251 .PP
252 /etc/gshadow
253 .RS 4
254 S\(:aker gruppkontoinformation\&.
255 .RE
256 .PP
257 /etc/passwd
258 .RS 4
259 Anv\(:andarkontoinformation\&.
260 .RE
261 .PP
262 /etc/shadow
263 .RS 4
264 S\(:aker anv\(:andarkontoinformation\&.
265 .RE
266 .SH "SE OCKS\(oA"
267 .PP
268 \fBchfn\fR(1),
269 \fBchsh\fR(1),
270 \fBpasswd\fR(1),
271 \fBcrypt\fR(3),
272 \fBgpasswd\fR(8),
273 \fBgroupadd\fR(8),
274 \fBgroupdel\fR(8),
275 \fBgroupmod\fR(8),
276 \fBlogin.defs\fR(5),
277 \fBuseradd\fR(8),
278 \fBuserdel\fR(8)\&.