mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-15 10:17:20 +00:00
e3fa32b485
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.
123 lines
3.6 KiB
Groff
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.
|