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 All BrowseAllow 192.168.7.20 BrowseAllow 192.168.7.0/24 BrowseAllow 192.168.7.0/255.255.255.0The 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:631The 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 CUPSThe 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 BrowseRemoteProtocols ldapThe BrowseProtocols directive specifies the protocols to use when finding remote shared printers on the network and advertising local shared printers. "dnssd" and "ldap" are 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 BrowseProtocols ldapThe configuration for the LDAP browsing mode define where the LDAP search should be performed. If built with an LDAP library that supports TLS, the path to the server's certificate, or to a certificates store, can be specified. The optional filter allows the LDAP search to be more specific, and is used in addition to the hardcoded filter (objectclass=cupsPrinter).
BrowseLDAPBindDN cn=cups-browsed,dc=domain,dc=tld BrowseLDAPCACertFile /path/to/server/certificate.pem BrowseLDAPDN ou=printers,dc=domain,dc=tld BrowseLDAPFilter (printerLocation=/Office 1/*) BrowseLDAPPassword s3cret BrowseLDAPServer ldaps://ldap.domain.tldThe 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.sockThe 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 YesThe 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 avahiThe 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.
This manual page was written for the Debian Project, but it may be used by others.