summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-05-29 15:53:01 +0000
committerru <ru@FreeBSD.org>2002-05-29 15:53:01 +0000
commitb0b91fa5217a15e487a160d7fe0aa430c596af0e (patch)
tree7640b4e7f12df1d6888c41263e6359e11a117880 /lib
parent9adcbc64811683c4a7b1a5eaf10803137a68cf6c (diff)
downloadFreeBSD-src-b0b91fa5217a15e487a160d7fe0aa430c596af0e.zip
FreeBSD-src-b0b91fa5217a15e487a160d7fe0aa430c596af0e.tar.gz
mdoc(7) police: markup nits.
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/sys/listen.227
1 files changed, 17 insertions, 10 deletions
diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2
index 109bcc8..6423850 100644
--- a/lib/libc/sys/listen.2
+++ b/lib/libc/sys/listen.2
@@ -32,7 +32,7 @@
.\" From: @(#)listen.2 8.2 (Berkeley) 12/11/93
.\" $FreeBSD$
.\"
-.Dd November 3, 1995
+.Dd May 8, 2002
.Dt LISTEN 2
.Os
.Sh NAME
@@ -73,14 +73,18 @@ receive an error with an indication of
or, in the case of TCP, the connection will be
silently dropped.
.Pp
-Note that before FreeBSD 4.5 and the introduction of the syncache,
-the
+Note that before
+.Fx 4.5
+and the introduction of the syncache,
+the
.Fa backlog
parameter also determined the length of the incomplete
connection queue, which held TCP sockets in the process
-of completing TCP's 3-way handshake. These incomplete connections
+of completing TCP's 3-way handshake.
+These incomplete connections
are now held entirely in the syncache, which is unaffected by
-queue lengths. Inflated
+queue lengths.
+Inflated
.Fa backlog
values to help handle denial
of service attacks are no longer necessary.
@@ -100,14 +104,17 @@ is silently forced to
.Sh INTERACTION WITH ACCEPT FILTERS
When accept filtering is used on a socket, a second queue will
be used to hold sockets that have connected, but have not yet
-met their accept filtering criteria. Once the criteria has been
+met their accept filtering criteria.
+Once the criteria has been
met, these sockets will be moved over into the completed connection
-queue to be accept()ed. If this secondary queue is full and a
+queue to be
+.Xr accept 2 Ns ed .
+If this secondary queue is full and a
new connection comes in, the oldest socket which has not yet met
its accept filter criteria will be terminated.
.Pp
This secondary queue, like the primary listen queue, is sized
-according to the
+according to the
.Fa backlog
parameter.
.Sh RETURN VALUES
@@ -130,11 +137,11 @@ The socket is not of a type that supports the operation
.El
.Sh SEE ALSO
.Xr accept 2 ,
-.Xr accept_filter 9 ,
.Xr connect 2 ,
.Xr socket 2 ,
.Xr sysctl 3 ,
-.Xr sysctl 8
+.Xr sysctl 8 ,
+.Xr accept_filter 9
.Sh HISTORY
The
.Fn listen
OpenPOWER on IntegriCloud