'\" -*- 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-snapshot 1 2024-02-10 "" ""
.SH NAME
lxc-snapshot \- 存在するコンテナのスナップショットの取得 
.SH SYNOPSIS
'nh
.fi
.ad l
\*(T<\fBlxc\-snapshot\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n, --name \fIname\fR} [-c, --comment \fIfile\fR]
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\*(T<\fBlxc\-snapshot\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n, --name \fIname\fR} {-d, -destroy \fIsnapshot-name\fR}
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\*(T<\fBlxc\-snapshot\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n, --name \fIname\fR} {-L, --list } [-C, --showcomments ]
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\*(T<\fBlxc\-snapshot\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n, --name \fIname\fR} {-r, -restore \fIsnapshot-name\fR} [-N, --newname \fInewname\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH 説明
\fBlxc-snapshot\fR はコンテナのスナップショットの作製、スナップショットのリスト表示、スナップショットからのリストアを行います。
.PP
スナップショットはコンテナパス以下にスナップショット化されたコンテナとして保存されます。
例えば、もしコンテナパスが \*(T<\fI/var/lib/lxc\fR\*(T> で、コンテナが \*(T<\fIc1\fR\*(T> である場合、最初に取得するスナップショットは、パス \*(T<\fI/var/lib/lxc/c1/snaps\fR\*(T> の下の \*(T<\fIsnap0\fR\*(T> として保存されます。
LXC 1.0 で使われていた \*(T<\fI/var/lib/lxcsnaps\fR\*(T> が存在する場合には、このディレクトリが引き続き使われます。
.SH オプション
.TP 
\*(T<\fB\-c,\-\-comment \fR\*(T>\fIcomment_file\fR 
新しく作製するスナップショットに \fIcomment_file\fR ファイル内のコメントを関連付ける。
.TP 
\*(T<\fB\-d,\-\-destroy snapshot\-name\fR\*(T> 
指定した名前のスナップショットを破壊します。ALL という名前が指定された場合、すべてのスナップショットが破壊されます。
.TP 
\*(T<\fB\-L,\-\-list \fR\*(T>
存在するスナップショットをリスト表示します。
.TP 
\*(T<\fB\-C,\-\-showcomments \fR\*(T>
スナップショットのリスト表示でスナップショットに対するコメントを表示します。
.TP 
\*(T<\fB\-r,\-\-restore snapshot\-name\fR\*(T> 
指定のスナップショットをリストアします。
これはスナップショットのコピーである完全に新しいコンテナが作製されるということです。
.TP 
\*(T<\fB\-N, \-\-newname\fR\*(T> 
スナップショットをリストアする際、\fB--newname\fR の値として明示的に指定しない場合でも、最後のオプション引数はリストアするコンテナの名前として使用します。
もし newname が元のコンテナの名前と同じ場合、元のコンテナが削除され、リストアされるコンテナに置き換えられます。
スナップショット元を削除することは、overlayfs, zfs がバックエンドのスナップショットではできないことに注意が必要です。
.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
コンテナの仮想化、隔離機能の設定のための設定ファイルを指定します。

(lxc-create 経由で) 前もってコンテナが作られた際の設定ファイルが既にあった場合でも、このオプションが指定された場合は、指定した設定ファイルが使用されます。
.TP 
\*(T<\fB\-\-version\fR\*(T>
バージョン番号を表示します。
.SH "SEE ALSO"
\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)
.SH 作者
Serge Hallyn <\*(T<serge.hallyn@ubuntu.com \*(T>>