man/lpinfo.man

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