Administration Guide : Command-line manual pages

PAPSERVER(8) manual page

Name

papserver - spool files from network-connected Macintoshes

Synopsis

/usr/etc/appletalk/papserver [-T type ] [-Z zone ] [-D ] [-B ] [-I ] [-X ] [-K ] [-L ] [-M ]
[-n ] [-R ] [-F ] [-U ] [-C dir ] [-P ppd ] [-E program] [-O option]
[-o OPIoptions] spooler-name printcap-entry

Description

The papserver program is a server which emulates a LaserWriter. It registers itself on the network as a Laserwriter, accepts print requests from Macintoshes and other machines, and spools them for printing. The papserver is an implementation of the server side of the AppleTalk Printer Access Protocol (PAP). It communicates with the LaserWriter driver on the Macintosh, and answers printer queries. It will collect and cache dictionaries, so they do not have to be retransmitted. Papserver will also parse a PPD (PostScript Printer Description) file and return information about the device to the Macintosh printer driver.

-D
turns on debugging and prevents the papserver from backgrounding itself.
-B
causes papserver to convert 8-bit characters to their 7-bit equivalents. This option should be used if your job will pass through any program or device that cannot handle 8-bit characters. It should be used if you are connecting to a TranScript queue. The -B option is not necessary if you are using psf as your output driver.
-I
causes all dictionaries that are needed by the job to be pre-pended to the job. This is useful for printing to devices that do not store dictionaries, such as software PostScript interpreters. The -I option is unnecessary if you are using the psf program as your output program, as psf will check that the correct dictionary versions are loaded before it sends the job.
-X
causes exitserver commands to be removed from dictionaries before they are pre-pended to the job. This option only has an effect if you are using the -I option. Some RIPs (most notably NewsPrint) cannot process exitserver commands.
-K
Will include information in job and class names that can be interpreted by psf(8) . This will give strange job names if used on printers that do not use psf as the output driver. This information enables more features in QueueMaster.
-L
makes papserver call lp rather than lpr on systems where lpr is the default (SGI and SUN). This option is useful only on SGI machines (where the lp and lpr systems both exist), and the user wants to route the jobs through lp.
-M
make papserver accept input from the Microspot MacPlot driver for the Macintosh. This changes the default type to "Plotter" and expects that the input will be HPGL, which will be passed through unchanged.
-n
makes papserver attempt to translate carriage returns to newlines. This makes the postscript files generated easilly readable on the UNIX machine. This option should not be used with level 2 devices, as bitmaps will be corrupted. It is never necessary if FullPress is driving the printer.
-R
makes papserver pass all PostScript through to the program being executed, including queries. The program must be a RIP capable of answering PostScript queries correctly.
-F
adds support for FlexFax. If a PostScript fax is detected, it will call /usr/local/bin/sendfax with the correct arguments.
-U
turns off the feature of changing UIDs to the owner of the print job (if it's possible to figure out) before running program .
-C
causes papserver to change directory to dir rather than the spool directory of the printer. When you are calling a program or spooling to a remote printer that does not have a defined spool directory, this option can be used to tell papserver where to look for the ppd file.
-P
gives the ppd file name. The default is PRINTER.PPD in the current directory.
-E
and the specified program causes papserver to fork program rather than lpr(1) (or lp(1) ). All -O options are also passed on to program , which must accept the PostScript job via standard input. The program can send status on standard output and errors on standard error, both of which are reported back to the Mac.
-O
and the specified option causes lpr(1) or lp(1) to be invoked with the argument option . Up to 10 -O options may be specified; they will be passed on in the same order they are specified. Illegal options may cause lpr(1) or lp(1) to fail. The -O option is usually used for devices which require special arguments to print PostScript.
-o
uses the specified OPIoptions as directives for OPI picture replacement in the print job (for FullPress users only). The options are like printcap(5) , a sequence of colon-separated, keyname =value items, where each keyname is 2 letters. There are only two keynames that papserver pays attention to. The first, eo, if present, tells papserver to perform the OPI replacement before handing the job to a printer. The second, rp, is the resolution at which to replace pictures. If the value of rp is ppd, papserver will replace it with the printer's resolution from the PPD file; otherwise this option is also passed through the print job.

Normally, papserver is invoked with two arguments, the spooler's AppleTalk name and the target name of the printer to which it will forward jobs. If only one argument is given, it is assumed to be the name of the printer to which it ought to spool. In this case, the last of the nicknames in the printcap(5) file with the string `` Spooler'' appended is used as the spooler's AppleTalk name.

Papserver is usually started by atinit(8) . If psf(8) is being used as the output filter, it will generate a PRINTER.PPD file by querying the printer if one does not exist. Otherwise, the user is responsible for ensuring that a reasonable PRINTER.PPD file is available in the printer's spool directory.

Files

spoold /printer /PRINTER.PPD    
PostScript Printer Description file
/usr/adm/appletalk/psfiles    
directory where dictionaries are cached.

See Also

atinit(8) , FullPress Administrator's Guide