man/lpinfo.man

   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 .\" These coded instructions, statements, and computer programs are the
   8 .\" property of Apple Inc. and are protected by Federal copyright
   9 .\" law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  10 .\" which should have been included with this file.  If this file is
  11 .\" file is missing or damaged, see the license at "http://www.cups.org/".
  12 .\"
  13 .TH lpinfo 8 "CUPS" "12 June 2014" "Apple Inc."
  14 .SH NAME
  15 lpinfo \- show available devices or drivers
  16 .SH SYNOPSIS
  17 .B lpinfo
  18 [
  19 .B \-E
  20 ] [
  21 .B \-U
  22 .I username
  23 ] [
  24 \fB\-h \fIserver\fR[\fB:\fIport\fR]
  25 ] [
  26 .B \-l
  27 ] [
  28 .B \-\-device\-id
  29 .I device-id-string
  30 ] [
  31 .B \-\-exclude\-schemes
  32 .I scheme-list
  33 ] [
  34 .B \-\-include\-schemes
  35 .I scheme-list
  36 ] [
  37 .B \-\-language
  38 .I locale
  39 ] [
  40 .B \-\-make\-and\-model
  41 .I name
  42 ] [
  43 .B \-\-product
  44 .I name
  45 ]
  46 .B \-m
  47 .br
  48 .B lpinfo
  49 [
  50 .B \-E
  51 ] [
  52 .B \-U
  53 .I username
  54 ] [
  55 \fB\-h \fIserver\fR[\fB:\fIport\fR]
  56 ] [
  57 .B \-l
  58 ] [
  59 .B \-\-exclude\-schemes
  60 .I scheme-list
  61 ] [
  62 .B \-\-include\-schemes
  63 .I scheme-list
  64 ] [
  65 .B \-\-timeout
  66 .I seconds
  67 ]
  68 .B \-v
  69 .SH DESCRIPTION
  70 \fBlpinfo\fR lists the available devices or drivers known to the CUPS server.
  71 The first form (\fI-m\fR) lists the available drivers, while the second form (\fI-v\fR) lists the available devices.
  72 .SH OPTIONS
  73 \fBlpinfo\fR accepts the following options:
  74 .TP 5
  75 .B \-E
  76 Forces encryption when connecting to the server.
  77 .TP 5
  78 \fB\-U \fIusername\fR
  79 Sets the username to use when connecting to the server.
  80 .TP 5
  81 \fB\-h \fIserver\fR[\fB:\fIport\fR]
  82 Selects an alternate server.
  83 .TP 5
  84 .B \-l
  85 Shows a "long" listing of devices or drivers.
  86 .TP 5
  87 \fB\-\-device\-id \fIdevice-id-string\fR
  88 Specifies the IEEE-1284 device ID to match when listing drivers with the \fI\-m\fR option.
  89 .TP 5
  90 \fB\-\-exclude\-schemes \fIscheme-list\fR
  91 Specifies a comma-delimited list of device or PPD schemes that should be excluded from the results.
  92 Static PPD files use the "file" scheme.
  93 .TP 5
  94 \fB\-\-include\-schemes \fIscheme-list\fR
  95 Specifies a comma-delimited list of device or PPD schemes that should be included in the results.
  96 Static PPD files use the "file" scheme.
  97 .TP 5
  98 \fB\-\-language \fIlocale\fR
  99 Specifies the language to match when listing drivers with the \fI\-m\fR option.
 100 .TP 5
 101 \fB\-\-make\-and\-model \fIname\fR
 102 Specifies the make and model to match when listing drivers with the \fI\-m\fR option.
 103 .TP 5
 104 \fB\-\-product \fIname\fR
 105 Specifies the product to match when listing drivers with the \fI\-m\fR option.
 106 .TP 5
 107 \fB\-\-timeout \fIseconds\fR
 108 Specifies the timeout when listing devices with the \fI\-v\fR option.
 109 .SH CONFORMING TO
 110 The \fIlpinfo\fR command is unique to CUPS.
 111 .SH EXAMPLES
 112 List all devices:
 113 .nf
 114
 115     lpinfo \-v
 116
 117 .fi
 118 List all drivers:
 119 .nf
 120
 121     lpinfo \-m
 122
 123 .fi
 124 List drivers matching "HP LaserJet":
 125 .nf
 126
 127     lpinfo \-\-make\-and\-model "HP LaserJet" \-m
 128 .fi
 129 .SH SEE ALSO
 130 .BR lpadmin (8),
 131 CUPS Online Help (http://localhost:631/help)
 132 .SH COPYRIGHT
 133 Copyright \[co] 2007-2015 by Apple Inc.