lpoptions(1) OpenPrinting lpoptions(1)

# [NAME](#NAME)

lpoptions - display or set printer options and defaults

# [SYNOPSIS](#SYNOPSIS)

**lpoptions** \[ **-h server**\[**:port**] ] \[ **-E** ] **-d destination**\[**/instance**] \[ **-l** ]  
**lpoptions** \[ **-h server**\[**:port**] ] \[ **-E** ] \[ **-p destination**\[**/instance**] ] **-o option**\[**=value**] ...  
**lpoptions** \[ **-h server**\[**:port**] ] \[ **-E** ] \[ **-p destination**\[**/instance**] ] **-r** *option*  
**lpoptions** \[ **-h server**\[**:port**] ] \[ **-E** ] **-x destination**\[**/instance**]

# [DESCRIPTION](#DESCRIPTION)

**lpoptions** displays or sets printer options and defaults. If no printer is specified using the *-p* option, the default printer is used as described in [**lp**(1)](/man/os/cups/lp.1).

If no *-l*, *-o*, or *-r* options are specified, the current options are reported on the standard output.

Options set with the **lpoptions** command are used by the [**lp**(1)](/man/os/cups/lp.1) and [**lpr**(1)](/man/os/cups/lpr.1) commands when submitting jobs.

When run by the root user, **lpoptions** gets and sets default options and instances for all users in the */etc/cups/lpoptions* file. Otherwise, the per-user defaults are managed in the *~/.cups/lpoptions* file.

# [OPTIONS](#OPTIONS)

**lpoptions** supports the following options:

[**-E**](#E)

Enables encryption when communicating with the CUPS server.

[**-d destination**\[**/instance**\]](#d)

Sets the user default printer to *destination*. If *instance* is supplied then that particular instance is used. This option overrides the system default printer for the current user.

[**-h server**\[**:port**\]](#h)

Uses an alternate server. Note: This option must occur before all others.

[**-l**](#l)

Lists the printer specific options and their current settings.

[**-o option**\[**=value**\]](#o)

Specifies a new option for the named destination.

[**-p destination**\[**/instance**\]](#p)

Sets the destination and instance, if specified, for any options that follow. If the named instance does not exist then it is created. Destinations can only be created using the [**lpadmin**(8)](/man/os/cups/lpadmin.8) program.

[**-r option**](#r)

Removes the specified option from the named destination.

[**-x destination**\[**/instance**\]](#x)

Removes the options for the named destination and instance, if specified. If the named instance does not exist then this does nothing. Destinations can only be removed using the [**lpadmin**(8)](/man/os/cups/lpadmin.8) command.

# [FILES](#FILES)

*~/.cups/lpoptions* - user defaults and instances created by non-root users.  
*/etc/cups/lpoptions* - system-wide defaults and instances created by the root user.

# [CONFORMING TO](#CONFORMING_TO)

The **lpoptions** command is unique to CUPS.

# [SEE ALSO](#SEE_ALSO)

[**cancel**(1)](/man/os/cups/cancel.1), [**lp**(1)](/man/os/cups/lp.1), [**lpadmin**(8)](/man/os/cups/lpadmin.8), [**lpr**(1)](/man/os/cups/lpr.1), [**lprm**(1)](/man/os/cups/lprm.1), CUPS Online Help (http://localhost:631/help)

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2020-2024 by OpenPrinting.

CUPS 2022-05-02

---

Document: lpoptions(1) from cups 2.4.19-r6 (Chainguard OS)
Source: https://github.com/OpenPrinting/cups