cupsctl(8) OpenPrinting cupsctl(8)

# [NAME](#NAME)

cupsctl - configure cupsd.conf options

# [SYNOPSIS](#SYNOPSIS)

**cupsctl** \[ **-h** *server*\[**:port**] ] \[ **-E** ] \[ **-U** *username* ] \[ **--**\[**no-**]**debug-logging** ] \[ **--**\[**no-**]**remote-admin** ] \[ **--**\[**no-**]**remote-any** ] \[ **--**\[**no-**]**share-printers** ] \[ **--**\[**no-**]**user-cancel-any** ] \[ *name=value* ]

# [DESCRIPTION](#DESCRIPTION)

**cupsctl** updates or queries the *cupsd.conf* file for a server. When no changes are requested, the current configuration values are written to the standard output in the format "name=value", one per line.

# [OPTIONS](#OPTIONS)

The following options are recognized:

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

Enables encryption on the connection to the scheduler.

[**-U username**](#U)

Specifies an alternate username to use when authenticating with the scheduler.

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

Specifies the server address. Note: This option must occur before all others.

**--**\[**no-**]**debug-logging**

Enables (disables) debug logging to the *error\_log* file.

**--**\[**no-**]**remote-admin**

Enables (disables) remote administration.

**--**\[**no-**]**remote-any**

Enables (disables) printing from any address, e.g., the Internet.

**--**\[**no-**]**share-printers**

Enables (disables) sharing of local printers with other computers.

**--**\[**no-**]**user-cancel-any**

Allows (prevents) users to cancel jobs owned by others.

# [EXAMPLES](#EXAMPLES)

Display the current settings:

```


    cupsctl
```

Enable debug logging:

```


    cupsctl --debug-logging
```

Get the current debug logging state:

```


    cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
```

Disable printer sharing:

```


    cupsctl --no-share-printers
```

# [KNOWN ISSUES](#KNOWN_ISSUES)

You cannot set the Listen or Port directives using **cupsctl**.

# [SEE ALSO](#SEE_ALSO)

[**cupsd.conf**(5)](/man/os/cups/cupsd.conf.5), [**cupsd**(8)](/man/os/cups/cupsd.8),  
CUPS Online Help (http://localhost:631/help)

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2020-2024 by OpenPrinting.

CUPS 2022-05-02

---

Document: cupsctl(8) from cups 2.4.19-r3 (Chainguard OS)
Source: https://github.com/OpenPrinting/cups