Describe new socket connection options.
authormdw <mdw>
Fri, 22 Oct 1999 22:45:15 +0000 (22:45 +0000)
committermdw <mdw>
Fri, 22 Oct 1999 22:45:15 +0000 (22:45 +0000)
fw.1

diff --git a/fw.1 b/fw.1
index 885d5b9..6125c4f 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.7 1999/10/22 22:45:15 mdw Exp $
 .\"
 .\" Manual page for fw
 .\"
 .\"
 .\" Manual page for fw
 .\"
@@ -28,6 +28,9 @@
 .\" ---- Revision history ---------------------------------------------------
 .\" 
 .\" $Log: fw.1,v $
 .\" ---- Revision history ---------------------------------------------------
 .\" 
 .\" $Log: fw.1,v $
+.\" 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.
 .\"
@@ -927,11 +930,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 +1376,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 +1396,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