]> git.ipfire.org Git - thirdparty/cups.git/blob - man/lpinfo.8
Update .gitignore to ignore compressed man pages.
[thirdparty/cups.git] / man / lpinfo.8
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.