From d857515ea12cdb08062bd60a2eca04908622f55c Mon Sep 17 00:00:00 2001
From: mdw <mdw>
Date: Fri, 22 Oct 1999 22:45:15 +0000
Subject: [PATCH] Describe new socket connection options.

---
 fw.1 | 30 ++++++++++++++++++++++++------
 1 file changed, 24 insertions(+), 6 deletions(-)

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