Gecko [ 122.154.134.11 ]

Name	Size	Permission
accounting.html	2.53 KB	-r--r--r--
api-array.html	32.95 KB	-r--r--r--
api-cgi.html	32.93 KB	-r--r--r--
api-cups.html	88.38 KB	-r--r--r--
api-driver.html	35.72 KB	-r--r--r--
api-filedir.html	32.22 KB	-r--r--r--
api-filter.html	46.11 KB	-r--r--r--
api-httpipp.html	160.97 KB	-r--r--r--
api-mime.html	21.68 KB	-r--r--r--
api-overview.html	11.27 KB	-r--r--r--
api-ppd.html	82.86 KB	-r--r--r--
api-ppdc.html	63.67 KB	-r--r--r--
api-raster.html	50.05 KB	-r--r--r--
cgi.html	2.46 KB	-r--r--r--
glossary.html	2.72 KB	-r--r--r--
kerberos.html	4.17 KB	-r--r--r--
license.html	48.75 KB	-r--r--r--
man-backend.html	5.71 KB	-r--r--r--
man-cancel.html	2.17 KB	-r--r--r--
man-cups-config.html	2.49 KB	-r--r--r--
man-cups-lpd.html	4.41 KB	-r--r--r--
man-cups-polld.html	1.37 KB	-r--r--r--
man-cupsaccept.html	2.51 KB	-r--r--r--
man-cupsaddsmb.html	6.65 KB	-r--r--r--
man-cupsd.html	2.58 KB	-r--r--r--
man-cupsenable.html	2.84 KB	-r--r--r--
man-cupstestdsc.html	1.72 KB	-r--r--r--
man-cupstestppd.html	3.93 KB	-r--r--r--
man-drv.html	1.31 KB	-r--r--r--
man-filter.html	7.47 KB	-r--r--r--
man-lp.html	6.96 KB	-r--r--r--
man-lpadmin.html	6.87 KB	-r--r--r--
man-lpc.html	2.4 KB	-r--r--r--
man-lpinfo.html	2.91 KB	-r--r--r--
man-lpmove.html	1.59 KB	-r--r--r--
man-lpoptions.html	3.61 KB	-r--r--r--
man-lppasswd.html	2.14 KB	-r--r--r--
man-lpq.html	1.96 KB	-r--r--r--
man-lpr.html	3.49 KB	-r--r--r--
man-lprm.html	1.9 KB	-r--r--r--
man-lpstat.html	3.86 KB	-r--r--r--
man-mime.convs.html	1.69 KB	-r--r--r--
man-mime.types.html	4.09 KB	-r--r--r--
man-notifier.html	4.29 KB	-r--r--r--
man-ppdc.html	2.59 KB	-r--r--r--
man-ppdhtml.html	1.27 KB	-r--r--r--
man-ppdi.html	1.34 KB	-r--r--r--
man-ppdmerge.html	1.32 KB	-r--r--r--
man-ppdpo.html	1.48 KB	-r--r--r--
network.html	26.99 KB	-r--r--r--
options.html	23.18 KB	-r--r--r--
overview.html	3.46 KB	-r--r--r--
policies.html	20.83 KB	-r--r--r--
postscript-driver.html	21.14 KB	-r--r--r--
ppd-compiler.html	42.79 KB	-r--r--r--
raster-driver.html	18.22 KB	-r--r--r--
ref-access_log.html	4.38 KB	-r--r--r--
ref-classes-conf.html	13.72 KB	-r--r--r--
ref-client-conf.html	2.08 KB	-r--r--r--
ref-cupsd-conf.html	83.53 KB	-r--r--r--
ref-error_log.html	1.6 KB	-r--r--r--
ref-mailto-conf.html	2.67 KB	-r--r--r--
ref-page_log.html	2.66 KB	-r--r--r--
ref-ppdcfile.html	69.38 KB	-r--r--r--
ref-printers-conf.html	17.88 KB	-r--r--r--
ref-snmp-conf.html	3.77 KB	-r--r--r--
ref-subscriptions-conf.html	8.26 KB	-r--r--r--
security.html	5.96 KB	-r--r--r--
sharing.html	6.64 KB	-r--r--r--
spec-banner.html	4.39 KB	-r--r--r--
spec-browsing.html	4.44 KB	-r--r--r--
spec-cmp.html	37.95 KB	-r--r--r--
spec-command.html	6.42 KB	-r--r--r--
spec-design.html	13.05 KB	-r--r--r--
spec-ipp.html	81.86 KB	-r--r--r--
spec-pdf.html	861 B	-r--r--r--
spec-postscript.html	5.05 KB	-r--r--r--
spec-ppd.html	66.86 KB	-r--r--r--
spec-raster.html	18.77 KB	-r--r--r--
spec-stp.html	3.79 KB	-r--r--r--
standard.html	5.22 KB	-r--r--r--
translation.html	22.96 KB	-r--r--r--
whatsnew.html	11.12 KB	-r--r--r--

