From 99ec991be9fc56b7e71836b9c9ce3a6e5874443e Mon Sep 17 00:00:00 2001
From: Paul W. Frields <stickster@gmail.com>
Date: Sun, 20 Mar 2011 20:46:07 -0400
Subject: [PATCH 01/11] Add two new pages on firewalls to include in security

---
 gnome-help/C/net-firewall-on-off.page |   37 +++++++++++++++++++++++++
 gnome-help/C/net-firewall-ports.page  |   48 +++++++++++++++++++++++++++++++++
 2 files changed, 85 insertions(+), 0 deletions(-)
 create mode 100644 gnome-help/C/net-firewall-on-off.page
 create mode 100644 gnome-help/C/net-firewall-ports.page

diff --git a/gnome-help/C/net-firewall-on-off.page b/gnome-help/C/net-firewall-on-off.page
new file mode 100644
index 0000000..ec3c8c4
--- /dev/null
+++ b/gnome-help/C/net-firewall-on-off.page
@@ -0,0 +1,37 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" style="task"
+      id="net-firewall-on-off">
+
+  <info>
+    <link type="guide" xref="net#security"/>
+    <desc>You can control what programs are accessible by the network.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-20" status="incomplete"/>
+    <credit type="author">
+      <name>Paul W. Frields</name>
+      <email>stickster@gmail.com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Enabling and blocking firewall access</title>
+  <p>Your system may be equipped with a firewall that allows it to block programs from being accessible by other network users.</p>
+  <p>Many GNOME programs are built to offer network services. For instance, you can share content, or let someone view your desktop remotely. Depending on how you installed GNOME, you may need to adjust the firewall to allow these services to work as intended. For instance, if your GNOME desktop was installed along with a larger software distribution, the firewall may also be pre-configured by the vendor.</p>
+  <p>Each program that provides services uses a specific <em>network port</em>. To enable access to that program's services, you may need to allow access to its assigned port on the firewall. To allow access, follow these steps.</p>
+
+  <steps>
+    <item>
+      <p>To locate your system's firewall tool, open the Overview, and type "firewall".</p>
+      <note>
+	<p>If this step doesn't locate the appropriate tool, consult the documentation for your overall operating system for the correct application name. To open the application, hit <keyseq type="combo"><key>Alt</key><key>F2</key></keyseq>, type that name, and hit <key>Enter</key>.</p>
+      </note>
+    </item>
+    <item>
+      <p>To allow access to the desired port number through the firewall, enable the port. To block access, disable the port. Repeat this step as needed.</p>
+    </item>
+    <item>
+      <p>Save or apply the changes, following any additional instructions given by the firewall tool.</p>
+    </item>
+  </steps>
+
+</page>
diff --git a/gnome-help/C/net-firewall-ports.page b/gnome-help/C/net-firewall-ports.page
new file mode 100644
index 0000000..9ea15b5
--- /dev/null
+++ b/gnome-help/C/net-firewall-ports.page
@@ -0,0 +1,48 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" style="task"
+      id="net-firewall-ports">
+
+  <info>
+    <link type="guide" xref="net#security"/>
+    <desc>Look at a list of programs that can be allowed through your system's firewall.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-20" status="incomplete"/>
+    <credit type="author">
+      <name>Paul W. Frields</name>
+      <email>stickster@gmail.com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Firewall port list</title>
+  <p>The following table lists ports used by your system's firewall to <link xref="net-firewall-on-off">block or allow access</link> to GNOME programs over the network. There are thousands of ports in use, so this table isn't complete. Instead, it presents some of the most common ports you may want to configure on your system. In some cases, the vendor of your GNOME desktop may have pre-configured access to these ports when the system was installed.</p>
+
+  <table>
+    <thead>
+      <tr>
+	<td>
+	  <p>Port</p>
+	</td>
+	<td>
+	  <p>Name</p>
+	</td>
+	<td>
+	  <p>Description</p>
+	</td>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+	<td>
+	  <p>5353/udp</p>
+	</td>
+	<td>
+	  <p>mDNS/Avahi</p>
+	</td>
+	<td>
+	  <p>Allows systems to find each other, and describe their service offerings, without the user having to configure it</p>
+	</td>
+      </tr>
+    </tbody>
+  </table>
+</page>
-- 
1.7.4.1