NAME

ppuser - PPR user database management utility

SYNOPSIS

ppuser [subcommand] [parameters ... ]

DESCRIPTION

This program is used to manage PPR user charge accounts. Ordinary users may run the ppuser show subcommand. All other subcommands require that the user be ``root'', ``ppr'', or be listed in /etc/ppr/acl/ppuser.allow.

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 ppr in the ppr.1 manpage -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.

EXAMPLES

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/lib/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/lib/ppr/bin/ppuser add jjones "John Jones" 10.00 -2.50 365

To set his password to ``secret'':

$ /usr/lib/ppr/bin/ppuser authcode "John Jones" secret

FILES

The user account database is kept in the file ``/etc/ppr/charge_users.db''.

If the file ``/var/spool/ppr/logs/ppuser'' exists and is writable by the user ``ppr'', then all ppuser commands are logged there.

DIAGNOSTICS

Exit codes for ppuser are defined in the source code file ``include/util_exits.h''.

BUGS

If you choose to compile PPR without GDBM, this program will be non-functional.

SEE ALSO

the ppr.1 manpage, the pprd.8 manpage, ``PPR, a PostScript Print Spooler'', ``Installing and Using PPR''.

HISTORY

PPR was written at Trinity College during 1993--2003. It was first released to the public on 26 April 1995.

AUTHOR

David Chappell, Trinity College Computing Center, Hartford, Connecticut.