papsrv.conf.5


NAME

papsrv.conf - Macintosh printer server configuration file.


DESCRIPTION

This is a description of the format the the configuration file for the PPR Macintosh print server. The default Papsrv configuration file is /etc/ppr/papsrv.conf.

Each record in the configuration file represents an AppleTalk name which will appear in the Macintosh Chooser. Each record consists of a sequence of lines seperated from the other records by one or more blank lines. Lines begining with ``#'' or ``;'' are comments and do not count as blank lines. (All comments must begin with a ``#'' or ``;'' in the first column, comments at the ends of lines are not allowed.) Each line of a record consists of a keyword followed by a colon, at least one space and a parameter. Only the PPRname: and PAPname: lines are required except when the parameter to PPRname: refers to a group whose members do not all use the same PPD file, in which case the PPDfile: line is also required.

Configuration File Lines

PPRname: destination
specifies the PPR destination to which the print jobs should be sent. It is permissible for different records to have identical PPRname: lines. This line must be the first line of the record.

PAPname: choosername
specifies the name which should appear in the chooser. Generally this will be a simple name which may be up to 32 characters long and should not contain ``:'' or ``@''. Embedded spaces are permitted. For example: "My Favorite Printer".

By default, the name will be advertised with the type ``LaserWriter''. If for some odd reason you wish the entity to have a different type, you may specify the type by appending a colon (``:'') and the type name to the simple name. For example: ``My Favorite Printer:SecretWriter''. A type designation is limited to 32 characters.

If the AppleTalk implementation you are using permits advertising in multiple zones (Netatalk does), you may specify a zone by appending a comercial at sign (``@'') and the zone name. (If an entity type designation is also present, the at sign and the zone name should come after it.) For example: ``My Favorite Printer@Computing Center'' or "My Favorite Printer:SecretWriter@Computing Center".

PPDfile: filename
indicates the PPD files which should be used to answer queries about the printer. If filename does not begin with a slash it is relative to /usr/ppr/PPDFiles. The PPDfile: line is required for groups of printers whose members do not all use the same PPD file, it is forbidden under all other circumstances. If you think you should be allowed to specify a PPD file under all circumstances, keep reading, other lines can be used to accomplish everthing you could accomplish with a hacked PPD file.

PPRparms: parm1 ... parmN
Specifies a list of parameters to be added at the end of the ppr(1) command line when ppr is invoked to accept a print job. The parameters should be seperated by spaces. Parameters with embedded spaces must be enclosed in single or double quotes. Environment variable expansion and other shell features are not supported. The backslash character has no special significance in the current implementation.

It might be useful to include the -I switch in this line so that the default switchset attached to the printer or group will be used.

ForceAUFSSecurity: boolean
If boolean is true, CAP AUFS security is enabled for this shared printer name even if the printer named in the PPRname: line is not protected. This option may not be set to true unless an -X switch is used when starting papsrv. For furthur information, see the discussion of the -X switch in papsrv(8).

Product: (string)
specifies a product string to be used in answering product queries instead of the product string in the PPD file. The parameter should be in the format of the ``*Product:'' line in a PPD file, in other words, the parentheses must be present for correct results. It is conceivable that you might wish to use this line to cause LaserWriter 8.x to select a special PPD file when its auto setup feature is invoked.

TTRasterizer: string
overrides the ``*TTRasterizer:'' line in the PPD file for the purpose of answering queryies. Legal values are ``None'', ``Type42'', and ``Accept68K''. This might be useful because so many PPD files were written before the ``*TTRasterizer:'' line was introduced in version 4.1 or the PPD file specification.

Configuration File Lines of Doubtful Utility

BinaryOK: boolean
Specifies an answer for the LaserWriter 8 query of the same name. If a record does not have a BinaryOK: line, then papsrv will return the default answer which is supplied by LaserWriter 8 when it makes the query. (That default answer is false.)

FaxSupport: string
supplies an answer to the fax support feature query, overriding any ``*FaxSupport:'' line in the PPD file. Currently the only official value for string is ``Base''. If the printer does not offer fax support, you should ommit this line.

LanguageLevel: positive integer
Specifies a language level to be used in answers to language level queries. If present, this line overrides the language level specified in the printer's or group's PPD file. At the time of this writing, the only reasonable values for this parameter are ``1'' and ``2''.

PSVersion: string
Supplies a PostScript version string to use instead of the one in the PPD file when answering queries about the printer. The string should be in the format of the ``*PSVersion:'' line in a PPD file. For example, "(52.3) 400" (without the quotes).

RamSize: number
Supplies an answer for the LaserWriter 8.x ``ADORamSize'' query. For example, if the printer has 2 megabytes of memory, this parameter should be set to 2097152, for 4 megabytes 4194304, etc. It appears that LaserWriter 8.x simply displays this value in one of the setup screens and makes no furthur use of it.

Resolution: string
overrides the ``*DefaultResolution:'' line in the PPD file for purpose of answering queries. The string must be in the form ``300dpi'' or ``1200x400dpi'' (both without the quotes).


EXAMPLES

To share a printer called ``myprn'', we might make an entry like this one:

CTo create a second name for myprn which prints booklets, add this record to the papsrv configuration file:

CAdditional examples may be found in the document ``Installing and Using PPR''.


DIAGNOSTICS

Errors in this file will become evident when papsrv is restarted. By default, the error messages will be written into the log file /var/spool/ppr/logs/papsrv. This file should be examined after restarting papsrv if any changes to /etc/ppr/papsrv.conf have been made.


SEE ALSO

papsrv(8), ppad(8), ``PPR, a PostScript Print Spooler'', ``Installing and Using PPR''.


HISTORY

PPR was written at Trinity College during 1993--1997.


AUTHOR

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