NAME

       lxc-ls - list the containers existing on the system

SYNOPSIS

       lxc-ls [-1] [-P lxcpath] [--active] [--frozen] [--running] [--stopped] [-f] [-F format] [--nesting]
              [filter] [--version]

DESCRIPTION

       lxc-ls list the containers existing on the system.

OPTIONS

       [-1]   Show one entry per line. (default when /dev/stdout isn't a tty)

       [-P, --lxcpath]
              Use an alternate container path. The default is /var/lib/lxc.

       [--active]
              List only active containers (same as --frozen --running).

       [--frozen]
              List only frozen containers.

       [--running]
              List only running containers.

       [--stopped]
              List only stopped containers.

       [-f, --fancy]
              Use a fancy, column-based output.

       [-F, --fancy-format format]
              Comma  separated  list  of  column  to show in the fancy output.  The list of accepted and default
              fields is listed in --help.

       [--nesting]
              Show nested containers.

       [filter]
              The filter passed to lxc-ls will be applied to the container name. The format is a regular expres‐
              sion.

       [--version]
              Show the version number.

EXAMPLES

       lxc-ls --fancy
              list all the containers, listing one per line along with its name, state, ipv4 and ipv6 addresses.

       lxc-ls --active -1
              list active containers and display the list in one column.

SEE ALSO

       lxc(7), lxc-create(1), lxc-destroy(1), lxc-start(1), lxc-stop(1),  lxc-execute(1),  lxc-console(1),  lxc-
       monitor(1),  lxc-wait(1),  lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1), lxc-at‐
       tach(1), lxc.conf(5)

AUTHOR

       Stéphane Graber <stgraber@ubuntu.com>

                                                   2017-08-01                                          lxc-ls(1)