openSUSE Build Service

Overview Repositories Revisions Requests Users Attributes Meta

File rinetd.doc.dif of Package rinetd (Revision 07bb6091ea0699c547b9691ef3b30dee)

Currently displaying revision 07bb6091ea0699c547b9691ef3b30dee , Show latest

--- CHANGES
+++ CHANGES	2001/03/09 17:34:48
@@ -46,3 +46,11 @@
 Version 0.61: fixed a bug in 0.6 which completely
 broke rinetd under Linux. Oops.
 
+Version 0.61+syslog: added logging to syslog
+support (SuSE)
+
+Version 0.61+syslog+bind: added optional
+sourceaddress column in configuration file to bind
+to a specific local address for outgoing connections
+(Lutz Pressler, <lp@SerNet.DE>)
+
--- index.html
+++ index.html	2001/03/09 17:34:48
@@ -26,7 +26,7 @@
 
 VERSION
 
-Version 0.61, 3/1/1999.
+Version 0.61+syslog+bind, 11/29/2000.
 
 WHERE TO GET
 
@@ -64,7 +64,7 @@
 Most entries in the configuration file are forwarding rules. The
 format of a forwarding rule is as follows:
 <pre>
-bindaddress bindport connectaddress connectport
+bindaddress bindport connectaddress connectport [sourceaddress]
 </pre>
 For example:
 <pre>
@@ -94,6 +94,9 @@
 Both IP addresses and hostnames are accepted for
 bindaddress and connectaddress.
 
+The optional sourceaddress can be used to bind to a specific local
+address for the outgoing connection.
+
 ALLOW AND DENY RULES
 
 Configuration files can also contain allow and deny rules. 
@@ -144,8 +147,9 @@
 
 LOGGING
 
-rinetd is able to produce a log file in either of two formats:
-tab-delimited and web server-style "common log format."
+rinetd is able to produce a log output in three ways:
+tab-delimited , web server-style "common log format." both are file-based
+or as syslog output. 
 
 By default, rinetd does not produce a log file. To activate logging, add 
 the following line to the configuration file:
@@ -182,6 +186,33 @@
 logcommon
 </pre>
 
+To activate syslog output enter the following line to the 
+configuration file:
+<pre> 
+syslog facility priority
+</pre> 
+Example1:
+<pre> 
+syslog local0 info
+</pre> 
+in this case all output is logged to the destination configured
+in your syslogd config for facility local0 and priority info
+
+Example2:
+<pre>
+syslog
+</pre>
+in this case everything goes to daemon info
+ 
+Example3:
+<pre> 
+syslog wrongfacility wrongpriority
+</pre> 
+logging to default: daemon info
+
+If configured, the local source address is given in square brackets
+after the "listening host" entry.
+
 COMMAND LINE OPTIONS
 
 The -c command line option is used to specify an alternate
@@ -228,6 +259,10 @@
 for the latest release.
 Thomas Boutell can be reached by email: 
 <a href="mailto:boutell@boutell.com">boutell@boutell.com</a>
+
+Logging to syslog added by SuSE. 
+Sourceaddress extension added by Lutz Pressler
+<<a href="mailto:lp@SerNet.DE">lp@SerNet.DE</a href>>.
 
 THANKS
 
--- rinetd.8
+++ rinetd.8	2001/03/09 17:48:32
@@ -12,12 +12,12 @@
 .Sh SYNOPSIS
 .Nm /usr/sbin/rinetd
 .Sh VERSION
-Version 0.61, 3/1/1999.
+Version 0.61+syslog+bind, 11/29/2000.
 .Sh DESCRIPTION
 .Nm rinetd
 redirects TCP connections from one IP address and port to another. rinetd
 is a single-process server which handles any number of connections to
-the address/port pairs specified in the file /etc/rinetd.conf. 
+the address/port pairs specified in the file /etc/rinetd.conf.
 Since rinetd runs as a single process using nonblocking I/O, it is
 able to redirect a large number of connections without a severe
 impact on the machine. This makes it practical to run TCP services
@@ -34,7 +34,7 @@
 Most entries in the configuration file are forwarding rules. The
 format of a forwarding rule is as follows:
 .Pp
-bindaddress bindport connectaddress connectport
+bindaddress bindport connectaddress connectport [sourceaddress]
 .Pp
 For example:
 .Pp
@@ -64,6 +64,9 @@
 Both IP addresses and hostnames are accepted for
 bindaddress and connectaddress.
 .Pp
+The optional sourceaddress can be used to bind to a specific local
+address for the outgoing connection.
+.Pp
 .Sh ALLOW AND DENY RULES
 Configuration files can also contain allow and deny rules. 
 .Pp
@@ -82,7 +85,7 @@
 .Pp
 Deny rules which appear before the first forwarding rule are
 applied globally: if the address of a new connection satisfies
-any of the global allow rules, that connection
+any of the global deny rules, that connection
 is immediately rejected, regardless of any other rules. 
 .Pp
 Deny rules which appear after a specific forwarding rule apply 
@@ -111,8 +114,9 @@
 connections would be forced to pause during the address lookup.
 .Pp
 .Sh LOGGING
-rinetd is able to produce a log file in either of two formats:
-tab-delimited and web server-style "common log format."
+rinetd is able to produce a log output in three ways:
+tab-delimited , web server-style "common log format." both are file-based
+or as syslog output. 
 .Pp
 By default, rinetd does not produce a log file. To activate logging, add 
 the following line to the configuration file:
@@ -146,6 +150,34 @@
 add the following line to the configuration file:
 .Pp
 logcommon
+
+to activate syslog output enter the following line to the 
+configuration file:
+
+syslog facility priority
+
+Example1:
+
+syslog local0 info
+
+in this case all output is logged to the destination configured
+in your syslogd config for facility local0 and priority info
+
+Example2:
+
+syslog
+
+in this case everything goes to daemon info
+
+Example3:
+
+syslog wrongfacility wrongpriority
+
+logging to default: daemon info
+
+.Pp
+If configured, the local source address is given in square brackets
+after the "listening host" entry.
 .Sh COMMAND LINE OPTIONS
 The -c command line option is used to specify an alternate
 configuration file.
@@ -184,6 +216,9 @@
 .Sh CONTACT INFORMATION
 See http://www.boutell.com/rinetd/ for the latest release.
 Thomas Boutell can be reached by email: boutell@boutell.com
+.Pp
+Logging to syslog added by SuSE.
+Sourceaddress extension added by Lutz Pressler <lp@SerNet.DE>.
 .Sh THANKS
 Thanks are due to Bill Davidsen, Libor Pechachek, Sascha Ziemann, the
 Apache Group, and many others who have contributed advice

Places

File rinetd.doc.dif of Package rinetd (Revision 07bb6091ea0699c547b9691ef3b30dee)

Places