xref: /freebsd/usr.sbin/lpr/lp/lp.1 (revision e627b39baccd1ec9129690167cf5e6d860509655)
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.\" $Id: lp.1,v 1.1 1995/01/23 19:22:37 joerg Exp $
35.\"
36.Dd January 22, 1995
37.Dt LP 1
38.Os
39.Sh NAME
40.Nm lp
41.Nd front-end to the print spooler
42.Sh SYNOPSIS
43.Nm lp
44.Op Fl c
45.Op Fl d printer
46.Op Fl n Ar num
47.Op Ar name ...
48.Sh DESCRIPTION
49.Nm Lp
50is a front-end to the print spooler as required by the
51.St -p1003.2
52specification.  It effectively invokes
53.Xr lpr 1
54with the proper set of arguments.
55
56It generally prints the named files on the destination printer.
57.Pp
58Option
59.Fl c
60makes the
61.Nm
62command exit only after further access to any of the input files is no
63longer required.  The application can then safely delete or modify the
64files without affecting the output operation.
65
66To specify a particular printer, option
67.Fl d Ar dest
68can be used.  If no
69.Fl d
70is provided on the command line, the contents of the environmental
71variables
72.Ev LPDEST
73or
74.Ev PRINTER
75.Pq with this precedence
76are taken as the destination printer.
77
78Option
79.Fl n Ar num
80can be used to specify that
81.Ar num
82copies of each of the named files shall be printed.
83
84.Sh ENVIRONMENT
85As described above, the variables
86.Ev LPDEST
87and
88.Ev PRINTER
89are examined to select the destination printer.
90
91.Sh SEE ALSO
92.Xr lpr 1
93.Sh STANDARDS
94The
95.Nm lp
96command is expected to comply with the
97.St -p1003.2
98specification.
99.Sh AUTHOR
100This implementation of the
101.Nm
102command has been written by
103.if t J\(:org Wunsch.
104.if n Joerg Wunsch.
105.Sh BUGS
106The
107.St -p1003.2
108specification does not provide any means to print non-text files.  It
109rather requires the files to be printed to be text files limited to
110reasonable line lengths and printable characters.
111