]> git.etc.gen.nz Git - spong.git/commitdiff
added TCP Wrappers documentation
authorStephen L Johnson <sjohnson@monsters.org>
Tue, 18 Dec 2001 15:42:21 +0000 (15:42 +0000)
committerStephen L Johnson <sjohnson@monsters.org>
Tue, 18 Dec 2001 15:42:21 +0000 (15:42 +0000)
pod/admin-guide.pod
pod/spong-server.pod

index 68bdf58bba20fda0ec03f89112148e26981ce573..5056219554d82010bd4395ae9ea222ea37c98790 100755 (executable)
@@ -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.
index 0d7a5702860b490c5f665a47a54f0e4b8eca859a..8980bee28b11b8618a25e4a1c4f003ca32f32c15 100644 (file)
@@ -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>: