.\" -*- coding: UTF-8 -*-
.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 2024-09-16 "" ""
.SH NAME
lxc-ls \- 시스템 내에 존재하는 컨테이너들의 리스트 표시 
.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] [-g \fIgroups\fR] [--nesting=\fINUM\fR] [--filter=\fIregex\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH 설명
\fBlxc-ls\fR는 시스템 내에 존재하는 컨테이너들의 리스트를 표시한다.
.SH 옵션
.TP 
\*(T<\fB\-1\fR\*(T> 
1개의 항목를 한 줄에 표시한다. (/dev/stdout이 tty가 아닌 경우 기본)
.TP 
\*(T<\fB\-\-active\fR\*(T> 
동작 중인 컨테이너들의 리스트를 표시한다. (--frozen --running과 동일)
.TP 
\*(T<\fB\-\-frozen\fR\*(T> 
동결된 컨테이너들의 리스트를 표시한다.
.TP 
\*(T<\fB\-\-running\fR\*(T> 
실행 중인 컨테이너들의 리스트를 표시한다.
.TP 
\*(T<\fB\-\-stopped\fR\*(T> 
종료되어 있는 컨테이너들의 리스트를 표시한다.
.TP 
\*(T<\fB\-f, \-\-fancy\fR\*(T> 
예쁘게, 컬럼 기반으로 출력해준다.
.TP 
\*(T<\fB\-F, \-\-fancy\-format \fR\*(T>\fIformat\fR 
--fancy로 출력할때 어떤 컬럼을 보여줄지 쉼표(,)로 구분된 리스트.
기본으로 표시되는 항목 및 선택할 수 있는 항목을 확인하려면 --help를 사용하면 된다.
.TP 
\*(T<\fB\-g, \-\-groups \fR\*(T>\fIgroups\fR 
표시하고자하는 컨테이너 그룹의 쉼표로 구분된 리스트.
이 인수는 여러번 사용될 수 있다.
.TP 
\*(T<\fB\-\-nesting=\fR\*(T>\fINUM\fR 
중첩된(nested) 컨테이너들의 리스트를 표시한다. 몇번 중첩된(nested) 컨테이너를 보여줄지 숫자로 지정할 수 있다.
.TP 
\*(T<\fB\-\-filter=\fR\*(T>\fIregex\fR 
\fBlxc-ls\fR 명령어 사용시 컨테이너 이름에 적용할 정규표현식이다. 형식은 POSIX 확장 정규표현식이다. 명시적으로 \*(T<\fB\-\-filter\fR\*(T>을 사용하지 않고도 사용할 수 있다.
.SH 예제
.TP 
lxc-ls --fancy
모든 컨테이너를 표시한다. 1개의 행에 컨테이너의 이름, 상태, ipv4 및 ipv6 주소가 들어있다.
.TP 
lxc-ls --active -1
동작 중인 컨테이너들의 리스트를 1열로 표시한다.
.SH "공통 옵션"
이 옵션들은 대부분의 lxc 명령어들에서 공통으로 쓰인다.
.TP 
\*(T<\fB\-?, \-h, \-\-help\fR\*(T>
사용법을 기존 출력하는 것보다 길게 출력한다.
.TP 
\*(T<\fB\-\-usage\fR\*(T>
사용법을 표시한다.
.TP 
\*(T<\fB\-q, \-\-quiet\fR\*(T>
결과를 표시하지 않는다.
.TP 
\*(T<\fB\-P, \-\-lxcpath=\fR\*(T>\fIPATH\fR
컨테이너 경로를 직접 지정한다. 기본값은 /var/lib/lxc이다.
.TP 
\*(T<\fB\-o, \-\-logfile=\fR\*(T>\fIFILE\fR
로그의 경로를 \fIFILE\fR로 지정한다. 기본값은 로그를 출력하지 않는 것이다.
.TP 
\*(T<\fB\-l, \-\-logpriority=\fR\*(T>\fILEVEL\fR
로그 수준을 \fILEVEL\fR로 지정한다. 기본값은 \*(T<ERROR\*(T>이다. 사용 가능한 값 :
\*(T<FATAL\*(T>, \*(T<ALERT\*(T>,
\*(T<CRIT\*(T>,
\*(T<WARN\*(T>, \*(T<ERROR\*(T>,
\*(T<NOTICE\*(T>, \*(T<INFO\*(T>,
\*(T<DEBUG\*(T>, \*(T<TRACE\*(T>.

이 옵션은 로그 파일에만 적용된다는 사실을 주의해야 한다. stderr로 출력되는 ERROR 로그에는 영향을 끼치지 않는다.
.TP 
\*(T<\fB\-n, \-\-name=\fR\*(T>\fINAME\fR
컨테이너 식별자로 \fINAME\fR을 사용한다. 컨테이너 식별자의 형식은 알파벳-숫자 문자열이다.
.TP 
\*(T<\fB\-\-rcfile=\fR\*(T>\fIFILE\fR
컨테이너의 가상화 및 고립 기능들을 설정할 파일을 지정한다.

이전에 만들어졌던 컨테이너에 설정 파일이 이미 있더라도, 이 옵션이 지정되어 있다면 해당 파일을 사용한다.
.TP 
\*(T<\fB\-\-version\fR\*(T>
버전 정보를 표시한다.
.SH 참조
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-copy\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)