.\" -*- 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-checkpoint 1 2025-08-26 "" ""
.SH NAME
lxc-checkpoint \- 컨테이너의 체크포인트 생성 및 복원 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBlxc-checkpoint\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n \fIname\fR} {-D \fIPATH\fR} [-r] [-s] [-v] [-d] [-F]
'in \n(.iu-\nxu
.ad b
'hy
.SH 설명
\fBlxc-checkpoint\fR 는 컨테이너의 체크포인트를 생성 및 복원을 수행한다.
(역주 : 이 명령어를 사용하기 위해서는 CRIU(Checkpoint/Restore In Userspace)라는 툴이 반드시 필요하다, 컨테이너의 실행상태를 대상으로 한다는 점에서 \fBlxc-snapshot\fR와는 다르다)
.SH 옵션
.TP 
\*(T<\fB\-r, \-\-restore\fR\*(T> 
컨테이너의 상태를 저장하는 것 대신에 체크포인트로 복원을 수행한다.
이 옵션은 \*(T<\fB\-s\fR\*(T>과 같이 사용될 수 없다.
.TP 
\*(T<\fB\-D \fR\*(T>\fIPATH\fR\*(T<\fB, \-\-checkpoint\-dir=\fR\*(T>\fIPATH\fR 
체크포인트 메타데이터를 저장할 디렉토리를 지정한다.
.TP 
\*(T<\fB\-s, \-\-stop\fR\*(T> 
컨테이너의 상태를 저장한 후 컨테이너를 중지한다. 이 옵션은 \*(T<\fB\-r\fR\*(T>과 같이 사용될 수 없다.
.TP 
\*(T<\fB\-v, \-\-verbose\fR\*(T> 
CRIU 로그 기록을 자세하게 한다.
.TP 
\*(T<\fB\-d, \-\-daemon\fR\*(T> 
컨테이너 복원을 백그라운드에서 수행한다. (이것이 기본으로 되어있다)
\*(T<\fB\-r\fR\*(T> 옵션이랑만 사용가능하다.
.TP 
\*(T<\fB\-F, \-\-foreground\fR\*(T> 
컨테이너 복원을 포그라운드에서 수행한다. \*(T<\fB\-r\fR\*(T> 옵션이랑만 사용가능하다.
.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 예제
.TP 
lxc-checkpoint -n foo -D /tmp/checkpoint
foo 컨테이너의 체크포인트를 /tmp/checkpoint 디렉토리에 생성한다.
.TP 
lxc-checkpoint -r -n foo -D /tmp/checkpoint
foo 컨테이너를 /tmp/checkpoint 디렉토리에 있는 체크포인트로 복원한다.
.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)
