docs/96807: [patch] document security.jail.list sysctl in jail(8)

[Cheng-Lung Sung]

>Number:         96807
>Category:       docs
>Synopsis:       [patch] document security.jail.list sysctl in jail(8)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Fri May 05 01:20:13 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Cheng-Lung Sung
>Release:        FreeBSD 6.1-RC i386
>Organization:
FreeBSD @ Taiwan
>Environment:
System: FreeBSD going04.iis.sinica.edu.tw 6.1-RC FreeBSD 6.1-RC #8: Tue May 2 13:22:05 CST 2006 root at going04.iis.sinica.edu.tw:/usr/obj/usr/src/sys/GOING04 i386

>Description:
	security.jail.jailed is not documented. 
	Also re-format security.jail.jailed in jail(8)
>How-To-Repeat:
>Fix:

--- jail.8.orig	Fri May  4 10:41:02 2006
+++ jail.8	Fri May  5 09:07:46 2006
@@ -536,6 +536,16 @@
 privileged, and may manipulate system file flags subject to the usual
 constraints on
 .Va kern.securelevel .
+.It Va security.jail.jailed
+The read-only variable can be used to determine if a process is running inside a jail (value
+is one) or not (value is zero).
+.It Va security.jail.list
+This MIB entry is read-only and it returns an array of 
+struct xprison defined in 
+.In sys/jail.h .
+It is recommended to use the
+.Xr jls 8
+utility to see current active list of jails.
 .El
 .Pp
 There are currently two MIB related variables that have per-jail settings.
>Release-Note:
>Audit-Trail:
>Unformatted: