NAME

papd - New AppleTalk Printer Access Protocol Server


SYNOPSIS

papd [--help] [--version] [--foreground] [--stop] [--reload] [--debug-toggle] [--tail]


DESCRIPTION

This program is PPR's new and unfinished AppleTalk Printer Access Protocol (PAP) server. The options are as follows:

--help
Print a short summary of the options.

--version
Print the PPR version number and revision date.

--foreground
Run as a server, but don't attempt to run in the background. Output which would ordinarily go to the log file will go to stderr instead.

--stop
Stop any previously started instance of papd which may be running as a server.

--reload
Re-examine the alias, group, and printer configuration files and unadvertise names which are no longer called for and advertise any new ones. On Linux 2.4.19 and later (with a sufficiently recent version of Glibc) this will happen automatically.

--debug-toggle
Sends a signal the copy of papd which is running as a daemon instructing to alter its debug level.

--tail
Display the end of the papd log file and print new lines as they are added.

By default, queues are not shared using AppleTalk. To share a queue, you must assign it an AppleTalk name. The name is stored in the queue's configuration file as an add-on parameter. You can do that with the ppad addon command. For example:

        $ ppad addon myprn papname "My Printer"

There is a log file which papd creates. It is /var/spool/ppr/logs/papd. Now use this handy command to look at the end of of the log:

        $ papd --tail
        
If you are running Linux, within a few seconds of setting or changing
B<papname> you should see messages 
indicating that B<papd> is rescanning its queue configuration files
and making any necessary adjustments.  These adjustments should be visible
on the AppleTalk network within a few seconds.  If B<papd> doesn't 
reload its configuration files, that may means that it can't automatically
detect configuration changes.  In that case you can prompt it to reload,
like so:
        $ papd --reload
        Sending Hangup to papd (PID=31791).

If you check the log again, you should see that it is reloading the configuration.

To change the queues PAP name, simply set a new one. When papd reloads, the old name one will be removed and the new one added.

        $ ppad addon myprn papname "Printer on David's Desk"

To remove the name, simply set the papname parameter but leave off the value, like so:

        $ ppad addon myprn papname

If necessary, tell papd to reload. If you look /var/spool/ppr/logs/papd, you will see that papd has rescanned the queue configuration files and that this time the papname add-on parameter is absent, so the name was removed from the network.

Sharing aliases and groups is quite simple. One simply uses the ppad commands for setting alias and group add-on parameters:

        $ ppad group addon mygroup papname "My Group"
        $ ppad alias addon myalias papname "My Alias"


FILES

This program reads the [papd] section in /etc/ppr/ppr.conf. It also reads the alias, group, and printer configuration files in /etc/ppr/aliases, /etc/ppr/groups, and /etc/ppr/printers respectively. The daemon's PID is stored in /var/spool/ppr/run/papd.pid. Its actions are logged in /var/spool/ppr/logs/papd.


SEE ALSO

``PPR, a PostScript Print Spooler''


HISTORY

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


AUTHOR

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