1cups-browsed(8) cups-browsed(8)
2
6 cups-browsed - A daemon for browsing the Bonjour broadcasts of shared,
7 remote CUPS printers
8
10 cups-browsed [-v | -d | --debug] [-c config-file]
11 [-o option=value] [-o 'config file line'] ...
12 [--autoshutdown=mode] [--autoshutdown-timeout=timeout]
13 [-h | --help | --version]
14
17 cups-browsed has four independently switchable functions:
18 1. Browse Bonjour broadcasts of remote printers and create/remove
20 local raw queues pointing to these printers.
21 2. Browse CUPS broadcasts of remote printers and create/remove local
23 raw queues pointing to these printers.
24 3. Browse an LDAP server for printers and create/remove local raw
26 queues pointing to these printers.
27 4. Broadcast local queues with the CUPS protocol.
29 Note that 2. and 4. are only to allow communication with legacy CUPS
31 servers (1.5.x or older) on the remote machine(s). The standard method
32 to broadcast for shared/network printers to broadcast their presence is
33 Bonjour. The CUPS broadcasting/browsing protocol is deprecated.
34 cups-browsed can be run permanently (from system boot to shutdown) or
36 on-demand (for example to save resources on mobile devices). For run‐
37 ning it on-demand an auto-shutdown feature can be activated to let
38 cups-browsed terminate when it does not have queues any more to take
39 care of.
40
43 -v, -d, --debug
44 Debug mode, verbose logging to stderr
45 -l, --logfile
47 Debug logging into /var/log/cups/cups-browsed_log file.
48 -c config-file
50 Uses the alternative configuration file config-file instead of
51 the standard one.
52 -o option=value, -o 'config file line'
54 Supply configuration options via the command line. You can sup‐
55 ply any line which also could be put into the configuration
56 file, but note that due to the spaces the line has to be put
57 into quotes, or for a simple key/value pair the space between
58 key and value can get replaced by '='. If command-line-supplied
59 configuration settings are contradicting with the ones in the
60 configuration file, the ones in the configuration file will get
61 used.
62 --autoshutdown=mode
64 Auto shutdown mode, mode is off for no auto shutdown, on for
65 auto shutdown being active, and avahi for control by the avahi-
66 daemon being run on-demand, getting auto-shutdown turned off
67 while avahi-daemon is present and on when avahi-daemon is shut
68 down.
69 --autoshutdown-on=inactivity-type
71 What cups-browsed considers as inactivity for auto-shutdown.
72 inactivity-type set to no-queues (the default) means that auto-
73 shutdown is initiated if there are no queues generated by cups-
74 browsed any more, no-jobs means that auto-shutdown will get ini‐
75 tiated if all queues generated by cups-browsed are without jobs.
76 --autoshutdown-timeout=timeout
78 timeout tells after how many seconds cups-browsed should shut
79 down if it has no local queues set up for any discovered remote
80 printer any more or jobs on these. Default is 30 seconds. 0
81 means immediate shutdown.
82 -h, --help, --version
84 Display usage and version info and do not start the daemon.
85
87 /etc/cups/cups-browsed.conf
88
90 SIGINT, SIGTERM: cups-browsed will shutdown.
91 SIGUSR1: Switches cups-browsed into permanent mode (no auto shutdown).
93 SIGUSR2: Switches cups-browsed into auto shutdown mode.
95
98 Please take references to cups 1.6.x to include newer versions. Simi‐
99 larly, cups 1.5.x is intended to encompass older versions too.
100 In environments with only cups 1.6.x servers and clients (plus cups-
102 browsed on either server or client or both) the function described in
103 1. enables the automatic discovery of remote queues and their display
104 in printing dialogues of applications and with command line tools.
105 The facility provided by 3. allows printers that are registered in an
107 LDAP server to be added as local queues. CUPS servers 1.5.x are able to
108 automatically register printers in LDAP. The facility provided by cups-
109 browsed allows a filter string to further limit the printers that are
110 browsed from LDAP.
111 The facility provided by 4. means that servers running cups 1.6.x plus
113 cups-browsed can broadcast their local queues so that clients with cups
114 1.5.x get these queues automatically available. The outcome of 2. is
115 that clients running cups 1.6.x plus cups-browsed can use the CUPS
116 broadcasts from servers with cups 1.5.x. As with browsing of Bonjour
117 broadcasts, the created local raw queues are available to applications
118 and command line tools.
119 This manual page was written for the Debian Project, but it may be used
121 by others.
122
124 cups-browsed.conf(5)
125 29 June 2013 cups-browsed(8)