Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
JLS(8)			FreeBSD	System Manager's Manual			JLS(8)

     jls -- list jails

     jls [-dhNnqsv] [-j	jail] [parameter ...]

     The jls utility lists all active jails, or	the specified jail.  Each jail
     is	represented by one row which contains space-separated values of	the
     listed parameters,	including the pseudo-parameter all which will show all
     available jail parameters.	 A list	of available parameters	can be
     retrieved via ``sysctl -d security.jail.param''.  See jail(8) for a
     description of some core parameters.

     If	no parameters or any of	the options -hns are given, the	following four
     columns will be printed: jail identifier (jid), IP	address	(ip4.addr),
     hostname (host.hostname), and path	(path).

     The following options are available:

     -d	     List dying	as well	as active jails.

     -h	     Print a header line containing the	parameters listed.  If no
	     parameters	are given on the command line, all is assumed.

     -N	     In	the standard display mode, print each jail's name instead of
	     its numeric ID.  If the jail does not have	a name,	the numeric ID
	     is	printed	instead.

     -n	     Print parameters in ``name=value''	format,	where each parameter
	     is	preceded by its	name.  If no parameters	are given on the com-
	     mand line,	all is assumed.

     -q	     Put quotes	around parameters if they contain spaces or quotes, or
	     are the empty string.

     -s	     Print parameters suitable for passing to jail(8), skipping	read-
	     only and unused parameters.  Implies -nq.

     -v	     Extend the	standard display with a	multiple-line summary per
	     jail, containing the following parameters:	jail identifier	(jid),
	     hostname (host.hostname), path (path), jail name (name), jail
	     state (dying), cpuset ID (cpuset),	IP address(es) (ip4.addr and

     -j	jail
	     The jid or	name of	the jail to list.  Without this	option,	all
	     active jails will be listed.

     jail_get(2), jail(8), jexec(8)

     The jls utility was added in FreeBSD 5.1.	Extensible jail	parameters
     were introduced in	FreeBSD	8.0.

FreeBSD	10.2			 July 20, 2012			  FreeBSD 10.2


Want to link to this manual page? Use this URL:

home | help