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$ 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 44.Op Fl cs 45.Op Fl o Ar option 46.Op Fl d Ar printer 47.Op Fl n Ar num 48.Op Ar name ... 49.Sh DESCRIPTION 50The 51.Nm 52utility is 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. 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. 68The application can then safely delete or modify the 69files without affecting the output operation. 70.It Fl d Ar dest 71Specify a particular printer. 72If no 73.Fl d 74is provided on the command line, the contents of the environment 75variables 76.Ev LPDEST 77or 78.Ev PRINTER 79(with this precedence) 80are taken as the destination printer. 81.It Fl m 82Send mail upon completion. 83.It Fl n Ar num 84Specify that 85.Ar num 86copies of each of the named files shall be printed. 87.It Fl o Ar option 88Printer specific options. 89Not supported, provided only as a compatibility 90option for SVR. 91.It Fl s 92Silent operation. 93Not supported, 94provided only as a compatibility option for 95.St -susv2 . 96.It Fl t Ar title 97Set the job title to 98.Ar title . 99.El 100.Sh ENVIRONMENT 101As described above, the variables 102.Ev LPDEST 103and 104.Ev PRINTER 105are examined to select the destination printer. 106.Sh SEE ALSO 107.Xr lpr 1 108.Sh STANDARDS 109The 110.Nm 111command is expected to comply with the 112.St -p1003.2 113specification. 114.Sh AUTHORS 115This implementation of the 116.Nm 117command has been written by 118.An J\(:org Wunsch . 119.Sh BUGS 120The 121.St -p1003.2 122specification does not provide any means to print non-text files. 123It 124rather requires the files to be printed to be text files limited to 125reasonable line lengths and printable characters. 126