xref: /netbsd-src/usr.sbin/lpr/lp/lp.1 (revision 1ac719d1471d3ae0a3f0c66e42d0affa92669733)
1.\"	$NetBSD: lp.1,v 1.11 2012/04/08 22:00:40 wiz 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.Op Fl d Ar printer
47.Op Fl n Ar num
48.Op Fl o Ar option
49.Op Ar
50.Sh DESCRIPTION
51.Nm
52is a front-end to the print spooler as required by the
53.St -p1003.2
54specification.
55It effectively invokes
56.Xr lpr 1
57with the proper set of arguments.
58It generally prints the named files on the destination printer.
59.Pp
60The following options are available:
61.Bl -tag -width indent
62.It Fl c
63Make the
64.Nm
65command exit only after further access to any of the input files is no
66longer required.
67The application can then safely delete or modify the files without
68affecting the output operation.
69.It Fl d Ar printer
70Specify a particular printer.
71If no
72.Fl d
73is provided on the command line, the contents of the environment
74variables
75.Ev LPDEST
76or
77.Ev PRINTER
78.Pq with this precedence
79are taken as the destination printer.
80.It Fl n Ar num
81Specify that
82.Ar num
83copies of each of the named files shall be printed.
84.It Fl o Ar option
85Printer specific options.
86Not supported, provided only as a compatibility option for SVR4.
87.It Fl s
88Silent operation.
89.El
90.Sh ENVIRONMENT
91As described above, the variables
92.Ev LPDEST
93and
94.Ev PRINTER
95are examined to select the destination printer.
96.Sh SEE ALSO
97.Xr lpr 1
98.Sh STANDARDS
99The
100.Nm
101command is expected to comply with the
102.St -p1003.2
103specification.
104.Sh AUTHORS
105This implementation of the
106.Nm
107command has been written by
108.An J\(:org Wunsch .
109.Sh BUGS
110The
111.St -p1003.2
112specification does not provide any means to print non-text files.
113It rather requires the files to be printed to be text files limited
114to reasonable line lengths and printable characters.
115