File rinetd.doc.dif of Package rinetd
--- 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 @@ <p> <font color="#FF8888" size="4">VERSION</font> <p> -Version 0.61, 3/1/1999. +Version 0.61+syslog+bind, 11/29/2000. <p> <font color="#FF8888" size="4">WHERE TO GET</font> <p> @@ -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. <p> +The optional sourceaddress can be used to bind to a specific local +address for the outgoing connection. +<p> <font color="#FF8888" size="4">ALLOW AND DENY RULES</font> <p> Configuration files can also contain allow and deny rules. @@ -144,8 +147,9 @@ <p> <font color="#FF8888" size="4">LOGGING</font> <p> -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. <p> 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> <p> +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 +<p> +Example2: +<pre> +syslog +</pre> +in this case everything goes to daemon info +<p> +Example3: +<pre> +syslog wrongfacility wrongpriority +</pre> +logging to default: daemon info +<p> +If configured, the local source address is given in square brackets +after the "listening host" entry. +<p> <font color="#FF8888" size="4">COMMAND LINE OPTIONS</font> <p> 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> +<p> +Logging to syslog added by SuSE.<br> +Sourceaddress extension added by Lutz Pressler +<<a href="mailto:lp@SerNet.DE">lp@SerNet.DE</a href>>. <p> <font color="#FF8888" size="4">THANKS</font> <p> --- 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
