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