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

.\"
.\" "$Id: lppasswd.man 5099 2006-02-13 02:46:10Z mike $"
.\"
.\"   lpadmin man page for the Common UNIX Printing System (CUPS).
.\"
.\"   Copyright 1997-2006 by Easy Software Products.
.\"
.\"   These coded instructions, statements, and computer programs are the
.\"   property of Easy Software Products 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 missing or damaged please contact Easy Software Products
.\"   at:
.\"
.\"       Attn: CUPS Licensing Information
.\"       Easy Software Products
.\"       44141 Airport View Drive, Suite 204
.\"       Hollywood, Maryland 20636 USA
.\"
.\"       Voice: (301) 373-9600
.\"       EMail: cups-info@cups.org
.\"         WWW: http://www.cups.org
.\"
.TH lppasswd 1 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
.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 priviledges 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 1997-2006 by Easy Software Products, All Rights Reserved.
.\"
.\" End of "$Id: lppasswd.man 5099 2006-02-13 02:46:10Z mike $".
.\"
Commit	Line	Data
	1	.\"
	2	.\" "$Id: lppasswd.man 5099 2006-02-13 02:46:10Z mike $"
	3	.\"
	4	.\" lpadmin man page for the Common UNIX Printing System (CUPS).
	5	.\"
	6	.\" Copyright 1997-2006 by Easy Software Products.
	7	.\"
	8	.\" These coded instructions, statements, and computer programs are the
	9	.\" property of Easy Software Products and are protected by Federal
	10	.\" copyright law. Distribution and use rights are outlined in the file
	11	.\" "LICENSE.txt" which should have been included with this file. If this
	12	.\" file is missing or damaged please contact Easy Software Products
	13	.\" at:
	14	.\"
	15	.\" Attn: CUPS Licensing Information
	16	.\" Easy Software Products
	17	.\" 44141 Airport View Drive, Suite 204
	18	.\" Hollywood, Maryland 20636 USA
	19	.\"
	20	.\" Voice: (301) 373-9600
	21	.\" EMail: cups-info@cups.org
	22	.\" WWW: http://www.cups.org
	23	.\"
	24	.TH lppasswd 1 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
	25	.SH NAME
	26	lppasswd \- add, change, or delete digest passwords.
	27	.SH SYNOPSIS
	28	.B lppasswd
	29	[
	30	.I username
	31	]
	32	.br
	33	.B lppasswd
	34	-a [ -g
	35	.I groupname
	36	]
	37	.I username
	38	.br
	39	.B lppasswd
	40	-x
	41	.I username
	42	.SH DESCRIPTION
	43	\fIlppasswd\fR adds, changes, or deletes passwords in the CUPS
	44	digest password file, \fIpasswd.md5\fR. When run by a normal
	45	user, \fIlppasswd\fR will prompt for the old and new passwords.
	46	When run by the super-user, \fIlppasswd\fR can add new accounts
	47	(\fI-a username\fR), change existing accounts (\fIusername\fR),
	48	or delete accounts (\fI-x username\fR) in the digest password
	49	file. Digest usernames do not have to match local UNIX usernames.
	50	.SH OPTIONS
	51	\fIlppasswd\fR supports the following options:
	52	.TP 5
	53	-g groupname
	54	.br
	55	Specifies a group other than the default system group.
	56	.SH SECURITY ISSUES
	57	The \fIlppasswd\fR command is installed setuid to root. While
	58	every attempt has been made to make it secure against exploits
	59	that could grant super-user priviledges to unprivileged users,
	60	paranoid system administrators may wish to disable or change the
	61	ownership of the program to an unprivileged account.
	62	.SH SEE ALSO
	63	\fIlp(1)\fR, \fIlpr(1)\fR,
	64	.br
	65	http://localhost:631/help
	66	.SH COPYRIGHT
	67	Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
	68	.\"
	69	.\" End of "$Id: lppasswd.man 5099 2006-02-13 02:46:10Z mike $".
	70	.\"