180 lines
5.8 KiB
Diff
180 lines
5.8 KiB
Diff
|
diff -up cups-filters-1.0.35/Makefile.am.man cups-filters-1.0.35/Makefile.am
|
||
|
--- cups-filters-1.0.35/Makefile.am.man 2013-05-15 20:46:22.000000000 +0200
|
||
|
+++ cups-filters-1.0.35/Makefile.am 2013-07-01 14:03:58.395572035 +0200
|
||
|
@@ -618,7 +618,6 @@ EXTRA_DIST += \
|
||
|
# UTILS
|
||
|
# =====
|
||
|
|
||
|
-EXTRA_DIST += utils/cups-browsed.in
|
||
|
sbin_PROGRAMS = \
|
||
|
cups-browsed
|
||
|
cups_browsed_SOURCES = \
|
||
|
@@ -636,6 +635,11 @@ cups_browsed_LDADD = \
|
||
|
$(GLIB_LIBS)
|
||
|
initrcdir = $(INITDDIR)
|
||
|
initrc_SCRIPTS = utils/cups-browsed
|
||
|
+man_MANS = \
|
||
|
+ utils/cups-browsed.8 \
|
||
|
+ utils/cups-browsed.conf.5
|
||
|
+EXTRA_DIST += utils/cups-browsed.in \
|
||
|
+ $(man_MANS)
|
||
|
|
||
|
# ===
|
||
|
# PPD
|
||
|
diff -up cups-filters-1.0.35/utils/cups-browsed.8.man cups-filters-1.0.35/utils/cups-browsed.8
|
||
|
--- cups-filters-1.0.35/utils/cups-browsed.8.man 2013-07-01 14:03:58.404571910 +0200
|
||
|
+++ cups-filters-1.0.35/utils/cups-browsed.8 2013-07-01 14:03:58.404571910 +0200
|
||
|
@@ -0,0 +1,56 @@
|
||
|
+.\"Text automatically generated by txt2man
|
||
|
+.TH cups-browsed 8 "29 June 2013" "" ""
|
||
|
+.SH NAME
|
||
|
+\fBcups-browsed \fP- A daemon for browsing the Bonjour broadcasts of shared, remote CUPS printers
|
||
|
+\fB
|
||
|
+.SH SYNOPSIS
|
||
|
+.nf
|
||
|
+.fam C
|
||
|
+\fBcups-browsed\fP [\fB-v\fP | \fB-d\fP | \fB--debug\fP]
|
||
|
+
|
||
|
+.fam T
|
||
|
+.fi
|
||
|
+.fam T
|
||
|
+.fi
|
||
|
+.SH DESCRIPTION
|
||
|
+\fBcups-browsed\fP has three independently switchable functions:
|
||
|
+.IP 1. 4
|
||
|
+Browse Bonjour broadcasts of remote printers and create/remove local
|
||
|
+raw queues pointing to these printers.
|
||
|
+.IP 2. 4
|
||
|
+Browse CUPS broadcasts of remote printers and create/remove local raw
|
||
|
+queues pointing to these printers.
|
||
|
+.IP 3. 4
|
||
|
+Broadcast local queues with the CUPS protocol.
|
||
|
+.SH OPTIONS
|
||
|
+.TP
|
||
|
+.B
|
||
|
+\fB-v\fP, \fB-d\fP, \fB--debug\fP
|
||
|
+Debug mode
|
||
|
+.SH FILES
|
||
|
+/etc/cups/cups-browsed.conf
|
||
|
+.SH NOTES
|
||
|
+Please take references to cups 1.6.x to include newer versions.
|
||
|
+Similarily, cups 1.5.x is intended to encompass older versions too.
|
||
|
+.PP
|
||
|
+In environments with only cups 1.6.x servers and clients (plus
|
||
|
+\fBcups-browsed\fP on either server or client or both) the function described in 1.
|
||
|
+enables the automatic discovery of remote queues and their display in
|
||
|
+printing dialogues of applications and with command line tools.
|
||
|
+.PP
|
||
|
+The facility provided by 3. means that servers running cups 1.6.x plus
|
||
|
+\fBcups-browsed\fP can broadcast their local queues so that clients with cups
|
||
|
+1.5.x get these queues automatically available. The outcome of 2. is
|
||
|
+that clients running cups 1.6.x plus \fBcups-browsed\fP can use the CUPS
|
||
|
+broadcasts from servers with cups 1.5.x. As with browsing of Bonjour
|
||
|
+broadcasts, the created local raw queues are available to applications
|
||
|
+and command line tools.
|
||
|
+.SH SEE ALSO
|
||
|
+
|
||
|
+\fBcups-browsed.conf\fP(5)
|
||
|
+.PP
|
||
|
+/usr/share/doc/\fBcups-filters\fP/README
|
||
|
+.SH AUTHOR
|
||
|
+The authors of \fBcups-browsed\fP are listed in /usr/share/doc/\fBcups-filters\fP/AUTHORS.
|
||
|
+.PP
|
||
|
+This manual page was written for the Debian Project, but it may be used by others.
|
||
|
diff -up cups-filters-1.0.35/utils/cups-browsed.conf.5.man cups-filters-1.0.35/utils/cups-browsed.conf.5
|
||
|
--- cups-filters-1.0.35/utils/cups-browsed.conf.5.man 2013-07-01 14:03:58.404571910 +0200
|
||
|
+++ cups-filters-1.0.35/utils/cups-browsed.conf.5 2013-07-01 14:03:58.404571910 +0200
|
||
|
@@ -0,0 +1,92 @@
|
||
|
+.\"Text automatically generated by txt2man
|
||
|
+.TH cups-browsed.conf 5 "29 June 2013" "" ""
|
||
|
+.SH NAME
|
||
|
+\fBcups-browsed.conf \fP- server configuration file for cups-browsed
|
||
|
+\fB
|
||
|
+.SH 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.
|
||
|
+.SH 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.
|
||
|
+.PP
|
||
|
+.nf
|
||
|
+.fam C
|
||
|
+ BrowseAllow 192.168.7.20
|
||
|
+ BrowseAllow 192.168.7.0/24
|
||
|
+ BrowseAllow 192.168.7.0/255.255.255.0
|
||
|
+
|
||
|
+
|
||
|
+.fam T
|
||
|
+.fi
|
||
|
+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.
|
||
|
+.PP
|
||
|
+.nf
|
||
|
+.fam C
|
||
|
+ BrowsePoll 192.168.7.20
|
||
|
+ BrowsePoll 192.168.7.65:631
|
||
|
+ BrowsePoll host.example.com:631
|
||
|
+
|
||
|
+
|
||
|
+.fam T
|
||
|
+.fi
|
||
|
+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.
|
||
|
+.PP
|
||
|
+.nf
|
||
|
+.fam C
|
||
|
+ BrowseLocalProtocols none
|
||
|
+ BrowseLocalProtocols CUPS
|
||
|
+
|
||
|
+
|
||
|
+.fam T
|
||
|
+.fi
|
||
|
+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".
|
||
|
+.PP
|
||
|
+.nf
|
||
|
+.fam C
|
||
|
+ BrowseRemoteProtocols none
|
||
|
+ BrowseRemoteProtocols CUPS dnssd
|
||
|
+ BrowseRemoteProtocols CUPS
|
||
|
+ BrowseRemoteProtocols dnssd
|
||
|
+
|
||
|
+.fam T
|
||
|
+.fi
|
||
|
+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.
|
||
|
+.PP
|
||
|
+.nf
|
||
|
+.fam C
|
||
|
+ BrowseProtocols none
|
||
|
+ BrowseProtocols CUPS dnssd
|
||
|
+ BrowseProtocols CUPS
|
||
|
+ BrowseProtocols dnssd
|
||
|
+
|
||
|
+.fam T
|
||
|
+.fi
|
||
|
+.SH SEE ALSO
|
||
|
+
|
||
|
+\fBcups-browsed\fP(8)
|
||
|
+.PP
|
||
|
+/usr/share/doc/cups-filters/README
|
||
|
+.SH AUTHOR
|
||
|
+The authors of cups-browsed are listed in /usr/share/doc/cups-filters/AUTHORS.
|
||
|
+.PP
|
||
|
+This manual page was written for the Debian Project, but it may be used by others.
|