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