NAME

       cups-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.   BrowsePoll  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  finding  remote  shared
       printers  on  the  network  and  advertising local shared printers. "dnssd" is ignored for
       BrowseLocalProtocols. Multiple protocols can be specified by separating them with  spaces.
       The default is "none" for BrowseLocalProtocols and "dnssd cups" for BrowseRemoteProtocols.

               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 standard 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  capabilities
       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
       functionality 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 automatically 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 ALSO

       cups-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)