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.Dd January 22, 1995 35.Dt LP 1 36.Os 37.Sh NAME 38.Nm lp 39.Nd front-end to the print spooler 40.Sh SYNOPSIS 41.Nm 42.Op Fl cs 43.Op Fl o Ar option 44.Op Fl d Ar printer 45.Op Fl n Ar num 46.Op Ar name ... 47.Sh DESCRIPTION 48The 49.Nm 50utility is a front-end to the print spooler as required by the 51.St -p1003.2 52specification. 53It effectively invokes 54.Xr lpr 1 55with the proper set of arguments. 56.Pp 57It generally prints the named files on the destination printer. 58.Pp 59The following options are available: 60.Bl -tag -width indent 61.It Fl c 62Make the 63.Nm 64command exit only after further access to any of the input files is no 65longer required. 66The application can then safely delete or modify the 67files without affecting the output operation. 68.It Fl d Ar dest 69Specify a particular printer. 70If no 71.Fl d 72is provided on the command line, the contents of the environment 73variables 74.Ev LPDEST 75or 76.Ev PRINTER 77(with this precedence) 78are taken as the destination printer. 79.It Fl m 80Send mail upon completion. 81.It Fl n Ar num 82Specify that 83.Ar num 84copies of each of the named files shall be printed. 85.It Fl o Ar option 86Printer specific options. 87Not supported, provided only as a compatibility 88option for SVR. 89.It Fl s 90Silent operation. 91Not supported, 92provided only as a compatibility option for 93.St -susv2 . 94.It Fl t Ar title 95Set the job title to 96.Ar title . 97.El 98.Sh ENVIRONMENT 99As described above, the variables 100.Ev LPDEST 101and 102.Ev PRINTER 103are examined to select the destination printer. 104.Sh SEE ALSO 105.Xr lpr 1 106.Sh STANDARDS 107The 108.Nm 109command is expected to comply with the 110.St -p1003.2 111specification. 112.Sh AUTHORS 113This implementation of the 114.Nm 115command has been written by 116.An J\(:org Wunsch . 117.Sh BUGS 118The 119.St -p1003.2 120specification does not provide any means to print non-text files. 121It 122rather requires the files to be printed to be text files limited to 123reasonable line lengths and printable characters. 124