cups-browsed.conf(5)cups-browsed.conf(5)NAMEcups-browsed.conf - server configuration file for cups-browsed
DESCRIPTION
The cups-browsed.conf file configures the cups-browsed daemon. It is
normally located in the /etc/cups directory. Each line in the file can
be a configuration directive, a blank line, or a comment. Comment lines
start with the # character.
DIRECTIVES
The BrowseAllow directive specifies a system or network to accept CUPS
browse packets from. The default is to accept browse packets from all
hosts when BrowseRemoteProtocols uses the CUPS protocol.
BrowseAllow 192.168.7.20
BrowseAllow 192.168.7.0/24
BrowseAllow 192.168.7.0/255.255.255.0
The BrowsePoll directive polls a server for available printers once
every 60 seconds. Multiple BrowsePoll directives can be specified to
poll multiple servers. The default port to connect to is 631. Browse‐
Poll works independently of whether CUPS browsing is activated in
BrowseRemoteProtocols.
BrowsePoll 192.168.7.20
BrowsePoll 192.168.7.65:631
BrowsePoll host.example.com:631
The BrowseLocalProtocols directive specifies the protocols to use when
advertising local shared printers on the network. The default is
"none". Control of advertising of local shared printers using dnssd is
done in /etc/cups/cupsd.conf.
BrowseLocalProtocols none
BrowseLocalProtocols CUPS
The BrowseRemoteProtocols directive specifies the protocols to use when
finding remote shared printers on the network. Multiple protocols can
be specified by separating them with spaces. The default is "dnssd
cups".
BrowseRemoteProtocols none
BrowseRemoteProtocols CUPS dnssd
BrowseRemoteProtocols CUPS
BrowseRemoteProtocols dnssd
The BrowseProtocols directive specifies the protocols to use when find‐
ing remote shared printers on the network and advertising local shared
printers. "dnssd" is ignored for BrowseLocalProtocols. Multiple proto‐
cols can be specified by separating them with spaces. The default is
"none" for BrowseLocalProtocols and "dnssd cups" for BrowseRemoteProto‐
cols.
BrowseProtocols none
BrowseProtocols CUPS dnssd
BrowseProtocols CUPS
BrowseProtocols dnssd
The DomainSocket directive specifies the domain socket through which
the locally running CUPS daemon is accessed. If not specified the stan‐
dard domain socket of CUPS is used. Use this if you have specified an
alternative domain socket for CUPS via a Listen directive in
/etc/cups/cupsd.conf. If cups-browsed is not able to access the local
CUPS daemon via a domain socket it accesses it via localhost.
DomainSocket /var/run/cups/cups.sock
The CreateIPPPrinterQueues directive specifies whether cups-browsed
should discover IPP printers (via Bonjour) and if they understand a
known page description language (PWG Raster, PDF, PostScript, PCL XL,
PCL 5c/e) create PPD-less print queues (using a System V interface
script to control the filter chain). Clients have to IPP-poll the capa‐
bilities of the printer and send option settings as standard IPP
attributes. We do not poll the capabilities by ourselves to not wake up
the printer from power-saving mode when creating the queues. Jobs have
to be sent in PDF format. Other formats are not accepted. This func‐
tionality is primarily for mobile devices running CUPS to not need a
printer setup tool nor a collection of printer drivers and PPDs.
CreateIPPPrinterQueues Yes
The AutoShutdown directive specifies whether cups-browsed should auto‐
matically terminate when it has no local raw queues set up pointing to
any discovered remote printers (auto shutdown mode). Setting it to "On"
activates the auto-shutdown mode, setting it to "Off" deactiivates it
(the default). The special mode "avahi" turns auto shutdown off while
avahi-daemon is running and on when avahi-daemon stops. This allows
running cups-browsed on-demand when avahi-daemon is run on-demand.
AutoShutdown Off
AutoShutdown On
AutoShutdown avahi
The AutoShutdownTimeout directive specifies after how many seconds
without local raw queues set up pointing to any discovered remote
printers cups-browsed should actually shut down in auto shutdown mode.
Default is 30 seconds, 0 means immediate shutdown.
AutoShutdownTimeout 20
SEE ALSOcups-browsed(8)
/usr/share/doc/cups-browsed/README.gz
AUTHOR
The authors of cups-browsed are listed in /usr/share/doc/cups-
browsed/AUTHORS.
This manual page was written for the Debian Project, but it may be used
by others.
29 June 2013 cups-browsed.conf(5)