AppleTalkPrinting(1)

NAME
lwpr, iwpr, tlw, papif, lwsrv, isrv - UNIX access to AppleTalk printers and UNIX print spoolers for AppleTalk

DESCRIPTION
The Columbia AppleTalk Package (CAP) allows UNIX programs to print to printers connected to the AppleTalk network, or to act as print spoolers for Macintosh computers on the AppleTalk network. The four sample programs lwpr, iwpr, tlw, isrv, are distributed as part of CAP to illustrate this printer access and are documented here. The two production applications papif and lwsrv distributed in CAP for LaserWriter printing and spooling are documented in their own manual entries.

lwpr is the simplest program of the bunch. It allows one to send a single PostScript file directly to a LaserWriter, as a networked Macintosh would. The syntax is simply lwpr -p lwname filename The -p lwname option specifies the name of the LaserWriter, which should be the fully qualified network name, e.g. "LaserWriter:LaserWriter@MYZONE". If you have your PRINTER environment variable set to a printer that maps to a LaserWriter (via cap.printers), then you may omit the "-p" option. lwpr runs in the foreground, establishing a connection to the LaserWriter and then sending the file.

iwpr functions exactly the same way as lwpr, except that it expects to send a properly formatted file to an Appletalk ImageWriter II, e.g. "A-TALK:ImageWriter@MYZONE".

tlw allows you to communicate with the interactive executive on a networked PostScript device. You can specify the device in one of three ways (-a is the default). "tlw -u <short-printer-name>" maps a Unix short printer name to an Appletalk entity name via the cap.printers file (often found in /etc). "tlw -a <object-name>" specifies a device of type "LaserWriter" in the current zone "*". "tlw -a <appletalk-entity>" lets you choose an arbitrary object, type and zone, e.g. "tlw -a frobozz:LaserShare@zork". You can terminate the conversation with an EOF signal (normally CTRL-D).

isrv is designed to run as a background daemon process that advertises itself on the AppleTalk network as an ImageWriter II printer and accepts print jobs from Macintosh computers, which it then sends to a normal UNIX printer queue connected to a real ImageWriter II. isrv is invoked as isrv -P <printer name> -T <base model> [-d <debug flags>] where <printer name> is the name of the UNIX printer queue connected to the real ImageWriter; the <base model> must be "ImageWriter"; and the optional -d <debug flags> argument can be used to specify standard CAP debugging flags (see CAP(3)). If debug flags are specified, isrv will stay in the foreground to log debug messages to standard output. Otherwise, it will put itself into the background to run as a daemon.

NOTES
isrv is incredibly slow. We do not recommend the use of AppleTalk ImageWriters outside of an AppleTalk network (e.g. use it on a single cable only). It is included because it was written before we realized how bad the overhead was.

lsrv, lwsrv, and papif were previously documented here. lsrv has been removed from the distribution. lwsrv and papif are now documented separately.

BUGS
There are bound to be several.

FILES
/etc/cap.printers - papif configuation file to associate UNIX printer queues with LaserWriter names. Location may vary according to local option.

AUTHOR
lwpr, iwpr, tlw and isrv were written by Charlie C. Kim of Columbia University.

SEE ALSO
CAP(3), CAP(8), atis(8), lwsrv(8), papif(8)