]> git.ipfire.org Git - thirdparty/cups.git/commitdiff
Add firewall documentation (Issue #5192)
authorMichael R Sweet <michaelrsweet@gmail.com>
Thu, 14 Dec 2017 14:13:09 +0000 (09:13 -0500)
committerMichael R Sweet <michaelrsweet@gmail.com>
Thu, 14 Dec 2017 14:13:09 +0000 (09:13 -0500)
CHANGES.md
doc/Makefile
doc/help/firewalls.html [new file with mode: 0644]

index e0b9d6faf0472e8692170513976df998f45d82ba..4af444dc73bebbf1cd239d5161313d9cd71683f5 100644 (file)
@@ -1,4 +1,4 @@
-CHANGES - 2.3b1 - 2017-12-11
+CHANGES - 2.3b1 - 2017-12-14
 ============================
 
 
@@ -6,7 +6,7 @@ Changes in CUPS v2.3b1
 ----------------------
 
 - CUPS is now provided under the Apache License, Version 2.0.
-- Documentation updates (Issue #4580, Issue #5177)
+- Documentation updates (Issue #4580, Issue #5177, Issue #5192)
 - The `lpoptions` command incorrectly saved default options (Issue #4717)
 - The `lpstat` command now reports when new jobs are being held (Issue #4761)
 - The `ippfind` command now supports finding printers whose name starts with an
index 735dfdb26d620f2f3cd3b6a19f9e8160c2d801b0..c297a8a8f4ae97d378a790dd377c2bf8d07202ca 100644 (file)
@@ -48,6 +48,7 @@ HELPFILES     =       \
                        help/cgi.html \
                        help/cupspm.html \
                        help/encryption.html \
+                       help/firewalls.html \
                        help/glossary.html \
                        help/kerberos.html \
                        help/license.html \
diff --git a/doc/help/firewalls.html b/doc/help/firewalls.html
new file mode 100644 (file)
index 0000000..2f60e49
--- /dev/null
@@ -0,0 +1,54 @@
+<!DOCTYPE html>
+<html>
+<!-- SECTION: Getting Started -->
+  <head>
+    <title>Firewalls</title>
+    <link rel="stylesheet" type="text/css" href="../cups-printable.css">
+  </head>
+  <body>
+    <h1 class="title">Firewalls</h1>
+
+    <p>This help document describes the ports that CUPS uses so that firewall administrators can allow traffic used for printing.</p>
+
+    <h2 class="title">Ports Used for Printer Sharing</h2>
+
+    <p>The following ports are used for printer sharing:</p>
+
+    <div class="table"><table summary="Ports Used for Printer Sharing">
+      <thead>
+        <tr><th>Port</th><th>TCP/UDP</th><th>Description</th></tr>
+      </thead>
+      <tbody>
+        <tr><td>53&nbsp;(DNS)</td><td>TCP/UDP</td><td>Domain Name System lookups and service registrations.</td></tr>
+        <tr><td>137&nbsp;(WINS)</td><td>UDP</td><td>Windows Internet Naming Service (name lookup for SMB printing).</td></tr>
+        <tr><td>139&nbsp;(SMB)</td><td>TCP</td><td>Windows SMB printing.</td></tr>
+        <tr><td>445&nbsp;(SMBDS)</td><td>TCP</td><td>Windows SMB Domain Server (authenticated SMB printing).</td></tr>
+        <tr><td>631&nbsp;(IPP/IPPS)</td><td>TCP</td><td>Internet Printing Protocol requests and responses (print jobs, status monitoring, etc.)</td></tr>
+        <tr><td>5353&nbsp;(mDNS)</td><td>UDP</td><td>Multicast DNS lookups and service registrations.</td></tr>
+      </tbody>
+    </table></div>
+
+
+    <h2 class="title">Ports Used for Network Printers</h2>
+
+    <p>The following ports are used for network printers:</p>
+
+    <div class="table"><table summary="Ports Used for Network Printers">
+      <thead>
+        <tr><th>Port(s)</th><th>TCP/UDP</th><th>Description</th></tr>
+      </thead>
+      <tbody>
+        <tr><td>53&nbsp;(DNS)</td><td>TCP/UDP</td><td>Domain Name System lookups.</td></tr>
+        <tr><td>137&nbsp;(WINS)</td><td>UDP</td><td>Windows Internet Naming Service (name lookup for SMB printing).</td></tr>
+        <tr><td>139&nbsp;(SMB)</td><td>TCP</td><td>Windows SMB printing.</td></tr>
+        <tr><td>161&nbsp;(SNMP)</td><td>UDP</td><td>SNMP browsing (broadcast) and status monitoring (directed to printer IP address).</td></tr>
+        <tr><td>443&nbsp;(IPPS)</td><td>TCP</td><td>Internet Printing Protocol requests and responses (print jobs, status monitoring, etc.)</td></tr>
+        <tr><td>445&nbsp;(SMBDS)</td><td>TCP</td><td>Windows SMB Domain Server (authenticated SMB printing).</td></tr>
+        <tr><td>515&nbsp;(LPD)</td><td>TCP</td><td>Line Printer Daemon (LPD/lpr) print job submission and status monitoring.</td></tr>
+        <tr><td>631&nbsp;(IPP/IPPS)</td><td>TCP</td><td>Internet Printing Protocol requests and responses (print jobs, status monitoring, etc.)</td></tr>
+        <tr><td>5353&nbsp;(mDNS)</td><td>UDP</td><td>Multicast DNS lookups.</td></tr>
+        <tr><td>9100-9102</td><td>TCP</td><td>Raw print data stream (AppSocket/JetDirect).</td></tr>
+      </tbody>
+    </table></div>
+  </body>
+</html>