From nobody@FreeBSD.ORG Wed Oct  6 21:13:57 1999
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 4633F14DA9; Wed,  6 Oct 1999 21:13:57 -0700 (PDT)
Message-Id: <19991007041357.4633F14DA9@hub.freebsd.org>
Date: Wed,  6 Oct 1999 21:13:57 -0700 (PDT)
From: crandall@matchlogic.com
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@freebsd.org
Subject: bind(2) sets errno to undocumented EAGAIN
X-Send-Pr-Version: www-1.0

>Number:         14173
>Category:       docs
>Synopsis:       bind(2) sets errno to undocumented EAGAIN
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Oct  6 21:20:01 PDT 1999
>Closed-Date:    Mon Nov 1 11:42:37 PST 1999
>Last-Modified:  Mon Nov  1 11:43:11 PST 1999
>Originator:     Charles Randall
>Release:        3.2
>Organization:
MatchLogic, Inc
>Environment:
FreeBSD bongo.is.matchlogic.com 3.2-RELEASE FreeBSD 3.2-RELEASE #1: Tue Oct  5 21:38:47 MDT 1999     crandall@bongo.is.matchlogic.com:/usr/src/sys/compile/CUSTOM  i386
>Description:
Under high load, bind() fails with a -1 and sets errno to EAGAIN.
This is not documented in the bind(2) manual page under the ERRORS
section.

Using ktrace/kdump,

   522 http_load CALL  socket(0x2,0x1,0x6)
   522 http_load RET   socket 4
   522 http_load CALL  bind(0x4,0x805f404,0x10)
   522 http_load RET   bind -1 errno 35 Resource temporarily unavailable


>How-To-Repeat:
Use http_load from http://www.acme.com/software/http_load to
stress the system by testing a local HTTP server (run http_load
and the HTTP server on the same machine).


>Fix:
Add EAGAIN to the ERRORS section of the bind(2) manual page with
a description of which resources are exhausted.


>Release-Note:
>Audit-Trail:

From: "Kelly Yancey" <kbyanc@alcnet.com>
To: <freebsd-gnats-submit@freebsd.org>
Cc:  
Subject: Re: docs/14173: bind(2) sets errno to undocumented EAGAIN
Date: Fri, 8 Oct 1999 10:23:20 -0400

   From the same discussion on -hackers, I submitted the docs/14181 PR (I
 must had missed that you had already sent one in). It includes a suggested
 patch (real simple) that simply states "Kernel resources to complete the
 request are temporarily unavailable".
   For the committer who takes care of this PR, please close that PR also.
 (Sorry again for the redundancy).
 
   Thanks,
 
   Kelly
  ~kbyanc@posi.net~
   FreeBSD - The Power To Serve - http://www.freebsd.org/
   Join Team FreeBSD - http://www.posi.net/freebsd/Team-FreeBSD/
 
 
State-Changed-From-To: open->closed 
State-Changed-By: nik 
State-Changed-When: Mon Nov 1 11:42:37 PST 1999 
State-Changed-Why:  
The man page has been fixed.  Thanks. 
>Unformatted:
