[thirdparty/cups.git] / man / lppasswd.man

.\"
.\" "$Id: lppasswd.man 6649 2007-07-11 21:46:42Z mike $"
.\"
.\"   lpadmin man page for the Common UNIX Printing System (CUPS).
.\"
.\"   Copyright 2007 by Apple Inc.
.\"   Copyright 1997-2006 by Easy Software Products.
.\"
.\"   These coded instructions, statements, and computer programs are the
.\"   property of Apple Inc. and are protected by Federal copyright
.\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
.\"   which should have been included with this file.  If this file is
.\"   file is missing or damaged, see the license at "http://www.cups.org/".
.\"
.TH lppasswd 1 "Common UNIX Printing System" "20 March 2006" "Apple Inc."
.SH NAME
lppasswd \- add, change, or delete digest passwords.
.SH SYNOPSIS
.B lppasswd
[
.I username
]
.br
.B lppasswd
-a [ -g
.I groupname
]
.I username
.br
.B lppasswd
-x
.I username
.SH DESCRIPTION
\fIlppasswd\fR adds, changes, or deletes passwords in the CUPS
digest password file, \fIpasswd.md5\fR. When run by a normal
user, \fIlppasswd\fR will prompt for the old and new passwords.
When run by the super-user, \fIlppasswd\fR can add new accounts
(\fI-a username\fR), change existing accounts (\fIusername\fR),
or delete accounts (\fI-x username\fR) in the digest password
file. Digest usernames do not have to match local UNIX usernames.
.SH OPTIONS
\fIlppasswd\fR supports the following options:
.TP 5
-g groupname
.br
Specifies a group other than the default system group.
.SH SECURITY ISSUES
The \fIlppasswd\fR command is installed setuid to root. While
every attempt has been made to make it secure against exploits
that could grant super-user privileges to unprivileged users,
paranoid system administrators may wish to disable or change the
ownership of the program to an unprivileged account.
.SH SEE ALSO
\fIlp(1)\fR, \fIlpr(1)\fR,
.br
http://localhost:631/help
.SH COPYRIGHT
Copyright 2007 by Apple Inc.
.\"
.\" End of "$Id: lppasswd.man 6649 2007-07-11 21:46:42Z mike $".
.\"
Commit	Line	Data
	1	.\"
	2	.\" "$Id: lppasswd.man 6649 2007-07-11 21:46:42Z mike $"
	3	.\"
	4	.\" lpadmin man page for the Common UNIX Printing System (CUPS).
	5	.\"
	6	.\" Copyright 2007 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" "20 March 2006" "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	The \fIlppasswd\fR command is installed setuid to root. While
	49	every attempt has been made to make it secure against exploits
	50	that could grant super-user privileges to unprivileged users,
	51	paranoid system administrators may wish to disable or change the
	52	ownership of the program to an unprivileged account.
	53	.SH SEE ALSO
	54	\fIlp(1)\fR, \fIlpr(1)\fR,
	55	.br
	56	http://localhost:631/help
	57	.SH COPYRIGHT
	58	Copyright 2007 by Apple Inc.
	59	.\"
	60	.\" End of "$Id: lppasswd.man 6649 2007-07-11 21:46:42Z mike $".
	61	.\"