cupsctl(8) — Linux manual page


cupsctl(8)                     Apple Inc.                     cupsctl(8)

NAME         top

       cupsctl - configure cupsd.conf options

SYNOPSIS         top

       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         top

       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         top

       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.

            Enables (disables) debug logging to the error_log file.

            Enables (disables) remote administration.

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

            Enables (disables) sharing of local printers with other

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

EXAMPLES         top

       Display the current settings:


       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         top

       You cannot set the Listen or Port directives using cupsctl.

SEE ALSO         top

       cupsd.conf(5), cupsd(8),
       CUPS Online Help (http://localhost:631/help)

COPYRIGHT         top

       Copyright © 2007-2019 by Apple Inc.

COLOPHON         top

       This page is part of the CUPS (a standards-based, open source
       printing system) project.  Information about the project can be
       found at ⟨⟩.  If you have a bug report for
       this manual page, see ⟨⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨⟩ on 2021-08-27.  (At that time,
       the date of the most recent commit that was found in the
       repository was 2021-08-24.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

26 April 2019                     CUPS                        cupsctl(8)

Pages that refer to this page: cups(1)