cupsctl(8) Apple Inc. cupsctl(8)NAME
cupsctl - configure cupsd.conf options
SYNOPSIS
cupsctl [ -E ] [-U username ] [ -h server[:port] ] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ] [ --[no-]remote-
printers ] [ --[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 or disables debug logging in the error_log file.
--[no-]remote-admin
Enables or disables remote administration.
--[no-]remote-any
Enables or disables printing from any address, e.g. the Internet.
--[no-]remote-printers
Enables or disables the display of remote printers shared via the CUPS, LDAP, or SLP protocols.
--[no-]share-printers
Enables or disables sharing of local printers with other computers.
--[no-]user-cancel-any
Allows or prevents users from canceling 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-shared-printers
KNOWN ISSUES
You cannot set the Listen or Port directives using cupsctl.
SEE ALSO cupsd.conf(5), cupsd(8),
http://localhost:631/help
COPYRIGHT
Copyright 2007-2011 by Apple Inc.
12 December 2012 CUPS cupsctl(8)
Check Out this Related Man Page
lpstat(1) Apple Inc. lpstat(1)NAME
lpstat - print cups status information
SYNOPSIS
lpstat [ -E ] [ -H ] [ -U username ] [ -h hostname[:port] ] [ -l ] [ -W which-jobs ] [ -a [ destination(s) ] ] [ -c [ class(es) ] ] [ -d ]
[ -o [ destination(s) ] ] [ -p [ printer(s) ] ] [ -r ] [ -R ] [ -s ] [ -t ] [ -u [ user(s) ] ] [ -v [ printer(s) ] ]
DESCRIPTION
lpstat displays status information about the current classes, jobs, and printers. When run with no arguments, lpstat will list jobs queued
by the current user.
OPTIONS
The lpstat command supports the following options:
-E
Forces encryption when connecting to the server.
-H
Shows the server hostname and port.
-R
Shows the ranking of print jobs.
-U username
Specifies an alternate username.
-W which-jobs
Specifies which jobs to show, completed or not-completed (the default). This option must appear before the -o option and/or any
printer names, otherwise the default (not-completed) value will be used in the request to the scheduler.
-a [printer(s)]
Shows the accepting state of printer queues. If no printers are specified then all printers are listed.
-c [class(es)]
Shows the printer classes and the printers that belong to them. If no classes are specified then all classes are listed.
-d
Shows the current default destination.
-h server[:port]
Specifies an alternate server.
-l
Shows a long listing of printers, classes, or jobs.
-o [destination(s)]
Shows the jobs queue on the specified destinations. If no destinations are specified all jobs are shown.
-p [printer(s)]
Shows the printers and whether or not they are enabled for printing. If no printers are specified then all printers are listed.
-r
Shows whether the CUPS server is running.
-s
Shows a status summary, including the default destination, a list of classes and their member printers, and a list of printers and
their associated devices. This is equivalent to using the "-d", "-c", and "-v" options.
-t
Shows all status information. This is equivalent to using the "-r", "-d", "-c", "-v", "-a", "-p", and "-o" options.
-u [user(s)]
Shows a list of print jobs queued by the specified users. If no users are specified, lists the jobs queued by the current user.
-v [printer(s)]
Shows the printers and what device they are attached to. If no printers are specified then all printers are listed.
COMPATIBILITY
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", and "#". Also,
printer and class names are not case-sensitive.
The "-h", "-E", "-U", and "-W" options are unique to CUPS.
The Solaris "-f", "-P", and "-S" options are silently ignored.
SEE ALSO cancel(1), lp(1),
http://localhost:631/help
COPYRIGHT
Copyright 2007-2011 by Apple Inc.
10 September 2008 CUPS lpstat(1)