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

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