From ras@e-gerbil.net  Wed Apr 25 17:44:42 2001
Return-Path: <ras@e-gerbil.net>
Received: from overlord.e-gerbil.net (e-gerbil.net [207.91.110.247])
	by hub.freebsd.org (Postfix) with ESMTP id F103B37B422
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 25 Apr 2001 17:44:41 -0700 (PDT)
	(envelope-from ras@e-gerbil.net)
Received: by overlord.e-gerbil.net (Postfix, from userid 1001)
	id DF17AE4A35; Wed, 25 Apr 2001 20:44:40 -0400 (EDT)
Message-Id: <20010426004440.DF17AE4A35@overlord.e-gerbil.net>
Date: Wed, 25 Apr 2001 20:44:40 -0400 (EDT)
From: ras@e-gerbil.net
Reply-To: ras@e-gerbil.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: Mistake in accept(2) manpage
X-Send-Pr-Version: 3.2

>Number:         26861
>Category:       docs
>Synopsis:       accept(2) manpage documents non-existant feature
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Apr 25 17:50:01 PDT 2001
>Closed-Date:    Sun Jan 6 22:10:41 PST 2002
>Last-Modified:  Sun Jan 06 22:10:49 PST 2002
>Originator:     Richard A Steenbergen
>Release:        FreeBSD 4.2-STABLE i386
>Organization:
iVMG, Inc.
>Environment:



>Description:

The accept(2) manpage says:

     One can obtain user connection request data without confirming the con-
     nection by issuing a recvmsg(2) call with an msg_iovlen of 0 and a non-
     zero msg_controllen, or by issuing a getsockopt(2) request.  Similarly,
     one can provide user connection rejection information by issuing a
     sendmsg(2) call providing only the control information, or by calling
     setsockopt(2).

But this is not possible. There is no such code in recvmsg/sendmsg, and no
such sockopt. This would be a nice feature, but the handshake on a stream
socket should be completed already by the time an accept() call is made...

>How-To-Repeat:


>Fix:

Nuke the offending paragraph... :P
>Release-Note:
>Audit-Trail:

From: Tom Rhodes <darklogik@pittgoth.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/26861 accept(2) manpage documents non-existant feature
Date: Thu, 27 Dec 2001 17:14:27 -0500

 Richard is right, this feature is non-existant.  I'm supplying a patch for the
 man-page, please review and comment/commit whatever.  Thanks
 
 Tom Rhodes
 www.Pittgoth.com
 www.FreeBSD.org
 
 
 *** accept.2.old	Thu Dec 27 16:25:33 2001
 --- accept.2	Thu Dec 27 17:07:41 2001
 ***************
 *** 115,137 ****
   Confirmation can be implied by a normal read or write on the new
   file descriptor, and rejection can be implied by closing the
   new socket.
 - .Pp
 - One can obtain user connection request data without confirming
 - the connection by issuing a
 - .Xr recvmsg 2
 - call with an
 - .Fa msg_iovlen
 - of 0 and a non-zero
 - .Fa msg_controllen ,
 - or by issuing a
 - .Xr getsockopt 2
 - request.
 - Similarly, one can provide user connection rejection information
 - by issuing a
 - .Xr sendmsg 2
 - call providing only the control information,
 - or by calling
 - .Xr setsockopt 2 .
   .Sh RETURN VALUES
   The call returns \-1 on error.  If it succeeds, it returns a non-negative
   integer that is a descriptor for the accepted socket.
 --- 115,120 ----
 
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Sun Jan 6 22:10:41 PST 2002 
State-Changed-Why:  
applied, thanks 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=26861 
>Unformatted:
