[thirdparty/cups.git] / doc / help / man-lppasswd.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>lppasswd(1)</title>
</head>
<body>
<h1 class="title">lppasswd(1)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
lppasswd - add, change, or delete digest passwords.
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>lppasswd
</b>[
<i>username
</i>]
<br>
<b>lppasswd
</b>-a [ -g
<i>groupname
</i>]
<i>username
</i><br>
<b>lppasswd
</b>-x
<i>username
</i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<i>lppasswd</i> adds, changes, or deletes passwords in the CUPS
digest password file, <i>passwd.md5</i>. When run by a normal
user, <i>lppasswd</i> will prompt for the old and new passwords.
When run by the super-user, <i>lppasswd</i> can add new accounts
(<i>-a username</i>), change existing accounts (<i>username</i>),
or delete accounts (<i>-x username</i>) in the digest password
file. Digest usernames do not have to match local UNIX usernames.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
<i>lppasswd</i> supports the following options:
<dl>
<dt>-g groupname
</dt>
<dd></dd>
<dd>Specifies a group other than the default system group.
</dd>
</dl>
<h2 class="title"><a name="SECURITY_ISSUES">Security Issues</a></h2>
By default, the <i>lppasswd</i> program is not installed to allow ordinary
users to change their passwords. To enable this, the <i>lppasswd</i> command
must be made setuid to root with the command:
<br>
<pre>
chmod u+s lppasswd
</pre>
<p>While every attempt has been made to make <i>lppasswd</i> secure against
exploits that could grant super-user privileges to unprivileged users,
paranoid system administrators may wish to use Basic authentication with
accounts managed by PAM instead.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>,
<br>
<a href='http://localhost:631/help'>http://localhost:631/help</a>
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright 2007-2013 by Apple Inc.

</body>
</html>
Commit	Line	Data
62b97abe	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
	2	<html>
	3	<!-- SECTION: Man Pages -->
	4	<head>
	5	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	6	<title>lppasswd(1)</title>
	7	</head>
	8	<body>
	9	<h1 class="title">lppasswd(1)</h1>
	10	<h2 class="title"><a name="NAME">Name</a></h2>
	11	lppasswd - add, change, or delete digest passwords.
	12	<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
	13	<b>lppasswd
	14	</b>[
	15	<i>username
	16	</i>]
	17	<br>
	18	<b>lppasswd
	19	</b>-a [ -g
	20	<i>groupname
	21	</i>]
	22	<i>username
	23	</i><br>
	24	<b>lppasswd
	25	</b>-x
	26	<i>username
	27	</i><h2 class="title"><a name="DESCRIPTION">Description</a></h2>
	28	<i>lppasswd</i> adds, changes, or deletes passwords in the CUPS
	29	digest password file, <i>passwd.md5</i>. When run by a normal
	30	user, <i>lppasswd</i> will prompt for the old and new passwords.
	31	When run by the super-user, <i>lppasswd</i> can add new accounts
	32	(<i>-a username</i>), change existing accounts (<i>username</i>),
	33	or delete accounts (<i>-x username</i>) in the digest password
	34	file. Digest usernames do not have to match local UNIX usernames.
	35	<h2 class="title"><a name="OPTIONS">Options</a></h2>
	36	<i>lppasswd</i> supports the following options:
	37	<dl>
	38	<dt>-g groupname
	39	</dt>
	40	<dd></dd>
	41	<dd>Specifies a group other than the default system group.
	42	</dd>
	43	</dl>
	44	<h2 class="title"><a name="SECURITY_ISSUES">Security Issues</a></h2>
	45	By default, the <i>lppasswd</i> program is not installed to allow ordinary
	46	users to change their passwords. To enable this, the <i>lppasswd</i> command
	47	must be made setuid to root with the command:
	48	<br>
	49	<pre>
	50	chmod u+s lppasswd
	51	</pre>
	52	<p>While every attempt has been made to make <i>lppasswd</i> secure against
	53	exploits that could grant super-user privileges to unprivileged users,
	54	paranoid system administrators may wish to use Basic authentication with
	55	accounts managed by PAM instead.
	56	<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
	57	<a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpr.html?TOPIC=Man+Pages'>lpr(1)</a>,
	58	<br>
	59	<a href='http://localhost:631/help'>http://localhost:631/help</a>
	60	<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
	61	Copyright 2007-2013 by Apple Inc.
	62
	63	</body>
	64	</html>