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

.\"
.\" lpinfo man page for CUPS.
.\"
.\" Copyright 2007-2014 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
.\"
.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-2018 by Apple Inc.
Commit	Line	Data
	1	.\"
	2	.\" lpinfo man page for CUPS.
	3	.\"
	4	.\" Copyright 2007-2014 by Apple Inc.
	5	.\" Copyright 1997-2006 by Easy Software Products.
	6	.\"
	7	.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
	8	.\"
	9	.TH lpinfo 8 "CUPS" "12 June 2014" "Apple Inc."
	10	.SH NAME
	11	lpinfo \- show available devices or drivers
	12	.SH SYNOPSIS
	13	.B lpinfo
	14	[
	15	.B \-E
	16	] [
	17	\fB\-h \fIserver\fR[\fB:\fIport\fR]
	18	] [
	19	.B \-l
	20	] [
	21	.B \-\-device\-id
	22	.I device-id-string
	23	] [
	24	.B \-\-exclude\-schemes
	25	.I scheme-list
	26	] [
	27	.B \-\-include\-schemes
	28	.I scheme-list
	29	] [
	30	.B \-\-language
	31	.I locale
	32	] [
	33	.B \-\-make\-and\-model
	34	.I name
	35	] [
	36	.B \-\-product
	37	.I name
	38	]
	39	.B \-m
	40	.br
	41	.B lpinfo
	42	[
	43	.B \-E
	44	] [
	45	\fB\-h \fIserver\fR[\fB:\fIport\fR]
	46	] [
	47	.B \-l
	48	] [
	49	.B \-\-exclude\-schemes
	50	.I scheme-list
	51	] [
	52	.B \-\-include\-schemes
	53	.I scheme-list
	54	] [
	55	.B \-\-timeout
	56	.I seconds
	57	]
	58	.B \-v
	59	.SH DESCRIPTION
	60	\fBlpinfo\fR lists the available devices or drivers known to the CUPS server.
	61	The first form (\fI-m\fR) lists the available drivers, while the second form (\fI-v\fR) lists the available devices.
	62	.SH OPTIONS
	63	\fBlpinfo\fR accepts the following options:
	64	.TP 5
	65	.B \-E
	66	Forces encryption when connecting to the server.
	67	.TP 5
	68	\fB\-h \fIserver\fR[\fB:\fIport\fR]
	69	Selects an alternate server.
	70	.TP 5
	71	.B \-l
	72	Shows a "long" listing of devices or drivers.
	73	.TP 5
	74	\fB\-\-device\-id \fIdevice-id-string\fR
	75	Specifies the IEEE-1284 device ID to match when listing drivers with the \fI\-m\fR option.
	76	.TP 5
	77	\fB\-\-exclude\-schemes \fIscheme-list\fR
	78	Specifies a comma-delimited list of device or PPD schemes that should be excluded from the results.
	79	Static PPD files use the "file" scheme.
	80	.TP 5
	81	\fB\-\-include\-schemes \fIscheme-list\fR
	82	Specifies a comma-delimited list of device or PPD schemes that should be included in the results.
	83	Static PPD files use the "file" scheme.
	84	.TP 5
	85	\fB\-\-language \fIlocale\fR
	86	Specifies the language to match when listing drivers with the \fI\-m\fR option.
	87	.TP 5
	88	\fB\-\-make\-and\-model \fIname\fR
	89	Specifies the make and model to match when listing drivers with the \fI\-m\fR option.
	90	.TP 5
	91	\fB\-\-product \fIname\fR
	92	Specifies the product to match when listing drivers with the \fI\-m\fR option.
	93	.TP 5
	94	\fB\-\-timeout \fIseconds\fR
	95	Specifies the timeout when listing devices with the \fI\-v\fR option.
	96	.SH CONFORMING TO
	97	The \fIlpinfo\fR command is unique to CUPS.
	98	.SH EXAMPLES
	99	List all devices:
	100	.nf
	101
	102	lpinfo \-v
	103
	104	.fi
	105	List all drivers:
	106	.nf
	107
	108	lpinfo \-m
	109
	110	.fi
	111	List drivers matching "HP LaserJet":
	112	.nf
	113
	114	lpinfo \-\-make\-and\-model "HP LaserJet" \-m
	115	.fi
	116	.SH SEE ALSO
	117	.BR lpadmin (8),
	118	CUPS Online Help (http://localhost:631/help)
	119	.SH COPYRIGHT
	120	Copyright \[co] 2007-2018 by Apple Inc.