ppuser.8
ppuser - PPR user database management utility
ppuser
[subcommand] [parameters ... ]
-
ppuser add
'user name' 'real name' authcode initialbalance cutoff life
-
Adds a user to the accounting database. ``User name'' is the name of the
user as it will appear in ``
%%For:
'' comments and R<ppr(1)> -f switches.
``Real name'' is the name ``user name'' should be translated to
before it is used in queue listings or banner pages. (For example, if
``user name'' is ``jandrews'', ``real name'' might be "Joseph Andrews.
When ppr is invoked by a unix user, this field is ignored in favour of the
/etc/passwd gecos field, but this field will eventually be used for jobs
received from personal computers.)
Authcode is the password which will identify the user.
IInitialbalance> is the user's starting balance. Cutoff is the
balance below which printing privledges should be denied. Life is the
lifetime of the account. It is measured in days of inactivity. Accounts
are not deleted automatically, a separate program must be employed to
compare the period of inactivity to the life parameter. Such a program is
not included in the current distribution.
-
ppuser delete
'user name'
-
delete the indicated user.
-
ppuser show
'user name'
-
show the indicated user's account information.
-
ppuser authcode
'user name' authcode
-
set the indicated users authorization code (password) to \f2authcode\f1.
-
ppuser deposit
'user name' amount
-
deposit money in amount amount in the indicated user's account.
-
ppuser withdraw
'user name' amount
-
withdraw the indicated amount amount of money from the indicated
account. This command should be used when refunding unused money.
-
ppuser charge
'user name' amount
-
assess a charge of amount against the indicated account. PPR does
this automatically when a job is printed on a printer for which charges are
made.
-
ppuser correction
'user name' amount
-
make a correction to the indicated user's account. If amount is
positive, the amount of money in the user's account will increase, if it is
negative, the amount of money in the account will decrease.
.
To set up a new account for John Jones with an initial deposit of $10.00, a
cutoff when he is overdrawn by more than $2.50 and to have his account
disappear if it is unused for a year:
$ /usr/ppr/bin/ppuser add ``John Jones'' ``John Jones'' 10.00 -2.50 365
Or, if Mr. Jones will be entering an account-style name instead of his real
name:
$ /usr/ppr/bin/ppuser add jjones ``John Jones'' 10.00 -2.50 365
To set his password to ``secret'':
$ /usr/ppr/bin/ppuser authcode ``John Jones'' secret
/etc/ppr/charge_users.db
Exit codes for ppuser are defined in the source code
file ``include/util_exits.h''.
If you choose to compile PPR without GDBM, this program will be
non-functional.
R<ppr(1)>, R<pprd(8)>, ``PPR, a PostScript Print Spooler'', ``Installing and Using PPR''.
PPR was written at Trinity College during 1993, 1994, 1995, and 1996.
It was first released to the public on 26 April 1995.
David Chappell, Trinity College Computing Center, Hartford, Connecticut.