]> git.ipfire.org Git - thirdparty/cups.git/blob - man/lppasswd.man
Merge changes from CUPS 1.4svn-r7696.
[thirdparty/cups.git] / man / lppasswd.man
1 .\"
2 .\" "$Id: lppasswd.man 7600 2008-05-20 21:06:23Z mike $"
3 .\"
4 .\" lpadmin man page for the Common UNIX Printing System (CUPS).
5 .\"
6 .\" Copyright 2007-2008 by Apple Inc.
7 .\" Copyright 1997-2006 by Easy Software Products.
8 .\"
9 .\" These coded instructions, statements, and computer programs are the
10 .\" property of Apple Inc. and are protected by Federal copyright
11 .\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 .\" which should have been included with this file. If this file is
13 .\" file is missing or damaged, see the license at "http://www.cups.org/".
14 .\"
15 .TH lppasswd 1 "Common UNIX Printing System" "22 February 2008" "Apple Inc."
16 .SH NAME
17 lppasswd \- add, change, or delete digest passwords.
18 .SH SYNOPSIS
19 .B lppasswd
20 [
21 .I username
22 ]
23 .br
24 .B lppasswd
25 -a [ -g
26 .I groupname
27 ]
28 .I username
29 .br
30 .B lppasswd
31 -x
32 .I username
33 .SH DESCRIPTION
34 \fIlppasswd\fR adds, changes, or deletes passwords in the CUPS
35 digest password file, \fIpasswd.md5\fR. When run by a normal
36 user, \fIlppasswd\fR will prompt for the old and new passwords.
37 When run by the super-user, \fIlppasswd\fR can add new accounts
38 (\fI-a username\fR), change existing accounts (\fIusername\fR),
39 or delete accounts (\fI-x username\fR) in the digest password
40 file. Digest usernames do not have to match local UNIX usernames.
41 .SH OPTIONS
42 \fIlppasswd\fR supports the following options:
43 .TP 5
44 -g groupname
45 .br
46 Specifies a group other than the default system group.
47 .SH SECURITY ISSUES
48 By default, the \fIlppasswd\fR program is not installed to allow ordinary
49 users to change their passwords. To enable this, the \fIlppasswd\fR command
50 must be made setuid to root with the command:
51 .br
52 .nf
53 chmod u+s lppasswd
54 .fi
55 .PP
56 While every attempt has been made to make \fIlppasswd\fR secure against
57 exploits that could grant super-user privileges to unprivileged users,
58 paranoid system administrators may wish to use Basic authentication with
59 accounts managed by PAM instead.
60 .SH SEE ALSO
61 \fIlp(1)\fR, \fIlpr(1)\fR,
62 .br
63 http://localhost:631/help
64 .SH COPYRIGHT
65 Copyright 2007-2008 by Apple Inc.
66 .\"
67 .\" End of "$Id: lppasswd.man 7600 2008-05-20 21:06:23Z mike $".
68 .\"