From 0b1971844fe816f9074aa4392d2a57c392029348 Mon Sep 17 00:00:00 2001 From: Stephen L Johnson Date: Tue, 18 Dec 2001 15:42:21 +0000 Subject: [PATCH] added TCP Wrappers documentation --- pod/admin-guide.pod | 31 ++++++++++++++++++++++++++++++- pod/spong-server.pod | 40 +++++++++++++++++++++++++++++++++++++--- 2 files changed, 67 insertions(+), 4 deletions(-) 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 from in the F directory of the Spong distribution. Just run it from a command line by entering C 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. +will advise you on ways to fix the problem. See also Question 2 in the L. =head2 Installation - Client @@ -218,6 +218,35 @@ configuration line: =back +=head2 TCP Wrappers + +The B 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 Perl module must be +installed on the Spong Server host. The F module can be found +in the Comprehensive Perl Archive Network (http://www.cpan.org/). + +The service names for the F and F 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 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. + +=head2 TCP Wrappers + +The B 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 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: - 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: -- 2.30.2