From 5b47cadf23864daed42bdcc9e39032ba455763a8 Mon Sep 17 00:00:00 2001 From: Jiri Popelka Date: Mon, 1 Jul 2013 14:17:35 +0200 Subject: [PATCH] add cups-browsed(8) and cups-browsed.conf(5) --- cups-filters-man.patch | 179 +++++++++++++++++++++++++++++++++++++++++ cups-filters.spec | 10 ++- 2 files changed, 188 insertions(+), 1 deletion(-) create mode 100644 cups-filters-man.patch diff --git a/cups-filters-man.patch b/cups-filters-man.patch new file mode 100644 index 0000000..efc5011 --- /dev/null +++ b/cups-filters-man.patch @@ -0,0 +1,179 @@ +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. diff --git a/cups-filters.spec b/cups-filters.spec index f4d0315..8d61982 100644 --- a/cups-filters.spec +++ b/cups-filters.spec @@ -4,7 +4,7 @@ Summary: OpenPrinting CUPS filters and backends Name: cups-filters Version: 1.0.35 -Release: 1%{?dist} +Release: 2%{?dist} # For a breakdown of the licensing, see COPYING file # GPLv2: filters: commandto*, imagetoraster, pdftops, rasterto*, @@ -22,6 +22,8 @@ Url: http://www.linuxfoundation.org/collaborate/workgroups/openprinting/cups Source0: http://www.openprinting.org/download/cups-filters/cups-filters-%{version}.tar.xz Source1: cups-browsed.service +Patch1: cups-filters-man.patch + Requires: cups-filters-libs%{?_isa} = %{version}-%{release} # Obsolete cups-php (bug #971741) @@ -95,6 +97,7 @@ This is the development package for OpenPrinting CUPS filters and backends. %prep %setup -q +%patch1 -p1 -b .man %build # work-around Rpath @@ -186,6 +189,8 @@ fi %{_datadir}/ppd/cupsfilters %{_sbindir}/cups-browsed %{_unitdir}/cups-browsed.service +%{_mandir}/man8/cups-browsed.8.gz +%{_mandir}/man5/cups-browsed.conf.5.gz %files libs %doc __doc/COPYING fontembed/README @@ -201,6 +206,9 @@ fi %{_libdir}/libfontembed.so %changelog +* Mon Jul 01 2013 Jiri Popelka - 1.0.35-2 +- add cups-browsed(8) and cups-browsed.conf(5) + * Wed Jun 26 2013 Jiri Popelka - 1.0.35-1 - 1.0.35