Fix some errors, and document new option.

[fwd] / fw.1

diff --git a/fw.1 b/fw.1
index 885d5b9..2d23b0d 100644 (file)
--- a/fw.1
+++ b/fw.1
@@ -1,6 +1,6 @@
 .\" -*-nroff-*-
 .\"
 .\" -*-nroff-*-
 .\"

-.\" $Id: fw.1,v 1.6 1999/10/10 16:46:29 mdw Exp $
+.\" $Id: fw.1,v 1.8 1999/12/22 15:44:43 mdw Exp $

 .\"
 .\" Manual page for fw
 .\"
 .\"
 .\" Manual page for fw
 .\"


@@ -28,6 +28,12 @@
 .\" ---- Revision history ---------------------------------------------------
 .\" 
 .\" $Log: fw.1,v $
 .\" ---- Revision history ---------------------------------------------------
 .\" 
 .\" $Log: fw.1,v $

+.\" Revision 1.8  1999/12/22 15:44:43  mdw
+.\" Fix some errors, and document new option.
+.\"
+.\" Revision 1.7  1999/10/22 22:45:15  mdw
+.\" Describe new socket connection options.
+.\"

 .\" Revision 1.6  1999/10/10 16:46:29  mdw
 .\" Include grammar and options references at the end of the manual.
 .\"
 .\" Revision 1.6  1999/10/10 16:46:29  mdw
 .\" Include grammar and options references at the end of the manual.
 .\"


@@ -120,7 +126,7 @@ fw \- port forwarder
 .SH SYNOPSIS
 .
 .B fw
 .SH SYNOPSIS
 .
 .B fw

-.RB [ \-dq ]
+.RB [ \-dlq ]

 .RB [ \-f
 .IR file ]
 .IR config-stmt ...
 .RB [ \-f
 .IR file ]
 .IR config-stmt ...


@@ -181,6 +187,9 @@ configuration file statement.
 Forks into the background after reading the configuration and
 initializing properly.
 .TP
 Forks into the background after reading the configuration and
 initializing properly.
 .TP

+.B "\-l, \-\-syslog, \-\-log"
+Emit logging information to the system log, rather than standard error.
+.TP

 .B "-q, \-\-quiet"
 Don't output any logging information.  This option is not recommended
 for normal use, although it can make system call traces clearer so I use
 .B "-q, \-\-quiet"
 Don't output any logging information.  This option is not recommended
 for normal use, although it can make system call traces clearer so I use


@@ -927,11 +936,23 @@ options provided are:
 .OS "Socket options"
 .B socket.conn
 .RB [ = ]
 .OS "Socket options"
 .B socket.conn
 .RB [ = ]

-.I number
+.IR number | \c
+.BR unlimited | one-shot

 .OD
 .OD

-Limits the number of simultaneous connections to this socket to the
+Controls the behaviour of the source when it receives connections.  A

 .I number
 .I number

-given.  The default is 256.
+limits the number of simultaneous connections.  The value
+.B unlimited
+(or
+.BR infinite )
+removes any limit on the number of connections possible.  The value
+.B one-shot
+will remove the socket source after a single successful connection.
+(Connections refused by access control systems don't count here.)
+The default is to apply a limit of 256 concurrent connections.  Use of
+the
+.B unlimited
+option is not recommended.

 .OE
 .OS "Socket options"
 .B socket.logging
 .OE
 .OS "Socket options"
 .B socket.logging


@@ -1361,7 +1382,8 @@ exec
 .SS "Socket options"
 .B socket.conn
 .RB [ = ]
 .SS "Socket options"
 .B socket.conn
 .RB [ = ]

-.I number
+.IR number | \c
+.BR unlimited | one-shot

 .br
 .B socket.logging
 .RB [ = ]
 .br
 .B socket.logging
 .RB [ = ]


@@ -1380,7 +1402,9 @@ exec
 .
 The syntax for IP addresses and filenames is nasty.
 .PP
 .
 The syntax for IP addresses and filenames is nasty.
 .PP

-IPv6 is not supported yet.  It's probably not a major piece of work to
+IPv6 is not supported yet.  Because of
+.BR fw 's
+socket address architecture, it's probably not a major piece of work to

 add.
 .PP
 Please inform me of any security problems you think you've identified in
 add.
 .PP
 Please inform me of any security problems you think you've identified in