1cups-browsed(8)                                                cups-browsed(8)
2
3
4

NAME

6       cups-browsed  - A daemon for browsing the Bonjour broadcasts of shared,
7       remote CUPS printers
8

SYNOPSIS

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
15

DESCRIPTION

17       cups-browsed has four independently switchable functions:
18
19       1.  Browse Bonjour broadcasts  of  remote  printers  and  create/remove
20           local raw queues pointing to these printers.
21
22       2.  Browse  CUPS  broadcasts of remote printers and create/remove local
23           raw queues pointing to these printers.
24
25       3.  Browse an LDAP server for  printers  and  create/remove  local  raw
26           queues pointing to these printers.
27
28       4.  Broadcast local queues with the CUPS protocol.
29
30       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
35       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
41

OPTIONS

43       -v, -d, --debug
44              Debug mode, verbose logging to stderr
45
46       -l, --logfile
47              Debug logging into /var/log/cups/cups-browsed_log file.
48
49       -c config-file
50              Uses the alternative configuration file config-file  instead  of
51              the standard one.
52
53       -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
63       --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
70       --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
77       --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
83       -h, --help, --version
84              Display usage and version info and do not start the daemon.
85

FILES

87       /etc/cups/cups-browsed.conf
88

SIGNALS

90       SIGINT, SIGTERM: cups-browsed will shutdown.
91
92       SIGUSR1: Switches cups-browsed into permanent mode (no auto shutdown).
93
94       SIGUSR2: Switches cups-browsed into auto shutdown mode.
95
96

NOTES

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
101       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
106       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
112       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

SEE ALSO

121       cups-browsed.conf(5)
122
123       /usr/share/doc/cups-filters/README.gz
124

AUTHOR

126       The  authors  of  cups-browsed  are  listed in /usr/share/doc/cups-fil‐
127       ters/AUTHORS.
128
129       This manual page was written for the Debian Project, but it may be used
130       by others.
131
132
133
134                                 29 June 2013                  cups-browsed(8)
Impressum