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)

NAME
     jls -- list jails

SYNOPSIS
     jls [-dhnqsv] [-j jail] [parameter	...]

DESCRIPTION
     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	     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	     Print a multiple-line summary per jail, with the following	param-
	     eters: jail identifier (jid), hostname (host.hostname), path
	     (path), jail name (name), jail state (dying), cpuset ID (cpuset),
	     IP	address(es) (ip4.addr and ip6.addr).

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

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

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

FreeBSD	10.1			 July 8, 2009			  FreeBSD 10.1

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=jls&sektion=8&manpath=FreeBSD+9.1-RELEASE>

home | help