Code Editor : spec-browsing.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>

<head>
	<title>CUPS Browse Protocol</title>
	<meta name='keywords' content='Programming'>
	<LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
</head>
<body>
<!--
  "$Id: spec-browsing.html 8653 2009-05-16 23:53:28Z mike $"

CUPS Browse Protocol specification for the Common UNIX Printing System (CUPS).

These coded instructions, statements, and computer programs are the
  property of Apple Inc. and are protected by Federal copyright
  law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  which should have been included with this file.  If this file is
  file is missing or damaged, see the license at "http://www.cups.org/".
-->

<H1 CLASS="title">CUPS Browse Protocol</H1>

<h2><a name='INTRO'>Introduction</a></h2>

<p>This specification describes the CUPS browsing protocol which is used for
printer sharing. The protocol is a UDP/IP-based broadcast service that
operates on IP service port 631 by default. Each broadcast packet describes
a single printer or class being shared.</p>

<p>For simple networks with a single subnet, a CUPS system sharing a printer
(the <em>server</em>) will periodically broadcast that printer's availability
and status information to the subnet. Every other CUPS system on the subnet
(the <em>clients</em>) will receive the broadcast and make that printer
available to local users. If a client stops receiving broadcasts from the
server, or if the server sends a special "deleted" broadcast message, the
client will remove its copy of the printer.</p>

<p>For larger networks with multiple subnets, a relay configuration can be used
where one or more client systems poll the server and then broadcast the
availability and status information for the server's shared printers to the
clients' local subnets.</p>

<p>A key feature of CUPS printer sharing is support for <em>implicit
classes</em>, which are automatically-created classes for printers that are
shared by multiple servers. These implicit classes provide automatic load
balancing and fail-safe printing functionality transparently to the user.</p>

<h2><a name='SECURITY'>Security Considerations</a></h2>

<p>Like most discovery protocols, CUPS browse packets are not encrypted or
signed, so it is possible for malicious systems on a network to advertise
or remove printers on that network to cause denial of service or information
disclosure. In order to combat this, CUPS logs incoming browse packets and
provides access controls to limit browse packet reception to known hosts.</p>

<h2><a name='FORMAT'>Browse Packet Format</a></h2>

<p>Each broadcast packet is an ASCII text string of up to 1450 bytes ending
with a line feed (0x0a). The general format is:</p>

<p class='summary'>
printer-type printer-state printer-uri "printer-location" "printer-info"
"printer-make-and-model" name=value name2=value2 ...
</p>

<p>Each of the fields contains the value of the corresponding IPP attribute.
The trailing "name=value" information is used to convey default job template
attribute values (job-sheets-default, media-default, etc.), authentication
requirements (auth-info-required), and additional IPP URI options that are
requested by the server (ipp-options).</p>

<h3>ABNF Definition</h3>

<p>The following ABNF definition [RFC4234, RFC3986] defines the format of each
browse packet:</p>

<pre class='command'>
PACKET         = TYPE WSP STATE WSP URI WSP LOCATION WSP INFO WSP
                 MAKE-AND-MODEL WSP *[ WSP ATTR-NAME "=" ATTR-VALUE ] LF

TYPE           = 1*HEXDIG

STATE          = "3" / "4" / "5"

URI            = "ipp://" ( 1*NAMECHAR / IP-literal / IPv4address )
                 [ ":" 1*DIGIT ] ( "/printers/" / "/classes/" ) 1*NAMECHAR
NAMECHAR       = %x21.22.24.26-2E.30-7E / %x25 HEXDIG HEXDIG
IP-literal     = See RFC 3986
IPv4address    = See RFC 3986

LOCATION       = QUOTED-STRING
INFO           = QUOTED-STRING
MAKE-AND-MODEL = QUOTED-STRING

ATTR-NAME      = 1*( ALPHA / DIGIT / "-" / "." )
ATTR-VALUE     = QUOTED-STRING / 1*UNQUOTE-CHAR

QUOTED-STRING  = DQUOTE *QUOTED-CHAR DQUOTE
QUOTED-CHAR    = %x20.21.23-5B.5D-7E / UTF8-CHAR / %x5C %x5C / %x5C %x22
UNQUOTE-CHAR   = %x21.23-26.28-5B.5D-7E / UTF8-CHAR
UTF8-CHAR      = %xC0.DF %x80.BF / %xE0.EF %x80.BF %x80.BF /
                 %xF0.F7 %x80.BF %x80.BF %x80.BF
</pre>

</body>
</html>

${this.title}

Code Editor : spec-browsing.html