← Back to branch summary

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

« back to all changes in this revision

Viewing changes to apps/lpasswd.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/lpasswd.1
 
1
.\" A man page for lpasswd
 
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 lpasswd 1 "Jan 12 2005" libuser
 
20
 
 
21
.SH NAME
 
22
lpasswd \- Change group or user password
 
23
 
 
24
.SH SYNOPSIS
 
25
lchsh [\fIOPTION\fR]... [\fIname\fR]
 
26
 
 
27
.SH DESCRIPTION
 
28
Changes password of user or group \fIname\fR.
 
29
 
 
30
If the \fIname\fR argument is not provided,
 
31
username of the invoking user is used;
 
32
the \fIname\fR argument is ignored if
 
33
.B lchsh
 
34
is run set-uid to a different user.
 
35
 
 
36
Entering an empty password (by pressing Enter)
 
37
aborts the password setting operation.
 
38
 
 
39
.SH OPTIONS
 
40
.TP
 
41
\fB\-F\fR, \fB\-\-plainpassword-fd\fR=\fIfd\fR
 
42
Read password from file descriptor \fIfd\fR, terminated by end of file,
 
43
\fB'\\r'\fR or \fB'\\n'\fR.
 
44
 
 
45
.TP
 
46
\fB\-f\fR, \fB\-\-password-fd\fR=\fIfd\fR
 
47
Read password hash from file descriptor \fIfd\fR, terminated by end of file,
 
48
\fB'\\r'\fR or \fB'\\n'\fR.
 
49
 
 
50
.TP
 
51
\fB\-g\fR, \fB\-\-group\fR
 
52
Change password of group \fIname\fR.
 
53
By default the password of user \fIname\fR is changed.
 
54
 
 
55
.TP
 
56
\fB\-i\fR, \fB\-\-interactive\fR 
 
57
Ask all questions when connecting to the user database,
 
58
even if default answers are set up in
 
59
.B libuser
 
60
configuration.
 
61
 
 
62
.TP
 
63
\fB\-P\fR, \fB\-\-plainpassword\fR=\fIpassword\fR
 
64
Set the password to \fIpassword\fR.
 
65
Note that the password can be viewed while running
 
66
.BR lpasswd
 
67
using tools such as
 
68
.BR ps (1)\fR.
 
69
 
 
70
.TP
 
71
\fB\-p\fR, \fB\-\-password\fR=\fIencrypted\fR
 
72
Set the password to the password represented by the hash \fIencrypted\fR.
 
73
Note that the hash can be viewed while running
 
74
.BR lpasswd
 
75
using tools such as
 
76
.BR ps (1)\fR.
 
77
 
 
78
.SH EXIT STATUS
 
79
The exit status is 0 on success, nonzero on error.