home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / PRINTING / LPR_LPQ3.ZIP / LPR.MAN < prev    next >
Text File  |  1989-10-14  |  4KB  |  75 lines
  1. NAME 
  2.      lpr - insert files or standard input into queue for background printing
  3.  
  4. SYNOPSIS 
  5.      command | lpr
  6.      lpr [-v] [-h] [file  [-]...] [ < file ]
  7.  
  8. DESCRIPTION 
  9.          LPR interprets the command line arguments as files to be passed to
  10.      the print queue maintained by the DOS PRINT background printing
  11.      utility.  Normal DOS wildcards may be specified, and "/" may be used as
  12.      a directory separator in addition to "\".  The argument "-" is taken to
  13.      be standard input (if redirected or piped) and is processed as a file
  14.      argument at the appropriate point. If no file arguments are specified,
  15.      stdin is assumed.  Standard input is handled by copying (text mode,
  16.      stops at ^Z) to a temporary file with a name mask LPR???.$$$ created in
  17.      a spool directory. This spool file is then passed to the print queue.
  18.      This allows a print process to be the last stage in a pipeline, and
  19.      still use the background printing services.  The location of the spool
  20.      files may be specified by the environment variable SPOOLDIR.  The
  21.      default is C:\SPOOL.  If an alternate drive is specified, the root
  22.      directory must be explicitly given, e.g. for a ramdrive E: set
  23.      spooldir=E:\
  24.  
  25.         When LPR processes stdin, it checks the contents of the spool
  26.      directory for files matching the mask "LPR???.$$$", and also the
  27.      print queue. Any old spool files not currently in the spool queue are
  28.      automatically deleted.  A trailing formfeed in the input file is NOT
  29.      copied over, since PRINT will add a formfeed after each file.  Apart
  30.      from this, LPR does not examine the input file.
  31.  
  32.         Lpr checks for the existance of the print spooler in memory before
  33.      attempting to pass files to it. Lpr will not print empty
  34.      files, or read input directly from the terminal.
  35.  
  36.          Lpr communicates directly with PRINT via the DOS TSR multiplex
  37.      interrupt 2F.  This is documented for DOS 3.x and above. Calls to 
  38.      lpr may be freely mixed with calls to PRINT.
  39.  
  40. OPTIONS
  41.     -v  verbose mode - lpr is more chatty about files added to the queue.
  42.          Errors such as invalid file name, print queue full or spool
  43.          directory full, are always displayed.
  44.     -h  help - displays the copyright and usage messages and quits.
  45.     -p  priority - place job(s) at the head of the print queue.
  46.  
  47. RETURN CODE
  48.      0 - no errors
  49.      1 - any errors in argument list
  50.      2 - PRINT.COM not loaded, no further processing possible
  51.  
  52. FILES
  53.      $SPOOLDIR/lpr???.$$$  - spool files
  54.  
  55.      $SPOOLDIR - environment variable indicating where to place the
  56.      spool files.  The default is C:\SPOOL.
  57.  
  58. SEE ALSO
  59.      lpq, MS-DOS manual entry for PRINT. Note in particular that the size
  60.      of the print queue may be specified at load time with /Q:nn where nn
  61.      may be in range 4-32 (default is 10).
  62.  
  63. BUGS
  64.      The files are truncated at the first Control-Z (i.e. DOS ASCII mode),
  65.      since PRINT will not handle characters beyond ^Z.  As far as I know the
  66.      only way to get such a file to the printer is to open PRN directly in      binary mode, or with COPY /B file PRN
  67.  
  68. REVISONS
  69.      V 1.1 - fixed bug with specifying files in the root directory, or in
  70.      the current (unspecified) directory of an alternate drive.  Also
  71.      allowed for "/" in pathnames, and for "." and ".." in filespecs.
  72.  
  73. AUTHOR
  74.      Richard Brittain (richard@calvin.spp.cornell.edu)
  75.