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-*-
 .\"
-.\" $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
 .\"
@@ -28,6 +28,12 @@
 .\" ---- 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.
 .\"
@@ -120,7 +126,7 @@ fw \- port forwarder
 .SH SYNOPSIS
 .
 .B fw
-.RB [ \-dq ]
+.RB [ \-dlq ]
 .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
+.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
@@ -927,11 +936,23 @@ options provided are:
 .OS "Socket options"
 .B socket.conn
 .RB [ = ]
-.I number
+.IR number | \c
+.BR unlimited | one-shot
 .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
-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
@@ -1361,7 +1382,8 @@ exec
 .SS "Socket options"
 .B socket.conn
 .RB [ = ]
-.I number
+.IR number | \c
+.BR unlimited | one-shot
 .br
 .B socket.logging
 .RB [ = ]
@@ -1380,7 +1402,9 @@ exec
 .
 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