freebsd-dev/usr.sbin/lpr/lp/lp.1
Joerg Wunsch e3fa32b485 Implementing the "lp" command.
This command is required to exist in terms of compatibility with the
Posix 1003.2 specification.  It actually invokes the lpr service with
the proper options.
1995-01-23 19:22:43 +00:00

123 lines
3.6 KiB
Groff

.\"
.\" Copyright (c) 1995 Joerg Wunsch
.\"
.\" All rights reserved.
.\"
.\" This program is free software.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Joerg Wunsch
.\" 4. The name of the developer may not be used to endorse or promote
.\" products derived from this software without specific prior written
.\" permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $Id: lp.1,v 1.1 1995/01/22 17:47:24 j Exp $
.\"
.Dd January 22, 1995
.Dt LP 1
.Os
.Sh NAME
.Nm lp
.Nd front-end to the print spooler
.Sh SYNOPSIS
.Nm lp
.Op Fl c
.Op Fl d printer
.Op Fl n Ar num
.Op Ar name ...
.Sh DESCRIPTION
.Nm Lp
is a front-end to the print spooler as required by the
.St -p1003.2
specification. It effectively invokes
.Xr lpr 1
with the proper set of arguments.
It generally prints the named files on the destination printer.
.Pp
Option
.Fl c
makes the
.Nm
command exit only after further access to any of the input files is no
longer required. The application can then safely delete or modify the
files without affecting the output operation.
To specify a particular printer, option
.Fl d Ar dest
can be used. If no
.Fl d
is provided on the command line, the contents of the environmental
variables
.Ev LPDEST
or
.Ev PRINTER
.Pq with this precedence
are taken as the destination printer.
Option
.Fl n Ar num
can be used to specify that
.Ar num
copies of each of the named files shall be printed.
.Sh ENVIRONMENT
As described above, the variables
.Ev LPDEST
and
.Ev PRINTER
are examined to select the destination printer.
.Sh SEE ALSO
.Xr lpr 1
.Sh STANDARDS
The
.Nm lp
command is expected to comply with the
.St -p1003.2
specification.
.Sh AUTHOR
This implementation of the
.Nm
command has been written by
.if t J\(:org Wunsch.
.if n Joerg Wunsch.
.Sh BUGS
The
.Nm
command inherits several bugs from the utilities invoked, namely it
requires any option separated from its argument by a whitespace
since the getopts implementation of
.Xr sh 1
is broken, and it does not honour dashes as input file names
.Pq meant to use standard input
since
.Xr lpr 1
ignores them.
The
.St -p1003.2
specification does not provide any means to print non-text files. It
rather requires the files to be printed to be text files limited to
reasonable line lengths and printable characters.