docs/125253: [patch] jail(2) does not mention about possible error EAGAIN

[Mateusz Guzik]

>Number:         125253
>Category:       docs
>Synopsis:       [patch] jail(2) does not mention about possible error EAGAIN
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 04 08:50:03 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Mateusz Guzik
>Release:        8.0-CURRENT
>Organization:
>Environment:
FreeBSD eternal 8.0-CURRENT FreeBSD 8.0-CURRENT #11: Wed Jul  2 15:50:37 CEST 2008     f at eternal:/usr/obj/usr/src/sys/ETERNAL  i386

>Description:
If all valid jids are in use, the kernel returns EAGAIN (see line 177 in sys/kern/kern_jail.c), but man page jail(2) does not mention it.
>How-To-Repeat:

>Fix:
Patch is attached.

Patch attached with submission follows:

--- lib/libc/sys/jail.2.orig	2005-02-09 19:03:14.000000000 +0100
+++ lib/libc/sys/jail.2	2008-07-04 10:33:35.000000000 +0200
@@ -110,10 +110,14 @@
 will fail if:
 .Bl -tag -width Er
 .It Bq Er EINVAL
 The version number of the argument is not correct.
 .El
+.Bl -tag -width Er
+.It Bq Er EAGAIN
+No free JID could be found.
+.El
 .Pp
 Further
 .Fn jail
 calls
 .Xr chroot 2


>Release-Note:
>Audit-Trail:
>Unformatted: