ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



ATPRINT(1)                                                                                        ATPRINT(1)



NAME
       atprint - transfer data to a printer using AppleTalk protocols

SYNOPSIS
       atprint [ printer-name [: printer-type [@ zone ] ] ]

ARGUMENTS
       printer-name
               Specifies the name of the printer you want to use.

       printer-type
               Specifies  the type of printer, such as LaserWriter or ImageWriter.  Use this option when you
               want to allow the network to select the printer, but only a printer of a given type.  If  you
               omit this option, LaserWriter is the printer type used by default.

               For  example,  when  the  printer  name is specified with wildcards.  (See atlookup(1) for an
               explanation of wildcards.)  The print device used is the one chosen by the network.  By  sup-plying supplying
               plying  LaserWriter  as the printer type in a case such as this, you can restrict the network
               to choosing a printer that can handle PostScript instructions.

               The full range of possible replacement values for printer-type depends on  the  configuration
               of your network. Each different type of print device broadcasts its printer-type and printer-name printername
               name identification when it registers itself with the network. You can use atlookup to obtain
               a  report  showing  this  information  for  all  the  AppleTalk  devices on your network (see
               atlookup(1)).

       zone    Specifies the AppleTalk zone in which the printer resides.  If  you  omit  this  argument  or
               specify it as *, the local zone is used.

DESCRIPTION
       atprint  uses  a  printing  protocol to establish a connection to an AppleTalk device, where it sends
       data received on its standard input until it reaches an end-of-file character.  When  it  detects  an
       end-of-file  character, atprint closes the AppleTalk session with the device, enabling other users to
       gain access to the printer.

       You can select the destination AppleTalk device through the command-line arguments  as  described  in
       the ``Arguments'' section earlier in this manual page.  If you do not specify any of these arguments,
       atprint uses the printer that was last selected with the at_cho_prn command (see at_cho_prn(1)).

       Often the printer you access by way of an AppleTalk connection is a  LaserWriter.   Many  LaserWriter
       models  are  PostScript printers. If you are using such a LaserWriter, the data that you send it must
       already be translated into the PostScript page-description language. For example, the  enscript  com-mand command
       mand translates the output from troff (invoked with the -Tpsc option) into PostScript:

               troff -Tpsc -mm file | enscript -p- | atprint

       The  atprint  command  displays one or more messages indicating the AppleTalk device with which it is
       communicating and possibly many device status messages (such as when another print job  is  occupying
       the  printer for a period of time).  In the preceding example, the default printer is used.  (See the
       ``Arguments'' section earlier in this manual page.)

       (Note that the atprint command does not honor requests from a LaserWriter regarding  the  downloading
       of fonts.  Likewise, it does not prepend a PostScript header to the data stream in the same manner as
       the printer drivers in the Macintosh Operating System.  In the preceding example, a PostScript header
       is  still  provided  because  enscript  prepends  its own header as part of the PostScript conversion
       process.)

       In AppleTalk programming terms, the arguments make up a network-visible entity (NVE), where

               printer-name[:printer-type[@zone]]

       corresponds to the AppleTalk object, type, and zone:

               object:type@zone


EXAMPLES
       This command line maps a plain text file into PostScript and then submits it to joe's printer:

               enscript -p- file | atprint "joe's printer"


WARNINGS
       The atprint command does not process the input files as does lpr.  To print ASCII files properly on a
       PostScript  printer  with  atprint, you must preprocess the files with pstext or enscript.  Likewise,
       you must preprocess files produced by troff with enscript(1).


FILES
       /usr/bin/atprint Executable file


SEE ALSO
       at_cho_prn(1), atlookup(1), atstatus(1), enscript(1), lpr(1)



                                                                                                  ATPRINT(1)

Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.