JLS(8)                  FreeBSD System Manager's Manual                 JLS(8)

NAME

     jls - list jails

SYNOPSIS

     jls [--libxo] [-dhNnqsv] [-j jail] [parameter ...]
     jls -c [-d] -j jail

DESCRIPTION

     The jls utility lists all active jails, or the specified jail.  Each jail
     is represented by space-separated values of the listed parameters, one
     jail per line (unless the parameters themselves contain newlines).  The
     pseudo-parameter all 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 -chns are given, the following
     four columns will be printed: jail identifier (jid), IP address
     (ip4.addr), hostname (host.hostname), and path (path).

     When the -c option is used, jls will not emit any output except for usage
     errors.  This mode is intended solely to check for a single jail's
     existence, and it does not accept any parameter or print-option flags.

     The following options are available:

     --libxo
             Generate output via libxo(3) in a selection of different human
             and machine readable formats.  See xo_options(7) for details on
             command line arguments.

     -c      Only check for the jail's existence.

     -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 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      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
             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), libxo(3), xo_options(7), jail(8), jexec(8)

HISTORY

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

FreeBSD 15.1-STABLE-HBSD         July 25, 2025                          JLS(8)