doc/help/man-lppasswd.html

   1 <!DOCTYPE HTML>
   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</b>
  14 [
  15 <i>username</i>
  16 ]
  17 <br>
  18 <b>lppasswd</b>
  19 -a [ -g
  20 <i>groupname</i>
  21 ]
  22 <i>username</i>
  23 <br>
  24 <b>lppasswd</b>
  25 -x
  26 <i>username</i>
  27 <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 <p style="margin-left: 5.0em; text-indent: -5.0em">-g groupname
  38 <br>
  39 <br>
  40 Specifies a group other than the default system group.
  41 <h2 class="title"><a name="SECURITY_ISSUES">Security Issues</a></h2>
  42 By default, the <i>lppasswd</i> program is not installed to allow ordinary
  43 users to change their passwords. To enable this, the <i>lppasswd</i> command
  44 must be made setuid to root with the command:
  45 <br>
  46 <pre>
  47 chmod u+s lppasswd
  48 </pre>
  49 <p>While every attempt has been made to make <i>lppasswd</i> secure against
  50 exploits that could grant super-user privileges to unprivileged users,
  51 paranoid system administrators may wish to use Basic authentication with
  52 accounts managed by PAM instead.
  53 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
  54 <i>lp(1)</i>, <i>lpr(1)</i>,
  55 <br>
  56 <a href="http://localhost:631/help">http://localhost:631/help</a>
  57 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
  58 Copyright 2007-2013 by Apple Inc.
  59
  60 </body>
  61 </html>