Add header validation option to ipptool.

[thirdparty/cups.git] / man / lpinfo.man

.\"
.\" lpinfo man page for CUPS.
.\"
.\" Copyright 2007-2014 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" These coded instructions, statements, and computer programs are the
.\" property of Apple Inc. and are protected by Federal copyright
.\" law.  Distribution and use rights are outlined in the file "LICENSE.txt"
.\" which should have been included with this file.  If this file is
.\" file is missing or damaged, see the license at "http://www.cups.org/".
.\"
.TH lpinfo 8 "CUPS" "12 June 2014" "Apple Inc."
.SH NAME
lpinfo \- show available devices or drivers
.SH SYNOPSIS
.B lpinfo
[
.B \-E
] [
\fB\-h \fIserver\fR[\fB:\fIport\fR]
] [
.B \-l
] [
.B \-\-device\-id
.I device-id-string
] [
.B \-\-exclude\-schemes
.I scheme-list
] [
.B \-\-include\-schemes
.I scheme-list
] [
.B \-\-language
.I locale
] [
.B \-\-make\-and\-model
.I name
] [
.B \-\-product
.I name
]
.B \-m
.br
.B lpinfo
[
.B \-E
] [
\fB\-h \fIserver\fR[\fB:\fIport\fR]
] [
.B \-l
] [
.B \-\-exclude\-schemes
.I scheme-list
] [
.B \-\-include\-schemes
.I scheme-list
] [
.B \-\-timeout
.I seconds
]
.B \-v
.SH DESCRIPTION
\fBlpinfo\fR lists the available devices or drivers known to the CUPS server.
The first form (\fI-m\fR) lists the available drivers, while the second form (\fI-v\fR) lists the available devices.
.SH OPTIONS
\fBlpinfo\fR accepts the following options:
.TP 5
.B \-E
Forces encryption when connecting to the server.
.TP 5
\fB\-h \fIserver\fR[\fB:\fIport\fR]
Selects an alternate server.
.TP 5
.B \-l
Shows a "long" listing of devices or drivers.
.TP 5
\fB\-\-device\-id \fIdevice-id-string\fR
Specifies the IEEE-1284 device ID to match when listing drivers with the \fI\-m\fR option.
.TP 5
\fB\-\-exclude\-schemes \fIscheme-list\fR
Specifies a comma-delimited list of device or PPD schemes that should be excluded from the results.
Static PPD files use the "file" scheme.
.TP 5
\fB\-\-include\-schemes \fIscheme-list\fR
Specifies a comma-delimited list of device or PPD schemes that should be included in the results.
Static PPD files use the "file" scheme.
.TP 5
\fB\-\-language \fIlocale\fR
Specifies the language to match when listing drivers with the \fI\-m\fR option.
.TP 5
\fB\-\-make\-and\-model \fIname\fR
Specifies the make and model to match when listing drivers with the \fI\-m\fR option.
.TP 5
\fB\-\-product \fIname\fR
Specifies the product to match when listing drivers with the \fI\-m\fR option.
.TP 5
\fB\-\-timeout \fIseconds\fR
Specifies the timeout when listing devices with the \fI\-v\fR option.
.SH CONFORMING TO
The \fIlpinfo\fR command is unique to CUPS.
.SH EXAMPLES
List all devices:
.nf

    lpinfo \-v

.fi
List all drivers:
.nf

    lpinfo \-m

.fi
List drivers matching "HP LaserJet":
.nf

    lpinfo \-\-make\-and\-model "HP LaserJet" \-m
.fi
.SH SEE ALSO
.BR lpadmin (8),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2007-2017 by Apple Inc.