← Back to branch summary

~ubuntu-branches/ubuntu/feisty/libuser/feisty

« back to all changes in this revision

Viewing changes to apps/lusermod.1

  • Committer: Bazaar Package Importer
  • Author(s): Ghe Rivero
  • Date: 2005-09-30 16:22:04 UTC
  • Revision ID: james.westby@ubuntu.com-20050930162204-qubxaa7e2lbovdgh
Tags: upstream-0.54.dfsg.1
Import upstream version 0.54.dfsg.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
apps/lusermod.1
 
1
.\" A man page for lusermod
 
2
.\" Copyright (C) 2005 Red Hat, Inc.
 
3
.\"
 
4
.\" This is free software; you can redistribute it and/or modify it under
 
5
.\" the terms of the GNU Library General Public License as published by
 
6
.\" the Free Software Foundation; either version 2 of the License, or
 
7
.\" (at your option) any later version.
 
8
.\"
 
9
.\" This program is distributed in the hope that it will be useful, but
 
10
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
 
11
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 
12
.\" General Public License for more details.
 
13
.\"
 
14
.\" You should have received a copy of the GNU Library General Public
 
15
.\" License along with this program; if not, write to the Free Software
 
16
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 
17
.\"
 
18
.\" Author: Miloslav Trmac <mitr@redhat.com>
 
19
.TH lusermod 1 "Jan 15 2005" libuser
 
20
 
 
21
.SH NAME
 
22
lusermod \- Modify an user
 
23
 
 
24
.SH SYNOPSIS
 
25
lusermod [\fIOPTION\fR]... \fIuser\fR
 
26
 
 
27
.SH DESCRIPTION
 
28
Modifies the user with name \fIuser\fR.
 
29
 
 
30
.SH OPTIONS
 
31
.TP
 
32
\fB\-c\fR, \fB\-\-gecos\fR=\fIgecos\fR
 
33
Set \fIuser\fR's \f[SM]GECOS\fR field to \fIgecos\fR.
 
34
The \f[SM]GECOS\fR field is traditionally used to store user's real name
 
35
and other information.
 
36
 
 
37
.TP
 
38
\fB\-d\fR, \fB\-\-directory\fR=\fIdirectory\fR
 
39
Set \fIuser\fR's home directory to \fIdirectory\fR.
 
40
 
 
41
.TP
 
42
\fB\-g\fR, \fB\-\-gid\fR=\fIgid\fR
 
43
Change \fIuser\fR's primary group ID to \fIgid\fR.
 
44
 
 
45
.TP
 
46
\fB\-i\fR, \fB\-\-interactive\fR 
 
47
Ask all questions when connecting to the user database,
 
48
even if default answers are set up in
 
49
.B libuser
 
50
configuration.
 
51
 
 
52
.TP
 
53
\fB\-L\fR, \fB\-\-lock\fR
 
54
Lock \fIuser\fR's account.
 
55
This prevents logging in using \fIuser\fR's password.
 
56
 
 
57
.TP
 
58
\fB\-l\fR, \fB\-\-login\fR=\fIname\fR
 
59
Rename \fIuser\fR to \fIname\fR.
 
60
 
 
61
.TP
 
62
\fB\-m\fR, \fB\-\-movedirectory\fR
 
63
After changing \fIuser\fR's home directory (using the \fB\-d\fR option),
 
64
move the old home directory to the new location.
 
65
 
 
66
.TP
 
67
\fB\-P\fR, \fB\-\-plainpassword\fR=\fIpassword\fR
 
68
Set \fIuser\fR's password to \fIpassword\fR.
 
69
Note that the password can be viewed while running
 
70
.BR lusermod
 
71
using tools such as
 
72
.BR ps (1)\fR.
 
73
 
 
74
.TP
 
75
\fB\-p\fR, \fB\-\-password\fR=\fIencrypted\fR
 
76
Set \fIuser\fR's password to the password represented by the hash
 
77
\fIencrypted\fR.
 
78
Note that the hash can be viewed while running
 
79
.BR lusermod
 
80
using tools such as
 
81
.BR ps (1)\fR.
 
82
 
 
83
.TP
 
84
\fB\-s\fR, \fB\-\-shell\fR=\fIshell\fR
 
85
Set \fIuser\fR's login shell to \fIshell\fR.
 
86
 
 
87
.TP
 
88
\fB\-U\fR, \fB\-\-unlock\fR
 
89
Unlock \fIuser\fR's account.
 
90
 
 
91
.TP
 
92
\fB\-u\fR, \fB\-\-uid\fR=\fIuid\fR
 
93
Change \fIuser\fR's user ID to \fIuid\fR.
 
94
 
 
95
.SH EXIT STATUS
 
96
The exit status is 0 on success, nonzero on error.