cupsctl

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

cupsctl updates the cupsd.conf file used by the CUPS scheduler. Running it with no arguments prints the current settings as name=value pairs; passing options or name=value arguments modifies the configuration and asks cupsd to reload.Because cupsctl communicates with cupsd over IPP rather than editing the file directly, it can be used to administer local or remote schedulers without requiring shell access to the server.

-E

Enable encryption on the connection to the scheduler.

Authenticate as username instead of the current user.

Connect to the scheduler on the given host and optional port.

Enable or disable debug logging to the error_log file.

Enable or disable remote administration.

Enable or disable printing from any address, including the Internet.

Enable or disable sharing of local printers with other computers.

Allow or prevent users from cancelling jobs owned by other users.

Set an arbitrary cupsd.conf directive directly.

Modifying server settings typically requires administrator (root) privileges or membership in the lpadmin group. Unknown or misspelled name=value directives are silently accepted; verify the result with a plain cupsctl call. Some settings require a full cupsd restart to fully take effect.

cupsctl was added to CUPS by Apple around the CUPS 1.3 release (2007) as a convenience wrapper over direct cupsd.conf editing. CUPS itself was created by Michael Sweet in 1999 and is now developed by the OpenPrinting project.

cupsd(8), cups-config(1), lpadmin(8), lpinfo(8), lpstat(1), lp(1)