1.\" $NetBSD: lp.1,v 1.7 2002/01/19 03:21:59 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.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 58is a front-end to the print spooler as required by the 59.St -p1003.2 60specification. It effectively invokes 61.Xr lpr 1 62with the proper set of arguments. 63It generally prints the named files on the destination printer. 64.Pp 65The following options are available: 66.Bl -tag -width indent 67.It Fl c 68Make the 69.Nm 70command exit only after further access to any of the input files is no 71longer required. The application can then safely delete or modify the 72files without affecting the output operation. 73.It Fl d Ar dest 74Specify a particular printer. If no 75.Fl d 76is provided on the command line, the contents of the environment 77variables 78.Ev LPDEST 79or 80.Ev PRINTER 81.Pq with this precedence 82are taken as the destination printer. 83.It Fl n Ar num 84Specify that 85.Ar num 86copies of each of the named files shall be printed. 87.It Fl s 88Silent operation. 89.It Fl o 90Printer specific options. Not supported, provided only as a compatibility 91option for SVR4. 92.El 93.Sh ENVIRONMENT 94As described above, the variables 95.Ev LPDEST 96and 97.Ev PRINTER 98are examined to select the destination printer. 99.Sh SEE ALSO 100.Xr lpr 1 101.Sh STANDARDS 102The 103.Nm 104command is expected to comply with the 105.St -p1003.2 106specification. 107.Sh AUTHORS 108This implementation of the 109.Nm 110command has been written by 111.if t J\(:org Wunsch . 112.if n Joerg 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