home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Netzwerk / port-lpr.lha / lpr.cat < prev    next >
Encoding:
Text File  |  1991-03-22  |  12.5 KB  |  331 lines
  1.  
  2.  
  3.  
  4. LPR(1)                                                     LPR(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        lpr  -  ``standalone''  interface  to a remote BSD printer
  9.        spooler
  10.  
  11. SSYYNNOOPPSSIISS
  12.        llpprr [ --_j_o_b_-_o_p_t_i_o_n ... ] [ --_f_i_l_e_-_o_p_t_i_o_n ...  ]  [  _f_i_l_e_n_a_m_e
  13.        ... ]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        This  version of llpprr is an interface to a remote BSD UNIX-
  17.        style printer spooler that allows a user of a non-BSD UNIX
  18.        system  to  print  files  on printers attached to a server
  19.        that supports the BSD print spooler protocol.
  20.  
  21.        When _f_i_l_e_n_a_m_es are  supplied  on  the  command  line,  llpprr
  22.        prints  the named files.  If no _f_i_l_e_n_a_m_es appear, standard
  23.        input is printed according to the supplied options.
  24.  
  25. EENNVVIIRROONNMMEENNTT
  26.        llpprr requires that the LLPPDD__SSEERRVVEERR environment variable con-
  27.        tain  the  name  of  a  printer  server to which files are
  28.        spooled.  If this variable does not exist, an  error  mes-
  29.        sage is printed.
  30.  
  31. OOPPTTIIOONNSS
  32.        Options fall into two general categories:  job options and
  33.        file options.  The former  class  of  options  affects  an
  34.        entire  print job.  The latter class affects only specific
  35.        files and can be  overriden  for  subsequent  files.   For
  36.        example,  it is possible to print a troff file and a plain
  37.        text file in the same print job.
  38.  
  39.        Options that require arguments can be  specified  with  or
  40.        without intervening space between the option and the argu-
  41.        ment.  Thus, either --PP_p_r_i_n_t_e_r or --PP _p_r_i_n_t_e_r will work.
  42.  
  43.    JJoobb ooppttiioonnss
  44.        These options specify parameters that  affect  the  entire
  45.        print job.  These include:
  46.  
  47.        --CC_j_o_b_c_l_a_s_s     Names  the  job class, which will appear on
  48.                       the job banner page.  By  default  this  is
  49.                       set to the local hostname.
  50.  
  51.        --JJ_j_o_b_t_i_t_l_e     Names  the  job title, which will appear on
  52.                       the  job  banner  page  when  printed.   By
  53.                       default  this is the name of the first file
  54.                       named on the command line.
  55.  
  56.        --hh             Tells the printer server to not  print  the
  57.                       banner page.
  58.  
  59.        --mm             When  the  print  job  completes,  have the
  60.                       printer server send a mail message  to  the
  61.  
  62.  
  63.  
  64.                           21 March 1991                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LPR(1)                                                     LPR(1)
  71.  
  72.  
  73.                       person   who   submitted   the  job.   This
  74.                       requires  that  your  machine  be  able  to
  75.                       receive   mail   addressed   to  _y_o_u_r_-_u_s_e_r_-
  76.                       _n_a_m_e@_y_o_u_r_-_h_o_s_t_-_n_a_m_e  and  that  the   print
  77.                       server be able to get it there.
  78.  
  79.        --PP_p_r_i_n_t_e_r      specifies   to   which  printer  (of  those
  80.                       attached to the printer server) output will
  81.                       be sent.
  82.  
  83.        --qq_p_r_i_n_t_e_r      The  --qq  option  is  synonymous with the --PP
  84.                       option.
  85.  
  86.        --ddeebbuugg         Show messages sent to and from  the  server
  87.                       on  the standard error output.  Not for the
  88.                       faint-of-heart.
  89.  
  90.    FFiillee ooppttiioonnss
  91.        These options specify parameters that  are  particular  to
  92.        one  or  more  of  the files to be printed.  These options
  93.        pertain to any files that  appear  to  the  right  of  the
  94.        option  on  the command line, but they may be overriden by
  95.        specifing a different option between files.
  96.  
  97.        Only one of the file-type options (--dd, --ff, --gg, --ll, --nn, --oo,
  98.        --pp,  --rr,  --tt, and --gg) apply to any given file.  Subsequent
  99.        use of any of these options specifies  the  type  of  each
  100.        file  that  appears  to  the  right  of  the option, until
  101.        another file-type option appears.
  102.  
  103.        In the absence of any file-type options, llpprr tries to fig-
  104.        ure  out  what kind of file is to be printed.  It can cur-
  105.        rently recognize TEX DVI files, as well as C/A/T  (``clas-
  106.        sic'')  ttrrooffff(1)  and PostScript files.  If the particular
  107.        kind of file is not recognized, llpprr assumes the file is an
  108.        ordinary text file.
  109.  
  110.        --##_n_u_m_b_e_r       Specifies the number of copies of each file
  111.                       to print.  Default is to print one copy  of
  112.                       each file.
  113.  
  114.        --dd             Files  that  follow this option are device-
  115.                       independent (DVI) files such  as  might  be
  116.                       produced by TEX.
  117.  
  118.        --ff             Files  that follow this option are ordinary
  119.                       plain text files.  The spooler  may  expand
  120.                       tabs, insert page breaks, etc., in order to
  121.                       print the files.
  122.  
  123.        --gg             Files that follow this option are  expected
  124.                       to be in V7 UNIX pplloott(5) format.  (Very few
  125.                       spoolers support this format.)
  126.  
  127.  
  128.  
  129.  
  130.                           21 March 1991                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LPR(1)                                                     LPR(1)
  137.  
  138.  
  139.        --ll             Files that follow this option are  ordinary
  140.                       text  files, but which may contain embedded
  141.                       control characters.  (Some printer spoolers
  142.                       reject files which contain too many control
  143.                       characters; this option overrides that fea-
  144.                       ture in order to allow users to make use of
  145.                       printer specific features that require  use
  146.                       of non-printable characters.)
  147.  
  148.        --nn             Tells   llpprr  to  expect  files  in  device-
  149.                       independent troff (ddiittrrooffff) format.   (Many
  150.                       spoolers do not support this format.)
  151.  
  152.        --oo             Tells llpprr to expect PostScript files.  This
  153.                       generally requires that the printer  itself
  154.                       speak    PostScript.    Furthermore,   many
  155.                       printer spoolers do not  grok  --oo,  but  do
  156.                       accept PostScript files submitted as ``nor-
  157.                       mal  text''  files,  interpreting  them  as
  158.                       PostScript  programs  rather  than ordinary
  159.                       text files.
  160.  
  161.        --pp             Tells llpprr that subsequent files  are  ordi-
  162.                       nary  text  files,  which should be printed
  163.                       with page breaks and headers.
  164.  
  165.        --rr             Tells llpprr to expect files in FORTRAN output
  166.                       format,  where  the first character of each
  167.                       line determines how to handle the ``printer
  168.                       carraige''  after  each  line  (SSPPAACCEE=go to
  169.                       next line, ``++''=overprint, etc.)
  170.  
  171.        --tt             Tells llpprr to expect files generated  for  a
  172.                       C/A/T  phototypesetter,  such as are gener-
  173.                       ated by old or ``classic'' ttrrooffff.
  174.  
  175.        --vv             Tells llpprr to expect Versatec  raster-format
  176.                       files,  or  files  in  the printer's native
  177.                       format, whatever that is.
  178.  
  179. DDIIAAGGNNOOSSTTIICCSS
  180.        LLPPDD__SSEERRVVEERR eennvviirroonnmmeenntt vvaarriiaabbllee iiss nnoott sseett
  181.             The environment variable LLPPDD__SSEERRVVEERR must  be  set  to
  182.             the name of the printer server.
  183.  
  184.        bbiinndd:: ccaannnnoott bbiinndd ttoo pprriivviilleeggeedd ppoorrtt
  185.             Either  no  privileged  ports  are  available (highly
  186.             unlikely), or llpprr is not installed set-uid  to  root.
  187.             Tell  your  system  manager  to read the installation
  188.             instructions again.
  189.  
  190.        ccaann''tt ffiinndd nneettwwoorrkk aaddddrreessss ffoorr _s_e_r_v_e_r
  191.             An attempt to determine the network  address  of  the
  192.             printer  server failed.  The server must be listed in
  193.  
  194.  
  195.  
  196.                           21 March 1991                         3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LPR(1)                                                     LPR(1)
  203.  
  204.  
  205.             the Internet name server,  your  system's  //eettcc//hhoossttss
  206.             file,  or  in  the  NIS  hosts database, depending on
  207.             which mechanism your system uses for translating host
  208.             names to network addresses.
  209.  
  210.        _f_i_l_e_n_a_m_e iiss aa PPoossttSSccrriipptt ((ttmm)) ffiillee,, aassssuummiinngg --ff
  211.             The  named  file begins with ``%%!!''  and is therefore
  212.             assumed to be a PostScript file.
  213.  
  214.        _f_i_l_e_n_a_m_e iiss aa TTeeXX ..ddvvii ffiillee,, aassssuummiinngg --dd
  215.             The named file begins and ends with the magic numbers
  216.             used  by  TEX DVI files, and will therefore be inter-
  217.             preted as such instead  of  spewing  garbage  to  the
  218.             printer.
  219.  
  220.        _f_i_l_e_n_a_m_e iiss aa CC//AA//TT ttrrooffff oouuttppuutt ffiillee,, aassssuummiinngg --tt
  221.             The  file  begins with the magic number used by C/A/T
  222.             (``classic'') ttrrooffff(1), and will therefore be  inter-
  223.             preted as such.
  224.  
  225.        _f_i_l_e_n_a_m_e iiss aa UUNNIIXX lliibbrraarryy aarrcchhiivvee ---- iiggnnoorriinngg iitt
  226.             llpprr  refuses  to  print  library archive files, since
  227.             these usually contain non-printable data.
  228.  
  229.        _f_i_l_e_n_a_m_e iiss aa ccoommpprreesssseedd ffiillee ---- iiggnnoorriinngg iitt
  230.             The named file has been compressed with  ccoommpprreessss(1),
  231.             and  cannot  be  directly printed by llpprr.  Either use
  232.             uunnccoommpprreessss(1) to restore the original file,  or  pipe
  233.             the file through zzccaatt(1).
  234.  
  235.        sskkiippppiinngg zzeerroo lleennggtthh ffiillee _f_i_l_e_n_a_m_e
  236.             llpprr  optimizes the printing of an empty file by skip-
  237.             ping the file entirely,  thus  saving  trees  by  not
  238.             printing unwanted banner pages.
  239.  
  240.        _f_i_l_e_n_a_m_e iiss nnoott aa vvaalliidd ..ddvvii ffiillee
  241.             The  --dd  option  was specified, but the named file is
  242.             not in DVI format.
  243.  
  244. BBUUGGSS
  245.        There is currently no way to delete a print job (analogous
  246.        to  the BSD llpprrmm command), nor to inquire on the status of
  247.        the print queue (analogus to the BSD llppqq command).
  248.  
  249.        The protocol used by llpprr requires that it know  the  exact
  250.        size of a file before sending it to the print spooler.  In
  251.        order to compute the size of  a  file  piped  to  standard
  252.        input, and in order to work on non-UNIX systems which can-
  253.        not determine the exact size of a  file,  llpprr  reads  each
  254.        file  into  memory  (counting the bytes as it goes) before
  255.        sending it to the spooler.  Therefore, files  larger  than
  256.        available memory cannot be printed.
  257.  
  258.        Not  all  printers  or  spoolers  support  all file types.
  259.  
  260.  
  261.  
  262.                           21 March 1991                         4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. LPR(1)                                                     LPR(1)
  269.  
  270.  
  271.        There is no agreement among the various spoolers as to how
  272.        to treat the --vv file type.
  273.  
  274.        The  --TT,  --ii,  --ss,  and --ww options of BSD llpprr are not sup-
  275.        ported.
  276.  
  277. SSEEEE AALLSSOO
  278.        _L_i_n_e _p_r_i_n_t_e_r _d_a_e_m_o_n _p_r_o_t_o_c_o_l_, _R_F_C_1_1_7_9_.
  279.  
  280.        Documentation for the printer spooler you are  using.   On
  281.        BSD  UNIX  and  some  other systems, see the man pages for
  282.        llppqq(1), llpprrmm(1), llppcc(8), and llppdd(8).
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                           21 March 1991                         5
  329.  
  330.  
  331.