cupsctl (8)
Leading comments
cupsctl man page for CUPS. Copyright 2007-2016 by Apple Inc. Copyright 2007 by Easy Software Products. These coded instructions, statements, and computer programs are the property of Apple Inc. and are protected by Federal copyright law. Distribution and use rights are outlined in the file "LICENSE.txt" which should have been included with this file. If this file is file is missing or damaged, see the license at "http://www.cups.org/".
NAME
cupsctl - configure cupsd.conf optionsSYNOPSIS
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 ]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
The following options are recognized:- -E
- Enables encryption on the connection to the scheduler.
- -U username
- Specifies an alternate username to use when authenticating with the scheduler.
- -h server[:port]
- Specifies the server address.
- --[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
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
You cannot set the Listen or Port directives using cupsctl.SEE ALSO
cupsd.conf(5), cupsd(8),CUPS Online Help (http://localhost:631/help)