


     AAAAPPPPRRRRIIIINNNNTTTT((((1111MMMM))))                    AAAANNNNNNNNEEEEXXXX                    AAAAPPPPRRRRIIIINNNNTTTT((((1111MMMM))))



     NNNNAAAAMMMMEEEE
          aprint - Annex remote print command

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          aaaapppprrrriiiinnnntttt ----AAAA_a_n_n_e_x [ ----LLLL_l_i_n_e ] | [ ----pppp_p_o_r_t ] [ ----ffffDDDD ] [ ----FFFF_s_t_r_i_n_g ]
          [ _f_i_l_e_s...  ]
          aaaapppprrrriiiinnnntttt [ ----PPPP_p_r_i_n_t_e_r ] [ ----ffff ] [ ----FFFF_s_t_r_i_n_g ] [ _f_i_l_e_s...  ]

     AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
          ----AAAA _a_n_n_e_x     The host name string or Internet address (in
                      standard Internet dot-separated notation) of the
                      Annex on which to print.

          ----LLLL _l_i_n_e      The serial port line number to use for printing
                      on the Annex specified by ----AAAA.  If neither this
                      option nor the ----pppp option are specified, or if a
                      value of 0 is given as the line number, then the
                      parallel port is used.  A value greater than
                      zero specifies a serial port.  This option
                      cannot be used at the same time as the ----pppp
                      option.

          ----pppp _p_o_r_t      The parallel port line number to use for
                      printing on the Annex specified by ----AAAA.  This
                      option cannot be used with the ----LLLL option.

          ----ffff           Prevent _a_p_r_i_n_t from supplying extra form-feeds.

          ----DDDD           Specifies that debug output should be sent to
                      standard output. This option may be repeated for
                      more detailed information. Level 1: Connect
                      acknowledge and per file messages. Level 2:
                      Connect setup details.

          ----FFFF _s_t_r_i_n_g    Use _s_t_r_i_n_g to produce a form-feed instead of
                      the default string of a single ^^^^LLLL.  This will
                      override an ffffffff==== capability read from
                      /_e_t_c/_p_r_i_n_t_c_a_p.  No form-feeds are produced if
                      the ----ffff flag has been given.

          ffffiiiilllleeeessss...    The file(s) to print; if none are specified,
                      then the standard input is used.

          ----PPPP _p_r_i_n_t_e_r   Use _p_r_i_n_t_e_r as the printer name to look up in
                      /_e_t_c/_p_r_i_n_t_c_a_p.  (OBSOLETE)

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          The _a_p_r_i_n_t utility is intended for sites that either do not
          have or cannot modify the Berkeley printer spooler.  It
          sends files directly to a printer attached to an Annex,
          without the use of a spooling mechanism.  _A_p_r_i_n_t supports
          printers connected to either a parallel port or any of an



     Page 1                                         (printed 10/13/98)






     AAAAPPPPRRRRIIIINNNNTTTT((((1111MMMM))))                    AAAANNNNNNNNEEEEXXXX                    AAAAPPPPRRRRIIIINNNNTTTT((((1111MMMM))))



          Annex's serial ports.  The name of the Annex and port to be
          printed on are specified by the ----AAAA and ----LLLL arguments,
          respectively.  To be backward-compatible with old versions
          of _a_p_r_i_n_t, it also supports a ----PPPP argument specifying a
          printer name to be looked up in the /_e_t_c/_p_r_i_n_t_c_a_p file.  The
          ----AAAA and ----PPPP arguments are mutually exclusive.  If neither is
          given, _a_p_r_i_n_t will look up in /_e_t_c/_p_r_i_n_t_c_a_p the printer
          named by either the value of the PRINTER environment
          variable or, if that is not set, the default printer named
          _l_p.

          By default, _a_p_r_i_n_t will print a form-feed at the start of
          every file and at the end of all specified files.  Versions
          of the Annex operational code previous to R3.0 produced
          these form-feeds without a means of disabling them.  Since
          this function should now be produced by host resident
          software, _a_p_r_i_n_t will provide them for backward
          compatibility.  The ----ffff flag will prevent _a_p_r_i_n_t from
          generating these form-feeds.

     FFFFIIIILLLLEEEESSSS
          /etc/printcap  printer capabilities data-base

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          _A_n_n_e_x _N_e_t_w_o_r_k _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e

     DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
          Most messages are self-explanatory, if not overly verbose.

     RRRREEEESSSSTTTTRRRRIIIICCCCTTTTIIIIOOOONNNNSSSS
          Some ports of the Berkeley networking software to System V
          systems do not support out-of-band data (MSG_OOB) on
          sockets.  Since OOB is used in the close handshake of the
          Annex LPD protocol, this handshake will not be used on such
          hosts.  The implication of this is that with two back-to-
          back invocations of _a_p_r_i_n_t , the second can fail because the
          Annex port will still be busy from the first print job.
          This should not be a problem if _a_p_r_i_n_t is invoked from
          within a spooling system (such as System V lp or Berkeley
          LPD).

          Revision R7.0 and later of _a_p_r_i_n_t cannot be used with Annex
          operational code before revision R3.0, because the later
          Annex operational code revisions use a more elaborate Annex
          LPD protocol that provides for acknowledgements from the
          Annex to the host (indicating that the Annex is ready to
          receive data) and from the host to the Annex (marking EOF,
          among other things).  This makes it possible for _a_p_r_i_n_t to
          determine that the Annex has opened the requested serial or
          parallel line sucessfully.





     Page 2                                         (printed 10/13/98)



