'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-ls 1 "Sat Apr 29 06:45:43 UTC 2017" "" ""
.SH NAME
lxc-ls \- list the containers existing on the system 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBlxc-ls\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-1] [--active] [--frozen] [--running] [--stopped] [-f] [-F \fIformat\fR] [--nesting] [filter]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBlxc-ls\fR list the containers existing on the
system.
.SH OPTIONS
.TP 
\*(T<\fB[\-1]\fR\*(T> 
Show one entry per line. (default when /dev/stdout isn't a tty)
.TP 
\*(T<\fB[\-\-active]\fR\*(T> 
List only active containers (same as --frozen --running).
.TP 
\*(T<\fB[\-\-frozen]\fR\*(T> 
List only frozen containers.
.TP 
\*(T<\fB[\-\-running]\fR\*(T> 
List only running containers.
.TP 
\*(T<\fB[\-\-stopped]\fR\*(T> 
List only stopped containers.
.TP 
\*(T<\fB[\-f, \-\-fancy]\fR\*(T> 
Use a fancy, column-based output.
.TP 
\*(T<\fB[\-F, \-\-fancy\-format \fIformat\fB]\fR\*(T> 
Comma separated list of column to show in the fancy output.
The list of accepted and default fields is listed in --help.
.TP 
\*(T<\fB[\-\-nesting]\fR\*(T> 
Show nested containers.
.TP 
\*(T<\fB[filter]\fR\*(T> 
The filter passed to \fBlxc-ls\fR will be
applied to the container name. The format is a regular expression.
.SH EXAMPLES
.TP 
lxc-ls --fancy
list all the containers, listing one per line along with its
name, state, ipv4 and ipv6 addresses.
.TP 
lxc-ls --active -1
list active containers and display the list in one column.
.SH "SEE ALSO"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)
.SH AUTHOR
St\('ephane Graber <\*(T<stgraber@ubuntu.com\*(T>>