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
             command 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
             parameters: 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 11.0-PRERELEASE          July 8, 2009          FreeBSD 11.0-PRERELEASE

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | HISTORY

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

home | help