1lpoptions(1)                     OpenPrinting                     lpoptions(1)
2
3
4

NAME

6       lpoptions - display or set printer options and defaults
7

SYNOPSIS

9       lpoptions [ -h server[:port] ] [ -E ] -d destination[/instance] [ -l ]
10       lpoptions  [ -h server[:port] ] [ -E ] [ -p destination[/instance] ] -o
11       option[=value] ...
12       lpoptions [ -h server[:port] ] [ -E ] [ -p destination[/instance] ]  -r
13       option
14       lpoptions [ -h server[:port] ] [ -E ] -x destination[/instance]
15

DESCRIPTION

17       lpoptions displays or sets printer options and defaults.  If no printer
18       is specified using the -p option, the default printer is  used  as  de‐
19       scribed in lp(1).
20
21       If  no -l, -o, or -r options are specified, the current options are re‐
22       ported on the standard output.
23
24       Options set with the lpoptions command are used by the lp(1) and lpr(1)
25       commands when submitting jobs.
26
27       When  run by the root user, lpoptions gets and sets default options and
28       instances for all users in the  /etc/cups/lpoptions  file.   Otherwise,
29       the per-user defaults are managed in the ~/.cups/lpoptions file.
30

OPTIONS

32       lpoptions supports the following options:
33
34       -E   Enables encryption when communicating with the CUPS server.
35
36       -d destination[/instance]
37            Sets the user default printer to destination.  If instance is sup‐
38            plied then that particular instance is used.   This  option  over‐
39            rides the system default printer for the current user.
40
41       -h server[:port]
42            Uses an alternate server.  Note: This option must occur before all
43            others.
44
45       -l   Lists the printer specific options and their current settings.
46
47       -o option[=value]
48            Specifies a new option for the named destination.
49
50       -p destination[/instance]
51            Sets the destination and instance, if specified, for  any  options
52            that follow.  If the named instance does not exist then it is cre‐
53            ated.  Destinations can only be created using the lpadmin(8)  pro‐
54            gram.
55
56       -r option
57            Removes the specified option from the named destination.
58
59       -x destination[/instance]
60            Removes  the  options  for  the named destination and instance, if
61            specified.  If the named instance does not exist  then  this  does
62            nothing.   Destinations  can  only be removed using the lpadmin(8)
63            command.
64

FILES

66       ~/.cups/lpoptions - user defaults and  instances  created  by  non-root
67       users.
68       /etc/cups/lpoptions - system-wide defaults and instances created by the
69       root user.
70

CONFORMING TO

72       The lpoptions command is unique to CUPS.
73

SEE ALSO

75       cancel(1),  lp(1),  lpadmin(8),  lpr(1),  lprm(1),  CUPS  Online   Help
76       (http://localhost:631/help)
77
79       Copyright © 2021-2023 by OpenPrinting.
80
81
82
832022-05-02                           CUPS                         lpoptions(1)
Impressum