Provided by: lxc1_2.0.11-0ubuntu1~16.04.3_amd64 bug


       lxc-ls - list the containers existing on the system


       lxc-ls [-1] [--active] [--frozen] [--running] [--stopped] [--defined] [-f] [-F format] [-g
              groups] [--nesting=NUM] [--filter=regex]


       lxc-ls list the containers existing on the system.


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

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

              List only frozen containers.

              List only running containers.

              List only stopped containers.

              List only defined containers.

              Use a fancy, column-based output.

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

       -g,--groups groups
              Comma  separated  list  of  groups  the  container  must have to be displayed.  The
              parameter may be passed multiple times.

              Show nested containers. The number of nesting levels to be shown can  be  specified
              by passing a number as argument.

              The  regular expression passed to lxc-ls will be applied to the container name. The
              format is a POSIX extended regular expression. It can also be given  as  additional
              argument without explicitly using --filter.


       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.


       These options are common to most of lxc commands.

       -?, -h, --help
              Print a longer usage message than normal.

              Give the usage message

       -q, --quiet
              mute on

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

       -o, --logfile=FILE
              Output to an alternate log FILE. The default is no log.

       -l, --logpriority=LEVEL
              Set log priority to LEVEL. The default log priority is ERROR. Possible values are :

              Note  that  this  option is setting the priority of the events log in the alternate
              log file. It do not have effect on the ERROR events log on stderr.

       -n, --name=NAME
              Use container identifier NAME.  The container identifier format is an  alphanumeric

              Specify  the  configuration  file  to  configure  the  virtualization and isolation
              functionalities for the container.

              This configuration file if present  will  be  used  even  if  there  is  already  a
              configuration file present in the previously created container (via lxc-create).

              Show the version number.


       lxc(7),   lxc-create(1),  lxc-copy(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-attach(1), lxc.conf(5)


       Written  originally  as  a  shell  script  by  Daniel  Lezcano  and  Serge  Hallyn.  Later
       reimplemented and extended in  Python  by  St├ęphane  Graber  and  then  reimplemented  and
       extended in C by Christian Brauner.


       Christian Brauner <>, St├ęphane Graber <>

                                            2019-04-09                                  lxc-ls(1)