Administration Guide : Command-line manual pages

SPOOLSERV(8) manual page

Name

spoolserv - a print queue information daemon

Synopsis

spoolserv [ -D ] [ -d lev ] [ -a ] [ -p port ] [ -u user ] [ -g group ] [ -m archdir ] [ -f freq ] [ -k days ]

Description

spoolserv responds to queries via its own protocol used to monitor and manipulate print queues. Currently the only client application is the Xinet Administrative GUI, which allows administrators (and users with print admin privileges) to check on jobs, move them between print queues, and remove jobs.

The -a -u and -g options control administrator access. Administrator access allows users to manipulate jobs that they did not queue, as well as start and stop the queues. If the -a option is given, all users have administrator access. If the -u option is given, the specified user can become administrator. With -g all members of the specified group can become administrator. With -u and -g the user is required to type their password to gain access. Typing the root password will always work. These options can be manipulated from the xktalk GUI.

By default spoolserv accepts connections via Appletalk and via IP by listening on UDP port 5970. The -p option allows spoolserv to listen on a different UDP port than the default. If a different port is used Queue Master (obsolete) connections that are initiated by hand will need to append the port number in the specified address using the host:port notation.

Another task spoolserv handles is archiving printer accounting files. Without both the -m and -f options, it does nothing to printer accounting files. With those two options, the accounting files for all printers with accounting enabled are merged and copied to archdir either daily, weekly or monthly, given freq values of 1, 2 or 3, respectively. The printer accounting files are truncated after being copied. The -k option gives the number of days that the merged accounting files should be kept. The default for days is 62. Archive files older than the given day limit are removed.

If the -D option is used, spoolserv stays in the foreground and prints debugging information about activity. With -d, the user can control which messages are printed.

Files

/etc/printcap    
Printer information
/usr/etc/appletalk/spoolserv    
The binary.
/usr/etc/appletalk/services    
Control file that starts spoolserv, and holds the spooler configuration.