rpms/cups-filters
7
0
Fork 0
Code Issues Pull Requests Releases Activity

add cups-browsed(8) and cups-browsed.conf(5)

Browse Source
This commit is contained in:
Jiri Popelka 2013-07-01 14:17:35 +02:00
parent 3c0d9c76ee
commit 5b47cadf23
2 changed files with 188 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

179
cups-filters-man.patch Normal file
View File

@ -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.

10
cups-filters.spec
View File

@ -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 <jpopelka@redhat.com> - 1.0.35-2
- add cups-browsed(8) and cups-browsed.conf(5)
* Wed Jun 26 2013 Jiri Popelka <jpopelka@redhat.com> - 1.0.35-1
- 1.0.35