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