usr.sbin/lpr/lp/lp.1

   1 .\"
   2 .\" Copyright (c) 1995 Joerg Wunsch
   3 .\"
   4 .\" All rights reserved.
   5 .\"
   6 .\" This program is free software.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. All advertising materials mentioning features or use of this software
  17 .\"    must display the following acknowledgement:
  18 .\"     This product includes software developed by Joerg Wunsch
  19 .\" 4. The name of the developer may not be used to endorse or promote
  20 .\"    products derived from this software without specific prior written
  21 .\"    permission.
  22 .\"
  23 .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
  24 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  25 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  26 .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
  27 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  28 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  29 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  30 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  31 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  32 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  33 .\"
  34 .\" $FreeBSD: src/usr.sbin/lpr/lp/lp.1,v 1.12.2.4 2002/06/21 16:40:43 charnier Exp $
  35 .\" $DragonFly: src/usr.sbin/lpr/lp/lp.1,v 1.2 2003/06/17 04:29:56 dillon Exp $
  36 .\"
  37 .Dd January 22, 1995
  38 .Dt LP 1
  39 .Os
  40 .Sh NAME
  41 .Nm lp
  42 .Nd front-end to the print spooler
  43 .Sh SYNOPSIS
  44 .Nm
  45 .Op Fl cs
  46 .Op Fl o Ar option
  47 .Op Fl d Ar printer
  48 .Op Fl n Ar num
  49 .Op Ar name ...
  50 .Sh DESCRIPTION
  51 The
  52 .Nm
  53 utility is a front-end to the print spooler as required by the
  54 .St -p1003.2
  55 specification.  It effectively invokes
  56 .Xr lpr 1
  57 with the proper set of arguments.
  58 .Pp
  59 It generally prints the named files on the destination printer.
  60 .Pp
  61 The following options are available:
  62 .Bl -tag -width indent
  63 .It Fl c
  64 Make the
  65 .Nm
  66 command exit only after further access to any of the input files is no
  67 longer required.  The application can then safely delete or modify the
  68 files without affecting the output operation.
  69 .It Fl d Ar dest
  70 Specify a particular printer.
  71 If no
  72 .Fl d
  73 is provided on the command line, the contents of the environment
  74 variables
  75 .Ev LPDEST
  76 or
  77 .Ev PRINTER
  78 (with this precedence)
  79 are taken as the destination printer.
  80 .It Fl n Ar num
  81 Specify that
  82 .Ar num
  83 copies of each of the named files shall be printed.
  84 .It Fl o Ar option
  85 Printer specific options.
  86 Not supported, provided only as a compatibility
  87 option for SVR.
  88 .It Fl s
  89 Silent operation.
  90 Not supported,
  91 provided only as a compatibility option for
  92 .St -susv2 .
  93 .El
  94 .Sh ENVIRONMENT
  95 As described above, the variables
  96 .Ev LPDEST
  97 and
  98 .Ev PRINTER
  99 are examined to select the destination printer.
 100 .Sh SEE ALSO
 101 .Xr lpr 1
 102 .Sh STANDARDS
 103 The
 104 .Nm
 105 command is expected to comply with the
 106 .St -p1003.2
 107 specification.
 108 .Sh AUTHORS
 109 This implementation of the
 110 .Nm
 111 command has been written by
 112 .An J\(:org Wunsch .
 113 .Sh BUGS
 114 The
 115 .St -p1003.2
 116 specification does not provide any means to print non-text files.  It
 117 rather requires the files to be printed to be text files limited to
 118 reasonable line lengths and printable characters.