From: Stephen L Johnson <sjohnson@monsters.org>
Date: Tue, 18 Dec 2001 15:42:21 +0000 (+0000)
Subject: added TCP Wrappers documentation
X-Git-Tag: spong-2_7_7~29
X-Git-Url: http://git.etc.gen.nz/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0b1971844fe816f9074aa4392d2a57c392029348;p=spong.git

added TCP Wrappers documentation
---

diff --git a/pod/admin-guide.pod b/pod/admin-guide.pod
index 68bdf58..5056219 100755
--- a/pod/admin-guide.pod
+++ b/pod/admin-guide.pod
@@ -86,7 +86,7 @@ domain name. To do this check there is a little Perl test program
 B<gethost-test> from in the F</utils> directory of the Spong distribution. Just
 run it from a command line by entering C<perl gethost-test.> It tests to see is
 the host can resolve it's fully qualified domain name.  If it can't then it
-will advise you on ways to fix the problem. See also Question 2 in the L<Admininistration Guide|admin-guide>.
+will advise you on ways to fix the problem. See also Question 2 in the L<Spong FAQ|spong-faq>.
 
 =head2 Installation - Client
 
@@ -218,6 +218,35 @@ configuration line:
 
 =back
 
+=head2 TCP Wrappers
+
+The B<spong-server> can use the TCP Wrappers library to validate incoming
+connection. The use of TCP Wrappers is optional. It is not required.
+
+To use the TCP Wrappers library, the F<Authen::Libwrap> Perl module must be
+installed on the Spong Server host. The F<Authen::Libwrap> module can be found
+in the Comprehensive Perl Archive Network (http://www.cpan.org/). 
+
+The service names for the F<hosts_allow> and F<hosts_deny> files are as follows
+
+=over
+
+=item spong-update
+
+The service that Spong Client programs use to send status update messages.
+
+=item spong-bb-update
+
+The Big Brother (http://bb4.com) Server Emulation. BB Clients use this service
+for sending status update messages.
+
+=item spong-query
+
+Service that Spong Display clients use for Spong Database queries
+
+=over
+
+
 =head1 DEBUGGING
 
 The general way to debug Spong programs is to use the B<--debug #> parameter.
diff --git a/pod/spong-server.pod b/pod/spong-server.pod
index 0d7a570..8980bee 100644
--- a/pod/spong-server.pod
+++ b/pod/spong-server.pod
@@ -80,6 +80,43 @@ complete package that utilizes data modules.
 
 =head2 Big Brother (BBSERVER) Emulation
 
+The Spong Server has a partial Big Brother ( http://bb4.com/ ) server emulation
+mode. This also Big Brother Clients to be used with Spong. The emulation mode
+is enabled by configuring the I<$SPONG_BB_UPDATE_PORT> parameter in the
+F<spong.conf> configuration file.
+
+Note: The Spong BBSERVER Emulation mode only supports status messages from
+Big Brother Client programs. Alert messages are not supported and are silently
+ignored by the B<spong-server>.
+
+=head2 TCP Wrappers
+
+The B<spong-server> can use the TCP Wrappers Library. The TCP Wrappers Library
+implements a rules-based access control languguage. This allows incoming
+connection to be validated by host names and/or IP addresses.
+
+To use TCP Wrappers, the libwrap.a library and the Authen::Libwrap Perl module
+must be installed. The Authen::Libwrap module be found in the Comprehensive
+Perl Archive Network (CPAN). See http://cpan.org/. 
+
+The names for the various B<spong-server> services are as follows:
+
+=over
+
+=item 
+
+spong-update: Status message update service
+
+=item
+
+spong-bb-update: Big Brother Server Emulation service
+
+=item
+
+spong-query: Spong Database query service
+
+=back
+
 =head1 CONFIGURATION
 
 =head2 Configuration Files
@@ -118,7 +155,6 @@ host groups to filter and format the data returned in database queries.
 
 From F<spong.conf>:
 
-
 Yes there are a lot of variables. But all of the variables have defined
 default values. Most of these variables are used customizing the client
 web and text interfaces.
@@ -205,8 +241,6 @@ hosts in History displays display clients. Otherwise only the first element of
 the FQDN will be displayed. If the host has a 'display_name' attribute, it will
 be used in preference to the FQDN names.
 
-
-
 =back
 
 From F<spong.hosts>: