xref: /dragonfly/usr.sbin/lpr/lp/lp.1 (revision d4ef6694)
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
51The
52.Nm
53utility is a front-end to the print spooler as required by the
54.St -p1003.2
55specification.  It effectively invokes
56.Xr lpr 1
57with the proper set of arguments.
58.Pp
59It generally prints the named files on the destination printer.
60.Pp
61The following options are available:
62.Bl -tag -width indent
63.It Fl c
64Make the
65.Nm
66command exit only after further access to any of the input files is no
67longer required.  The application can then safely delete or modify the
68files without affecting the output operation.
69.It Fl d Ar dest
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(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
87option for SVR.
88.It Fl s
89Silent operation.
90Not supported,
91provided only as a compatibility option for
92.St -susv2 .
93.El
94.Sh ENVIRONMENT
95As described above, the variables
96.Ev LPDEST
97and
98.Ev PRINTER
99are examined to select the destination printer.
100.Sh SEE ALSO
101.Xr lpr 1
102.Sh STANDARDS
103The
104.Nm
105command is expected to comply with the
106.St -p1003.2
107specification.
108.Sh AUTHORS
109This implementation of the
110.Nm
111command has been written by
112.An J\(:org Wunsch .
113.Sh BUGS
114The
115.St -p1003.2
116specification does not provide any means to print non-text files.  It
117rather requires the files to be printed to be text files limited to
118reasonable line lengths and printable characters.
119