日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
ZFS(8) FreeBSD システム管理者マニュアル ZFS(8)
名称
zfs -- ZFS ファイルシステムを設定する
書式
zfs [-?]
zfs create [-pu] [-o property=value]... filesystem
zfs create [-ps] [-b blocksize] [-o property=value]... -V size volume
zfs destroy [-fnpRrv] filesystem|volume
zfs destroy [-dnpRrv] filesystem|volume@snap[%snap][,snap[%snap]][,...]
zfs destroy filesystem|volume#bookmark
zfs snapshot|snap [-r] [-o property=value]...
filesystem@snapname|volume@snapname
filesystem@snapname|volume@snapname...
zfs rollback [-rRf] snapshot
zfs clone [-p] [-o property=value]... snapshot filesystem|volume
zfs promote clone-filesystem
zfs rename [-f] filesystem|volume|snapshot filesystem|volume|snapshot
zfs rename [-f] -p filesystem|volume filesystem|volume
zfs rename -r snapshot snapshot
zfs rename -u [-p] filesystem filesystem
zfs list [-r|-d depth] [-Hp] [-o property[,property]...]
[-t type[,type]...] [-s property]... [-S property]...
filesystem|volume|snapshot |bookmark...
zfs remap filesystem|volume
zfs set property=value [property=value]... filesystem|volume|snapshot...
zfs get [-r|-d depth] [-Hp] [-o all | field[,field]...]
[-t type[, type]...] [-s source[,source]...] all |
property[,property]... filesystem|volume|snapshot...
zfs inherit [-rS] property filesystem|volume|snapshot...
zfs upgrade [-v]
zfs upgrade [-r] [-V version] -a | filesystem
zfs userspace [-Hinp] [-o field[,field]...] [-s field]... [-S field]...
[-t type[,type]...] filesystem|snapshot
zfs groupspace [-Hinp] [-o field[,field]...] [-s field]... [-S field]...
[-t type[,type]...] filesystem|snapshot
zfs mount
zfs mount [-vO] [-o property[,property]...] -a | filesystem
zfs unmount|umount [-f] -a | filesystem|mountpoint
zfs share -a | filesystem
zfs unshare -a | filesystem|mountpoint
zfs bookmark snapshot bookmark
zfs send [-DLPRcenpv] [-i snapshot | -I snapshot] snapshot
zfs send [-Lce] [-i snapshot|bookmark] filesystem|volume|snapshot
zfs send [-Penv] -t receive_resume_token
zfs receive|recv [-vnsFu] [-o origin=snapshot] filesystem|volume|snapshot
zfs receive|recv [-vnsFu] [-d | -e] [-o origin=snapshot] filesystem
zfs receive|recv -A filesystem|volume
zfs allow filesystem|volume
zfs allow [-ldug] user|group[,user|group]...
perm|@setname[,perm|@setname]... filesystem|volume
zfs allow [-ld] -e|everyone perm|@setname[,perm|@setname]...
filesystem|volume
zfs allow -c perm|@setname[,perm|@setname]... filesystem|volume
zfs allow -s @setname perm|@setname[,perm|@setname]... filesystem|volume
zfs unallow [-rldug] user|group[,user|group]...
[perm|@setname[,perm|@setname]...] filesystem|volume
zfs unallow [-rld] -e|everyone [perm|@setname[,perm|@setname]...]
filesystem|volume
zfs unallow [-r] -c [perm|@setname[,perm|@setname]...] filesystem|volume
zfs unallow [-r] -s @setname [perm|@setname[,perm|@setname]...]
filesystem|volume
zfs hold [-r] tag snapshot...
zfs holds [-Hp] [-r|-d depth] filesystem|volume|snapshot...
zfs release [-r] tag snapshot...
zfs diff [-FHt] snapshot [snapshot|filesystem]
zfs program [-n] [-t timeout] [-m memory_limit] pool script [arg1 ...]
zfs jail jailid|jailname filesystem
zfs unjail jailid|jailname filesystem
解説
zfs コマンドは、zpool(8) で説明されるような、ZFS 記憶域プール内で ZFS
データセットを設定します。データセットは、ZFS 名前空間内のユニークなパス
によって識別されます。例えば:
pool/{filesystem,volume,snapshot}
ここで、データセット名の最大の長さは、MAXNAMELEN (256 バイト) です。
データセットは、次の 1 つを指定できます:
file system タイプ filesystem の ZFS データセットを標準のシステム名前空
間内にマウントし、他のファイルシステムのように振る舞うこと
ができます。ZFS ファイルシステムは、POSIX 準拠となるように
設計されていますが、ある場合に準拠を妨げる問題が存在してい
ることが知られています。標準の適合に依存するアプリケーショ
ンは、ファイルシステムの空き空間をチェックするとき、標準的
でない振る舞いのため失敗するかもしれません。
volume 論理的なボリュームは、生 (raw) またはブロックデバイスとして
エクスポートされます。このデータセットのタイプは、特別な状
況の下でのみ使用されるべきです。ファイルシステムは、通常ほ
とんどの環境で使用されます。
snapshot 時間内に与えられたポイントのファイルシステムまたはボリュー
ムの読み込み専用バージョン。それは、filesystem@name または
volume@name として指定されます。
ZFS ファイルシステム階層構造
ZFS 記憶域プールは、データセットのための空間を提供するデバイスの論理的な
収集です。また、記憶域プールは、ZFS ファイルシステム階層構造のルートで
す。
マウントとアンマウント、スナップショットを取る、とプロパティ (特性) を設
定するような、ファイルシステムとしてプールのルートにアクセスすることがで
きます。しかしながら、物理的な記憶域の特性は、zpool(8) コマンドによって管
理されます。
プールの作成と管理に関する詳しい情報については、zpool(8) を参照してくださ
い。
スナップショット
スナップショットは、ファイルシステムまたはボリュームの読み込み専用のコ
ピーです。スナップショットをとても素早く作成することができ、最初は、プー
ル内の追加された空間を消費しません。アクティブなデータセット中のデータが
変更されるときに、スナップショットは、アクティブなデータセットで共有され
る別のものより多くのデータを消費します。
スナップショットは、任意の名前を持つことができます。ボリュームのスナップ
ショットのクローンを作るか、またはロールバックすることができますが、独立
にアクセスすることはできません。
ファイルシステムのルートの .zfs/snapshot ディレクトリの下でファイルシステ
ムのスナップショットをアクセスすることができます。スナップショットは、自
動的に要求に応じてマウントされ、一定の間隔ごとにアンマウントされます。
snapdir プロパティによって、.zfs ディレクトリの可視性を制御することができ
ます。
クローン
クローンは、初期の内容が、別のデータセットと同じである書き込み可能なボ
リュームまたはファイルシステムです。スナップショットのように、クローンを
作成することは、ほとんど瞬時であり、初めは何も追加空間を消費しません。
スナップショットからクローンのみを作成することができます。スナップショッ
トがクローン化されるとき、親子の間の暗黙の依存を作成します。たとえ、ク
ローンが、データセット階層構造のほかで作成されても、クローンが存在してい
る限り、オリジナルのスナップショットを破壊することはできません。origin プ
ロパティは、この依存を公表しし、存在しているなら、destroy コマンドは、そ
のような依存をリストします。
promote サブコマンドを使用することによって、クローンの親子の依存関係を逆
にすることができます。これによって、"origin" ファイルシステムは、クローン
が作成されるファイルシステムを破壊することが可能となる、指定されたファイ
ルシステムのクローンとなります。
マウントポイント
ZFS ファイルシステムを作成することは、簡単な操作であるので、システム毎の
ファイルシステムの数は、おそらく非常に多くなります。これに対処するため
に、ZFS は、自動的に /etc/fstab ファイルを編集する必要なしにファイルシス
テムをマウントして、アンマウントする管理を行います。すべての自動的に管理
されたファイルシステムは、ブート時に ZFS によってマウントされます。
デフォルトで、ファイルシステムは、/path の下にマウントされ、ここで、path
は、ZFS 名前空間のファイルシステムの名前です。ディレクトリは、必要に応じ
て作成され、破壊されます。
また、ファイルシステムは、mountpoint プロパティのマウントポイント設定を持
つことができます。このディレクトリは、必要に応じて作成され、ZFS は、
(/etc/fstab を編集しないで) "zfs mount -a" コマンドが呼び出されるとき、
ファイルシステムを自動的にマウントします。mountpoint プロパティを継承する
ことができるので、pool/home に /home のマウントポイントがあるなら、
pool/home/user は、自動的に /home/user のマウントポイントを継承します。
none のファイルシステム mountpoint プロパティは、ファイルシステムがマウン
トされることを防ぎます。
また、必要であるなら、伝統的なツール (mount(8), umount(8), fstab(5)) で
ZFS ファイルシステムを管理することができます。ファイルシステムのマウント
ポイントが legacy に設定されるなら、ZFS は、ファイルシステムを管理しよう
としません、管理者は、ファイルシステムをマウントしてアンマウントする責任
があります。
jail
"zfs jail" サブコマンドを使用することによって、ZFS データセットを jail に
アタッチすることができます。1 つの jail にデータセットを、そして同じデー
タセットの子どもを別の jail にアタッチすることはできません。jail の内部か
らのデータセットの管理を許可するためには、jailed プロパティが設定されてい
なければなりません、そして jail は、/dev/zfs デバイスにアクセスする必要が
あります。jail の内部から quota プロパティを変更することはできません。
jail の内部から ZFS データセットをマウントすることを可能にする方法に関す
る情報については、jail(8) を参照してください。
"zfs unjail" サブコマンドを使用して、ZFS データセットを jail からデタッチ
することができます。
データセットが jail にアタッチされ、jailed プロパティが設定された後、jail
管理者は、マウントポイントを受け付けできない値に設定したかもしれないの
で、jail 化されたファイルシステムを jail の外側でマウントすることはできま
せん。
細分化 (deduplication)
細分化は、格納されたデータの合計量を縮小するブロックレベルで重複する
(redundant) データを削除するプロセスです。ファイルシステムが dedup プロパ
ティを有効にするなら、重複データブロックは、同期して削除されます。結果
は、ユニークなデータだけが格納され、共通構成要素が、ファイル中に共有され
ることです。
固有のプロパティ (特性)
プロパティは、2 つのタイプ、固有のプロパティとユーザ定義 (または "ユー
ザ") プロパティに分割されます。固有のプロパティは、内部の統計値、または
ZFS の振る舞いの制御のいずれかをエクスポートします。さらに、固有のプロパ
ティは、編集可能か、または、読み込み専用のいずれかです。ユーザのプロパ
ティは、ZFS の振る舞いに効果はありませんが、利用者は、利用者の環境で意味
がある方法でデータセットに注釈を付けるために、それらを使用することができ
ます。ユーザプロパティに関する詳細については、下記の "ユーザのプロパティ"
のセクションを参照してください。
あらゆるデータセットには、様々な振る舞いの制御と同様に、データセットに関
する統計値をエクスポートする 1 組のプロパティがあります。プロパティは、子
供によって上書きされないなら、親から継承されます。いくつかのプロパティ
は、データセット (ファイルシステム、ボリュームまたはスナップショット) の
特定のタイプのみに適用されます。
人間に読み込み可能な接尾辞 (例えば、k, KB, M, Gb その他、ゼッタバイト
(zettabyte) のための Z まで) を使用して数値プロパティの値を指定することが
できます。次は、すべて有効な (で等しい) 仕様です:
1536M, 1.5g, 1.50GB
非数値のプロパティの値は、大文字と小文字を区別し、mountpoint, sharenfs と
sharesmb を除いて、小文字でなければなりません。
次の固有のプロパティは、データセットに関する読み込み専用の統計から成りま
す。これらのプロパティを設定することも継承することもできません。固有のプ
ロパティは、ほかで言及されないなら、すべてのデータセットタイプに適用され
ます。
available
データセットとそのすべての子供に利用可能な空間の合計は、プールに他の
活動がないことを仮定します。空間がプール内で共有されるので、プール内
の物理的なプールサイズ、クォータ、予約、または他のデータセットを含ん
で、いくつかのファクタによって利用可能性を制限することができます。
また、短いカラム名、avail によって、このプロパティを参照することがで
きます。
compressratio
スナップショットでないものについて、マルチプライア (multiplier) とし
て表現された、このデータセットの使用された空間のために達成された圧縮
比。使用されたプロパティは、子孫のデータセットを含み、クローンのため
に、オリジナルのスナップショットで共有された空間を含んでいません。ス
ナップショットについて、compressratio は、refcompressratio のプロパ
ティと同じです。次を実行することによって、圧縮をオンにすることができ
ます: "zfs set compression=on dataset" デフォルト値は、off です。
creation
このデータセットが作成された時間。
clones
スナップショットについて、このプロパティは、このスナップショットのク
ローンであるファイルシステムまたはボリュームのコンマで区切られたリス
トです。クローンの origin プロパティは、このスナップショットです。
clones プロパティが空でないなら、(-r または -f オプションをつけても)
このスナップショットを破壊することはできません。
defer_destroy
このプロパティは、"zfs destroy -d" コマンドを使用することによって、ス
ナップショットが遅延された破壊のためにマークされたなら、on です。そう
でなければ、プロパティは、off です。
filesystem_count
データセットのツリーで、この位置の下に存在するファイルシステムとボ
リュームの合計数。この値は、filesystem_limit がデータセットが存在する
ツリーのどこかに設定されたときのみ利用可能です。
logicalreferenced
このデータセットによって "論理的に" アクセス可能な空間の量。
referenced プロパティを参照してください。論理的な空間は、アプリケー
ションが理解するデータの量に近い量を与えて、compression と copies プ
ロパティの影響を無視します。しかしながら、メタデータによって消費され
る空間を含んでいます。
また、その短いカラム名 lrefer によって、このプロパティを参照すること
ができます。
logicalused
このデータセットとそのすべての子孫によって "論理的に" 消費される空間
の量。used プロパティを参照してください。論理的な空間は、アプリケー
ションが理解するデータの量に近い量を与えて、compression と copies プ
ロパティの影響を無視します。
また、その短いカラム名 lused によって、このプロパティを参照することが
できます。
mounted
ファイルシステムに関して、ファイルシステムが現在マウントされているか
どうかを示します。このプロパティは、yes または no を指定できます。
origin
クローン化されたファイルシステムまたはボリュームに関して、クローンが
作成されたスナップショット。また、clones プロパティを参照してくださ
い。
receive_resume_token
zfs receive -s から部分的に完了される状態を保存するファイルシステムま
たはボリュームについて、この不透明なトークンは、再開する zfs send -t
に提供することができ、zfs receive を完了します。
referenced
プール中の他のデータセットと共有されるかどうかわからない、このデータ
セットによってアクセス可能なデータの量。スナップショットまたはクロー
ンが作成されるとき、内容が同じであるので、作成されたファイルシステム
またはスナップショットと同じ空間の合計を最初に参照します。
また、短いカラム名、refer によって、このプロパティを参照することがで
きます。
refcompressratio
圧縮比は、マルチプライア (multiplier) として表現された、このデータ
セットの参照された空間のために達成しました。また、compressratio プロ
パティを参照してください。
snapshot_count
データセットのツリーで、この位置の下に存在するファイルシステムとボ
リュームの合計数。この値は、snapshot_limit がデータセットが存在するツ
リーのどこかに設定されたときのみ利用可能です。
type
データセットのタイプは、次の通りです: filesystem, volume, または
snapshot。
used
このデータセットとそのすべての子孫によって消費された空間の合計。これ
は、このデータセットのクォータと予約に対してチェックされる値です。使
用される空間は、このデータセットの予約を含んでいませんが、あらゆる子
孫のデータセットの予約を考慮に入れます。このデータセットが繰り返し破
壊されるなら、解放される空間の合計と同様に、データセットが親から消費
する空間の合計は、使用される空間と予約より大きくなります。
スナップショット ("スナップショット" セクションを参照) が作成されると
き、それらの空間は、スナップショットとファイルシステムの間と、ことに
よると以前のスナップショットと最初に共有されます。ファイルシステムが
変更するのに従って、以前に共有された空間は、スナップショットをユニー
クにし、使用されるスナップショットの空間でカウントされます。さらに、
スナップショットを削除すると、他のスナップショット (によって使用され
る) ユニークな空間の合計を増加することができます。
使用され、利用可能な、または参照される空間の合計は、保留中 (pending)
の変更を考慮に入れません。一般的に、保留中の変更は、数秒以内に計算さ
れます。fsync(2) または O_SYNC を使用するディスクの変更を遂行すること
は、空間の使用量の情報が直ちに更新されることを保証する必要はありませ
ん。
usedby*
usedby* プロパティは、used プロパティを、その空間が使用される様々な原
因に分解します。特に、used = usedbysnapshots + usedbydataset +
usedbychildren + usedbyrefreservation。これらのプロパティは、ZFS プー
ルのバージョン 13 のプール以降に作成されたデータセットのみに利用可能
です。
usedbysnapshots
このデータセットのスナップショットによって消費された空間の合計。特
に、このデータセットのスナップショットのすべてが破壊されるなら、解放
される空間の合計です。これは、複数のスナップショットによって空間を共
有できるので、単にスナップの used プロパティの合計でないことに注意し
てください。
usedbydataset
(あらゆる refreservation を削除し、必要なスナップショットまたは子孫を
破壊した後に) データセットが破壊されたなら、解放される、このデータ
セット自体によって使用される空間の合計。
usedbychildren
すべてのデータセットの子供が破壊されたなら、解放されるこのデータセッ
トの子供によって使用される空間の合計。
usedbyrefreservation
refreservation が削除されたなら、解放される、このデータセットで
refreservation セットによって使用された空間の合計。
userused@user
このデータセットで指定されたユーザによって消費された空間の合計。空間
は、"ls -l" によって表示されるように、それぞれのファイルの所有者に
チャージ (charge) されます。チャージされた空間の合計は、"du" と "ls
-s" によって表示されます。詳しい情報については、"zfs userspace" サブ
コマンドを参照してください。
非特権ユーザは、それら自身の空間の使用 (usage) のみアクセスできます。
ルートユーザ、または "zfs allow" で userused 特権が与えられたユーザ
は、あらゆる人の使用 (usage) にアクセスできます。
userused@... プロパティは、"zfs get all" によって表示されません。ユー
ザの名前は、次の形式の 1 つを使用して、@ シンボルの後に追加されなけれ
ばなりません:
• POSIX 名 (例えば、joe)
• POSIX 数値 ID (例えば、1001)
userrefs
このプロパティは、このスナップショットでユーザ holds の数に設定されま
す。ユーザ holds は、"zfs hold" コマンドを使用することによって設定さ
れます。
groupused@group
このデータセットで指定されたグループによって消費された空間の合計。"ls
-l" によって表示されるように、空間は、それぞれのファイルの所有者に
チャージ (charge) されます。詳しい情報については、userused@user プロ
パティを参照してください。
非特権ユーザは、それら自体のグループの空間の使用 (usage) にのみアクセ
スできます。ルートユーザ、または "zfs allow" で groupused 特権が与え
られたユーザは、すべてのグループの使用 (usage) にアクセスできます。
volblocksize=blocksize
ボリュームに対して、ボリュームのブロックサイズを指定します。いったん
ボリュームが書き込まれていると、blocksize を変更することはできないの
で、ボリュームの作成時間に設定されるべきです。ボリュームのためのデ
フォルトの blocksize は、8 キロバイトです。512 バイトから 128 キロバ
イトまでのあらゆる 2 の冪乗が有効です。
短いカラム名 volblock によってこのプロパティを参照することもできま
す。
written
前のスナップショットのときから、このデータセットに書き込まれた、
referenced 空間の量。
written@snapshot
指定されたスナップショットのときから、このデータセットに書き込まれた
referenced 空間の量。これは、このデータセットによって参照される空間で
すが、指定されたスナップショットによって参照されません。
snapshot は、短いスナップショット名 (単なる @ の後の部分) として指定
されます、その場合に、このデータセットと同じファイルシステム中のス
ナップショットとして解釈されます。snapshot は、クローンのためにオリジ
ナルのファイルシステム (またはオリジナルのファイルシステムのオリジナ
ルなど) のスナップショットである、完全なスナップショット名
(filesystem@snapshot) を指定できます。
ZFS データセットの振る舞いを変更するために、次の固有のプロパティを使用す
ることができます。
aclinherit=discard | noallow | restricted | passthrough | passthrough-x
ファイルとディレクトリが作成されるとき、ACL エントリがどのように継承
されるかを制御します。discard の aclinherit プロパティがあるファイル
システムは、ACL エントリをなにも継承しません。noallow の aclinherit
プロパティ値があるファイルシステムは、"deny" パーミッションを指定する
継承可能な ACL エントリだけを継承します。プロパティ値 restricted (デ
フォルト) は、ACL エントリが継承されるとき、write_acl と write_owner
パーミッションを削除します。passthrough の aclinherit プロパティ値が
あるファイルシステムは、それらが継承されるとき、ACL エントリに行われ
るあらゆる変更なしですべての継承可能な ACL エントリを継承します。
passthrough-x の aclinherit プロパティ値があるファイルシステムには、
ファイルの作成モードが実行ビットも要求される場合にだけ実行パーミッ
ションを継承する owner@, group@ と everyone@ ACE を除いて、
passthrough と同じ意味があります。
プロパティ値が passthrough に設定されるとき、ファイルは、継承可能な
ACE によって決定されるモードで作成されます。モードに影響する継承可能
な ACE が存在していないなら、モードは、アプリケーションから要求された
モードに従って設定されます。
aclmode=discard | groupmask | passthrough | restricted
chmod(2) の間に、どのように ACL が変更されるか制御します。discard (デ
フォルト) の aclmode プロパティがあるファイルシステムは、ファイルの
モードを表さないすべての ACL エントリを削除します。groupmask の
aclmode のプロパティは、それらが chmod(2) によって指定されたグループ
パーミッションより大きくないように、ACL で見つけられたすべての ALLOW
エントリで許可されたパーミッションを削減します。passthrough の
aclmode プロパティがあるファイルシステムは、ファイルまたはディレクト
リの新しいモードを表現するために、必要な ACL エントリを生成するか、ま
たは更新する以外の ACL に行われる変更がないことを示します。restricted
の aclmode プロパティによって、chmod(2) 操作は、エントリをモードに
よって表現することができない、重要な (non-trivial) ACL が、あるあらゆ
るファイルまたはディレクトリで使用されるとき、エラーを返します。
chmod(2) は、それらが同等の ACL エントリがないのような、ファイルまた
はディレクトリでセットユーザ ID (set user ID)、セットグループ ID (set
group ID) またはスティッキビットを変更するように要求されます。重要な
ACL があるファイルまたはディレクトリで chmod(2) を使用するために、
aclmode が restricted に設定されるとき、現在のモードを表現しないすべ
ての ACL エントリを最初に削除しなければなりません。
atime=on | off
ファイルが読み込まれるとき、ファイルのアクセス時刻を更新するかどうか
を制御します。このプロパティをオフにすることは、ファイルが読み込まれ
るとき、書き込みトラフィック生成することを避け、大幅な性能向上をもた
らすことができますが、メーラ (mailer) と他の同様のユーティリティを混
乱させるかもしれません。デフォルト値は、on です。
canmount=on | off | noauto
このプロパティが off に設定されるなら、ファイルシステムは、マウントす
ることができず、"zfs mount -a" によって無視されます。このプロパティを
off 設定することは、データセットには、継承することができる、通常の
mountpoint プロパティがまだあることを除いて、mountpoint プロパティを
none に設定することと同様です。このプロパティを off 設定することに
よって、データセットをプロパティを継承するための唯一メカニズムとして
使用することができます。canmount=off を設定する 1 つの例は、両方の
データセットの子供が同じディレクトリに現れることができように、同じ
mountpoint がある 2 つのデータセットがあることですが、異なっで継承さ
れる特性 (characteristic) があるかもしれません。
noauto 値が設定されるとき、明白にデータセットをマウントして、アンマウ
ントすることだけができます。データセットは、データセットが作成される
か、またはインポートされるとき、自動的にマウントされませんが、"zfs
mount -a" コマンドによってマウントされず、または "zfs umount -a" コマ
ンドによってアンマウントされることもありません。
このプロパティは、継承されません。
checksum=on | off | fletcher2 | fletcher4 | sha256 | noparity | sha512 |
skein
データの整合性を検証するために使用されるチェックサムを制御します。デ
フォルト値は、自動的に適切なアルゴリズム (現在、fletcher4 ですが、将
来のリリースで変更されるかもしれません) を選択する on です。値 off
は、ユーザデータに関して整合性のチェックを無効にします。値 noparity
は、整合性を無効にするだけでなく、ユーザデータのためのの保守するパリ
ティも無効にします。この設定は、RAID-Z プールに存在するダンプデバイス
によって内部的に使用され、あらゆる他のデータセットによっても使用され
るべきではありません。チェックサムを無効にすることは、推奨案ではあり
ません。 sha512, と skein チェックサムアルゴリズムは、プールの適切な
機能を有効にすることを必要とします。これらのアルゴリズムに関する詳細
については、zpool-features(7) を参照してください。
このプロパティを変更することは、新しく書かれたデータにだけに影響しま
す。
塩漬けされた (salted) チェックサムアルゴリズム (edonr, skein) は、現
在、ブートプールのあらゆるファイルシステムに対してサポートされていま
せん。
compression=on | off | lzjb | gzip | gzip-N | zle | lz4
このデータセットのために使用される圧縮アルゴリズムを制御します。圧縮
を on に設定することは、現在のデフォルト圧縮アルゴリズムが使用される
べきであることを示します。デフォルトは、圧縮比と多種多様の仕事量でよ
く動作することが予期されて、圧縮と圧縮復元のスピードのバランスをとり
ます。このプロパティのためのすべての他の設定と違って、固定された圧縮
タイプを選択しません。新しい圧縮アルゴリズムは、ZFS に追加され、プー
ルで有効にされ、デフォルトの圧縮アルゴリズムは、変わります。現在のデ
フォルト圧縮アルゴリズムは、lzjb または lz4_compress 機能が有効にされ
ているなら、lz4 のいずれかです。lzjb 圧縮アルゴリズムは、きちんとした
データ圧縮を提供している間、性能のために最適化されます。圧縮を on に
設定することは、lzjb 圧縮アルゴリズムを使用します。gzip 圧縮アルゴリ
ズムは、gzip(1) コマンドと同じ圧縮を使用します。利用者は、値 gzip-N
を使用することによって gzip レベルを指定できます。ここで、N は、1 (最
も速い) から 9 (最も良い圧縮比) の整数です。現在 gzip は、gzip-6
(gzip(1) のためのデフォルト) と同等です。zle 圧縮アルゴリズムは、0
(zero) の実行を圧縮します。
lz4 圧縮アルゴリズムは、lzjb アルゴリズムのための高性能の置き換えで
す。それは、lzjb より適度に高い圧縮比率と同様に、著しく速い圧縮と圧縮
復元を特色としますが、lz4_compress 機能を enabled (有効) に設定するこ
とでプール上でのみ使用することができます。ZFS 機能のフラグと
lz4_compress 機能の詳細については、zpool-features(7) を参照してくださ
い。
また、短いカラム名、compress によって、このプロパティを参照することが
できます。このプロパティを変更すると、新たに書き込まれたデータのみ影
響されます。
copies=1 | 2 | 3
このデータセットのために格納されるデータのコピーの数を制御します。こ
れらのコピーは、プール、例えば、ミラーリングまたは RAID-Z によって提
供される任意の冗長性に加えます。コピーは、できれば、異なったディスク
に格納されます。複数のコピーによって使用される空間は、関連するファイ
ルとデータセット、used プロパティの変更とクォータと予約に不利に作用す
るように変更されます。
このプロパティを変更することは、新たに書き込まれたデータにのみ影響さ
れます。したがって、-o copies=N オプションを使用することによって、
ファイルシステム作成時刻に、このプロパティを設定します。
dedup=on | off | verify | sha256[,verify] | sha512[,verify] |
skein[,verify]
データセットのための細分化 (deduplication) を設定します。デフォルト値
は、off です。デフォルト細分化のチェックサムは、sha256 (これは、将来
変更されるかもしれません) です。dedup が有効にされるとき、ここで定義
されたチェックサムは、checksum プロパティを上書きします。値に verify
に設定すると、sha256,verify に設定するのと同じ効果があります。
verify に設定するなら、ZFS は、ブロック内容が同一であることを確かめる
ために同じ署名がある 2 つのブロックの場合に、バイト毎 (byte-to-byte)
の比較を行います。
devices=on | off
devices プロパティは、現在 FreeBSD でサポートされていません。
exec=on | off
このファイルシステム内からプロセスを実行できるかどうかを制御します。
デフォルト値は、on です。
mlslabel=label | none
mlslabel プロパティは、現在 FreeBSD でサポートされていません。
filesystem_limit=count | none
データセットのツリーで、このポイントの下で存在することができるファイ
ルシステムとボリュームの数を制限します。制限は、ユーザが制限を変更す
ることが許可されるなら、強制されません。既に filesystem_limit がある
ファイルシステムの子孫で filesystem_limit を設定することは、先祖の
filesystem_limit に優先するのではなくむしろ、追加の制限を与えます。こ
の機能は、使用されるために有効にされなければなりません (zpool-
features(7) を参照)。
mountpoint=path | none | legacy
このファイルシステムに使用するマウントポイントを制御します。このプロ
パティがどのように使用されているかに関する詳細については、"マウントポ
イント" セクションを参照してください。
mountpoint プロパティがファイルシステムのために変更されるとき、ファイ
ルシステムとマウントポイントを継承するあらゆる子供は、アンマウントさ
れます。新しい値が legacy であるなら、それらは、アンマウントされたま
まで残ります。そうでなければ、プロパティが以前に legacy または none
であったか、またはプロパティが変更される前にそれらがマウントされてい
るなら、それらは、新しい位置に自動的に再マウントされます。さらに、任
意の共有ファイルシステムは、共有を解除され、新しい位置で共有されま
す。
nbmand=on | off
nbmand プロパティは、現在 FreeBSD でサポートされていません。
primarycache=all | none | metadata
主要なキャッシュ (ARC) でキャッシュされるものを制御します。このプロパ
ティが all に設定されるなら、ユーザデータとメタデータの両方がキャッ
シュされます。このプロパティが none に設定されるなら、ユーザデータも
メタデータもキャッシュされません。このプロパティが metadata に設定さ
れるなら、メタデータだけがキャッシュされます。デフォルト値は、all で
す。
quota=size | none
データセットとその子孫が消費できる空間の合計を制限します。このプロパ
ティは、使用される空間の合計で強固な制限を強制します。これは、ファイ
ルシステムとスナップショットを含む子孫によって消費されたすべての空間
を含んでいます。既にクォータがあるデータセットの子孫でクォータを設定
することは、先祖のクォータを上書きしませんが、むしろ追加の制限を強要
します。
暗黙のクォータとして動作する volsize プロパティとして、ボリュームで
クォータを設定することはできません。
snapshot_limit=count | none
データセットとその子孫で作成することができるスナップショットの数を制
限します。既に snapshot_limit があるデータセットの子孫で
snapshot_limit を設定することは、先祖の snapshot_limit に優先するので
はなくむしろ、追加の制限を与えます。制限は、ユーザが制限を変更するこ
とが許可されるなら、強制されません。例えば、これは、グローバルなゾー
ンから取られた再帰的なスナップショットが jail 内の各委任されたデータ
セットに対して有効であることを意味します。この機能は、使用されるため
に有効にされなければなりません (zpool-features(7) を参照)。
userquota@user=size | none
指定されたユーザによって消費された空間の合計の制限します。refquota プ
ロパティに似ている、userquota 空間の計算は、スナップショットとクロー
ンのような、子孫のデータセットによって使用される空間を含んでいませ
ん。ユーザ空間の消費は、userspace@user プロパティによって識別されま
す。
ユーザのクォータの強制は、数秒遅延されるかもしれません。この遅延は、
ユーザが、それらが、クォータを越え、EDQUOT エラーメッセージで追加の書
き込みを拒否し始めるシステム通知の前に、それらのクォータを超えるかも
しれないことを意味します。詳しい情報については、"zfs userspace" サブ
コマンドを参照してください。
非特権ユーザは、それら自体のグループの空間の使用法にのみアクセスでき
ます。ルートユーザ、または "zfs allow" で userquota 特権が与えられた
ユーザは、あらゆる人のクォータ (quota) を取得して設定できます。
このプロパティは、ボリューム上で、バージョン 4 の前のファイルシステム
上で、または、バージョン 15 の前のプール上で利用可能ではありません。
userquota@... プロパティは、"zfs get all" によって表示されません。
ユーザの名前は、次の形式の 1 つを使用して、@ シンボルの後に追加されな
ければなりません:
• POSIX name (例えば、joe)
• POSIX 数値 ID (例えば、1001)
groupquota@group=size | none
指定されたグループによって消費された空間の合計を制限する。グループ空
間の消費は、userquota@user プロパティによって識別されます。
非特権ユーザは、それら自体のグループの空間の使用法にのみアクセスでき
ます。ルートユーザ、または "zfs allow" で groupquota 特権が与えられた
ユーザは、すべてのグループのクォータ (quota) を取得して設定できます。
readonly=on | off
このデータセットを変更できるかどうかを制御します。デフォルト値は、off
です。
recordsize=size
ファイルシステムのファイルに対して推奨されているブロックサイズを指定
します。このプロパティは、固定サイズのレコードのファイルをアクセスす
るデータベースワークロード (作業負荷) で使用するように単に設計されて
います。ZFS は、典型的なアクセスパターンのために最適化された内部のア
ルゴリズムにしたがって自動的にブロックサイズを調整します。
非常に大きなファイルを作成するが、小さくランダムなチャンクでそれらを
アクセスするデータベースに関して、これらのアルゴリズムは、準最適であ
るかもしれません。データベースのレコードサイズ以上の recordsize を指
定することは、著しい性能の向上をもたらすことができます。汎用のファイ
ルシステムのためにこのプロパティを使用することは、強く失望させられ、
性能に悪影響を与えるかもしれません。
指定されたサイズは、512 キロバイト以上で 128 キロバイト以下の 2 の冪
乗でなければなりません。large_blocks 機能がプールで有効にされているな
ら、サイズは、1 Mbyte までです。ZFS 機能のフラグに関する詳細について
は、zpool-features(7) を参照してください。
ファイルシステムの recordsize を変更することは、その後作成されたファ
イルにのみ影響します。既存のファイルは、影響されません。
また、短いカラム名、recsize によって、このプロパティを参照することが
できます。
redundant_metadata=all | most
メタデータのどのタイプが重複して格納されるかを制御します。単一のブ
ロックが壊れているなら、失われた利用者データの量が、制限されることが
できるように、ZFS は、メタデータの特別のコピーを格納します。この特別
のコピーは、プールレベル (例えば、ミラーリングまたは RAID-Z によっ
て、) 提供されるあらゆる冗長のために追加され、(合計 3 つのコピーまで)
の copies プロパティによって指定される特別のコピーに追加されます。例
えば、プールが copies=2 と redundant_metadata=most でミラーリングされ
るなら、ZFS は、ほとんどのメタデータの 6 つのコピー、とデータといくつ
かのメタデータの 4 つのコピーを格納します。
all に設定されるとき、ZFS は、すべてのメタデータの特別のコピーを格納
します。単一のオンディスクのブロックが壊れているなら、最悪の場合に
(recordsize バイトである、) ユーザデータの単一のブロックを失うかもし
れません。
most に設定されるとき、ZFS は、ほとんどのタイプのメタデータの特別のコ
ピーを格納します。これは、より少ないメタデータを書き込まなければなら
ないので、ランダムな書き込みの性能を改善することができます。実際のと
ころ、最悪の場合に単一オンディスクのブロックが壊れているなら、ユーザ
データの (of それぞれ、 recordsize バイトの) 約 100 のブロックを失わ
れるかもしれません。メタデータのブロックが重複して格納される特別の振
る舞いは、将来のリリースで変更されるかもしれません。
デフォルト値は、all です。
refquota=size | none
データセットが消費できる空間の合計を制限します。このプロパティは、使
用される空間の合計で強固な制限を強制します。この強固な制限は、ファイ
ルシステムとスナップショットを含む子孫によって使用される空間を含んで
いません。
refreservation=size | none
その子孫を含まないデータセットに保証された最小の空間の合計。使用され
る空間の合計が、この値を下回るとき、データセットは、まるで
refreservation によって指定された空間の合計を手に入れているかのように
扱われます。refreservation 予約は、使用される親のデータセットの空間の
割合を占め、親のデータセットのクォータと予約に逆らってカウントしま
す。
refreservation が設定されているなら、スナップショットは、データセット
の現在の多数の "referenced" バイトを収容するために、この予約の外に十
分な空きプール空間がある場合のみ許可されます。
また、短いカラム名、refreserv によって、このプロパティを参照すること
ができます。
reservation=size | none
データセットとその子孫に保証された最小の空間の合計。使用される空間の
合計が、この値を下回るとき、データセットは、まるで予約によって指定さ
れた空間の合計を手に入れているかのように扱われます。予約は、使用され
る親のデータセットの空間の割合を占め、親のデータセットのクォータと予
約に逆らってカウントします。
また、短いカラム名、reserv によって、このプロパティを参照することがで
きます。
secondarycache=all | none | metadata
2 次キャッシュ (L2ARC) でキャッシュされるものを制御します。このプロパ
ティが all に設定されるなら、ユーザデータとメタデータの両方がキャッ
シュされます。このプロパティが none に設定されるなら、ユーザデータも
メタデータもキャッシュされません。このプロパティが metadata に設定さ
れるなら、メタデータだけがキャッシュされます。デフォルト値は、all で
す。
setuid=on | off
ファイルシステムのためにセット-UID ビットが尊重されるかどうかを制御し
ます。デフォルト値は、on です。
sharesmb=on | off | opts
sharesmb プロパティは、現在 FreeBSD で効果がありません。
sharenfs=on | off | opts
ファイルシステムが NFS を通して共有されるかどうか、どのようなオプショ
ンが使用されるかを制御します。off の sharenfs プロパティがあるファイ
ルシステムは、exports(5) を通して伝統的な方法で管理されます。そうでな
ければ、ファイルシステムは、"zfs share" と "zfs unshare" コマンドで自
動的に共有され、非共有されます。プロパティが on に設定されるなら、NFS
エクスポートオプションは、使用されません。そうでなければ、NFS エクス
ポートオプションは、このプロパティの内容と同等です。エクスポートオプ
ションは、コンマで区切られます。有効なオプションのリストについては、
exports(5) を参照してください。
sharenfs プロパティがデータセットのために変更されるとき、mountd(8)
デーモンが再ロードされます。
logbias=latency | throughput
このデータセットの同期要求の取り扱いに関して ZFS にヒントを提供しま
す。logbias が latency (デフォルト) に設定されるなら、ZFS は、低い待
ち時間で要求を扱う (設定されるなら) プールログデバイスを使用します。
logbias が throughput に設定されるなら、ZFS は、設定されたプールのロ
グデバイスを使用しません。ZFS は、グローバルなプールのスループットと
効率的なリソースの使用のための同期操作を代わりに最適化します。
snapdir=hidden | visible
.zfs ディレクトリが、"スナップショット" セクションで議論されるよう
に、ファイルシステムのルートで隠されるか、または目に見えるかどうかを
制御します。デフォルト値は、hidden です。
sync=standard | always | disabled
同期要求 (例えば、fsync(2), O_DSYNC の振る舞いを制御します。このプロ
パティは、次の値を受け付けます:
standard これは、すべての同期要求が安定した記憶装置に書き込ま
れ、すべてのデータがデバイスコントローラによってキャッ
シュされないことを保証するためにフラッシュされることを
保証する、POSIX に明記された振る舞いです (これは、デ
フォルトです)
always すべてのファイルシステムのトランザクションは、それらの
システムコールが返る前に、書き込まれ、スラッシュされま
す。これには、大きな性能のペナルティがあります。
disabled 同期要求を無効にします。ファイルシステムのトランザク
ションは、単に安定した記憶装置に周期的に書き込まれま
す。このオプションは、最も高い性能を与えます。しかしな
がら、ZFS がデータベースまたは NFS のようなアプリケー
ションの同期トランザクションの要求を無視するので、たい
へん危険です。管理者は、危険が理解されるときのみ、この
オプションを使用するべきです。
volsize=size
ボリュームに関して、ボリュームの論理的なサイズを指定します。デフォル
トで、ボリュームを作成することは、等しいサイズの予約が確立されます。9
以上のバージョン番号がある記憶域プールに関して、refreservation が代わ
りに設定されます。volsize へのあらゆる変更は、予約 (または、
refreservation) への同様の変更に反映されます。volblocksize の倍数のみ
を volsize に設定することができ、0 には設定できません。
予約は、消費者に対して予期していなかった振る舞いを防ぐためにボリュー
ムの論理的なサイズと等しく保持されます。予約がなければ、ボリュームが
どのように使用されているかによって、ボリュームは、空間を使い果たす、
未定義の振る舞いまたはデータの不正をもたらすかもしれません。また、こ
れらの効果は、それが使用中である間 (特にサイズを縮めるとき) ボリュー
ムサイズを変更するとき、生じるかもしれません。ボリュームサイズを調整
するとき、細心の注意が払われるべきです。
推薦されませんが、"zfs create -V" コマンドに -s オプションを指定する
か、またはボリュームが作成された後に予約を変更することによって、
"sparse volume" (またの名を "thin provisioning" (薄い供給)) を作成す
ることができます。"sparse volume" は、予約が、ボリュームサイズより少
ないボリュームです。その結果、スパースボリュームに書き込むことは、
プールが少ない空間のときに、ENOSPC で失敗するかもしれません。スパース
ボリュームにおいて、volsize を変更することは、予約に反映されません。
volmode=default | geom | dev | none
このプロパティは、OS にどのようなボリュームを公開するべきであるかを指
定します。それを geom に設定することは、最大の機能性を提供して、
geom(4) プロバイダとしてボリュームを公開します。それを dev に設定する
ことは、devfs の cdev デバイスとしてのみボリュームを公開します。生の
ディスクデバイスファイルとしてのみ、そのようなボリュームをアクセスす
ることができます、すなわち、それらは、パーティション化、マウント、
RAID の共有、など、行うことができませんが、それらは、より速く、より安
全となる、NAS または VM 記憶デバイスのような信頼されい消費者でいくつ
かのシナリオを使用します。none に設定されたプロパティがあるボリューム
は、ZFS の外側で公開されませんが、バックアップ目的のために適してい
る、スナップショット、クローン、折り返し、など、行うことができます。
値 default は、ボリューム説明がシステム全体の sysctl/調整変数
vfs.zfs.vol.mode によって制御されることを意味します、ここで、geom,
dev と none は、それぞれ 1、2 と 3 としてエンコード (コード化) されま
す。デフォルト値は、geom です。このプロパティをいつでも変更することが
できますが、これまでのところ、それは、ボリューム生成し、プールをイン
ポートする間のみ処理されます。
vscan=off | on
vscan プロパティは、現在 FreeBSD でサポートされていません。
xattr=off | on
xattr プロパティは、現在 FreeBSD でサポートされていません。
jailed=off | on
データセットが jail の内部から管理されるかどうかを制御します。詳細に
ついては、"jail" セクションを参照してください。デフォルト値は、off で
す。
ファイルシステムが作成された後に、次の 3 つのプロパティを変更することがで
きません、したがって、ファイルシステムが作成されるとき、設定されるべきで
す。プロパティが "zfs create" または zpool create コマンドで設定されない
なら、これらのプロパティは、親のデータセットから継承されます。親のデータ
セットがこれらの機能がサポートされているより前に作成されたために、これら
のプロパティを欠いているなら、新しいファイルシステムには、これらのプロパ
ティのためのデフォルト値があります。
casesensitivity=sensitive | insensitive | mixed
ファイルシステムによって使用されるアルゴリズムと一致するファイル名
が大文字小文字を区別するか、大文字小文字を区別しないか、または一致
する両方のスタイルの組み合わせを許可するべきであるかどうかを示しま
す。casesensitivity (大文字と小文字の区別) プロパティのためのデフォ
ルト値は、sensitive (区別する) です。伝統的に、UNIX と POSIX ファイ
ルシステムには、大文字小文字を区別するファイル名があります。
casesensitivity (大文字と小文字の区別) プロパティのための mixed 値
は、照合の振る舞いでファイルシステムが大文字小文字を区別すること
と、大文字小文字を区別しないことの両方の要求をサポートすることがで
きることを示します。
normalization=none | formC | formD | formKC | formKD
2 つのファイル名が比較されるときはいつも、ファイルシステムがファイ
ル名の unicode 正規化を実行するべきであるかどうかと、どの正規化アル
ゴリズムが使用されるべきであるかを示します。ファイル名は、常に変更
せずに格納されて、名前は、あらゆる比較プロセスの一部として正規化さ
れます。このプロパティが none 以外の正しい値に設定されて、utf8only
プロパティが不特定のままにされたなら、utf8only プロパティは、自動的
に on に設定されます。normalization プロパティのデフォルト値は、
none です。ファイルシステムが作成された後に、このプロパティを変更す
ることはできません。
utf8only=on | off
ファイルシステムが UTF-8 文字コードセットに存在しない文字を含んでい
るファイル名を拒否するべきであるかどうかを示します。このプロパティ
が明白に off に設定されるなら、正規化プロパティは、明白に設定されて
いないか、または none に設定されているかのいずれかでなければなりま
せん。utf8only プロパティのためのデフォルト値は、off です。ファイル
システムが作成された後に、このプロパティを変更することができませ
ん。
また、casesensitivity, normalization と utf8only プロパティは、ZFS 委譲管
理機能を使用することによって非特権ユーザに割り当てることができる新しい
パーミッションです。
一時的なマウントポイントのプロパティ (特性)
古いマウントのための mount(8) または通常のファイルシステムのための "zfs
mount" のいずれかを通して、ファイルシステムがマウントされるとき、そのマウ
ントオプションは、そのプロパティに従って設定されます。プロパティとマウン
トオプションの間の相互関係は、次の通りです:
プロパティ マウントポイント
atime atime/noatime
exec exec/noexec
readonly ro/rw
setuid suid/nosuid
さらに、ディスクに格納されるプロパティに影響しないで、-o オプションを使用
してマウント毎のベースで、これらのオプションを設定することができます。コ
マンド行で指定された値は、データセットに格納された値を上書きします。これ
らのプロパティは、"zfs get" コマンドによって "temporary" として報告されま
す。プロパティがデータセットがマウントされる間に変更されるなら、新しい設
定は、任意の一時的な設定を上書きします。
ユーザプロパティ (特性)
標準の固有のプロパティに加えて、ZFS は、任意のユーザのプロパティをサポー
トします。ユーザのプロパティは、ZFS の振る舞いに効果がありませんが、アプ
リケーションまたは管理者は、データセット (ファイルシステム、ボリュームと
スナップショット) に注釈を付けるためにそれらを使用できます。
ユーザのプロパティの名前は、固有のプロパティからそれらを区別するために、
コロン (:) 文字を含まなければなりません。それらは、小文字、数値、と次の句
読点文字を含みます: コロン (:)、ダッシュ (-)、ピリオド (.) と下線 (_)。予
想された規約は、プロパティの名前が module:property のような 2 つの部分に
分割されますが、この名前空間は、ZFS によって強制されません。ユーザプロパ
ティの名前は、多くても 256 文字を指定でき、ダッシュ (-) で始めることはで
きません。
ユーザのプロパティのプログラム的な使用を行うとき、2 つの独自に開発された
パッケージが異なる目的のために同じプロパティの名前を使用する変更を削減す
るために、プロパティの名前の module 構成要素のための逆にされた DNS ドメイ
ン名を使用するためことを強く示唆されます。com.sun で始まるプロパティは、
Sun Microsystems によって使用されるために予約されています。
ユーザのプロパティの値は、任意の文字列であり、常に継承され、決して有効に
されません。固有のプロパティとユーザのプロパティの両方を操作するために、
プロパティ ("zfs list", "zfs get", "zfs set" とその他) で動作するすべての
コマンドを使用することができます。ユーザのプロパティをクリアするために
"zfs inherit" コマンドを使用します。プロパティがあらゆる親のデータセット
で定義されるなら、それは、完全に削除されます。プロパティの値は、1024 文字
に制限されます。
サブコマンド
状態を変更するすべてのサブコマンドは、それらの元の形式でプールに永続的に
ログ記録されます。
zfs [-?]
ヘルプメッセージを表示します。
zfs create [-pu] [-o property=value]... filesystem
新しい ZFS ファイルシステムを作成します。ファイルシステムは、親から継
承された mountpoint プロパティに従って、自動的にマウントされます。
-p すべての存在しない親のデータセットを作成します。この様に作成
されたデータセットは、それらの親から継承された mountpoint プ
ロパティに従って、自動的にマウントされます。-o オプションを使
用してコマンド行で指定されたあらゆるプロパティは、無視されま
す。ターゲットファイルシステムが既に存在しているなら、操作
は、完全に成功します。
-u 新しく作成されたファイルシステムは、マウントされません。
-o property=value
まるでコマンド "zfs set property=value" がデータセットが作成
されると同時に呼び出されるかのように指定されたプロパティを設
定します。また、作成時間で任意の編集可能な ZFS のプロパティも
設定することができます。複数の -o オプションを指定することが
できます。同じプロパティが複数の -o オプションで指定されるな
ら、エラーの結果となります。
zfs create [-ps] [-b blocksize] [-o property=value]... -V size volume
与えられたサイズのボリュームを作成します。ボリュームは、
/dev/zvol/path のブロックデバイスとしてエクスポートされます。ここで、
path は、ZFS 名前空間のボリュームの名前です。サイズは、デバイスによっ
てエクスポートされる論理的なサイズを表します。デフォルトで、等しいサ
イズの予約が作成されます。
ボリュームには、blocksize にかかわらずのブロックの整数値があることを
保証するために、size は、最も近い 128 キロバイトに自動的に丸められま
す。
-p すべての存在しない親のデータセットを作成します。この様に作成
されたデータセットは、それらの親から継承された mountpoint プ
ロパティに従って、自動的にマウントされます。-o オプションを使
用してコマンド行で指定されたあらゆるプロパティは、無視されま
す。ターゲットファイルシステムが既に存在しているなら、操作
は、完全に成功します。
-s 予約なしでスパースボリュームを作成します。スパースボリューム
に関する詳細については、"固有のプロパティ" セクションの
volsize を参照してください。
-b blocksize
-o volblocksize=blocksize と同等です。このオプションが、-o
volblocksize とともに指定されるなら、結果の振る舞いは、未定義
です。
-o property=value
まるで "zfs set property=value" コマンドがデータセットが作成
されると同時に呼び出されるかのように指定されたプロパティを設
定します。また、あらゆる編集可能な ZFS のプロパティも作成時間
で設定することができます。複数の -o オプションを指定すること
ができます。同じプロパティが複数の -o オプションで指定される
なら、エラーの結果となります。
zfs destroy [-fnpRrv] filesystem|volume
与えられたデータセットを破壊します。デフォルトで、コマンドは、現在共
有される任意のファイルシステムを非共有化して、現在マウントされている
任意のファイルシステムをアンマウントし、アクティブな子孫 (子供、また
はクローン) があるデータセットを破壊するために拒否します
-r すべての子供を繰り返し破壊します。
-R ターゲットの階層構造の外でクローン化されたファイルシステムを
含んで、すべての子孫を繰り返し破壊します。
-f "zfs unmount -f" コマンドを使用して任意のファイルシステムを強
制的にアンマウントします。このオプションは、ファイルシステム
以外、またはアンマウントされたファイルシステムで効果はありま
せん。
-n 予行演習 ("no-op") の削除を行います。データは、削除されませ
ん。これは、何のデータが削除されるか決定するために -v または
-p フラグとともに役に立ちます。
-p 削除されたデータに関するマシンに解析可能な冗長な情報を印刷し
ます。
-v 削除されたデータに関する冗長な情報を印刷します。
それらがプールの大部分を破壊でき、使用中のマウントされたファイルシス
テムのための予期しない振る舞いを引き起こすので、-r または -R オプショ
ンのいずれかを適用するとき、最新の注意を払うべきです。
zfs destroy [-dnpRrv] snapshot[%snapname][,...]
与えられたスナップショットは、-d オプションのない "zfs destroy" コマ
ンドが、それを破壊した時かつその時に限り、直ちに破壊されます。そのよ
うな即時の破壊は、例えば、スナップショットにはクローンがなく、ユーザ
によって開始された参照カウントが 0 であったなら、起こるでしょう。
スナップショットが即時の破壊のための資格を得ていないなら、それは、延
期された削除のためにマークされます。この状態で、上記にリストされた前
提条件の両方が、破壊される点で会うまで、使用可能な目に見えるスナップ
ショットとして存在しています。
スナップショットの包括的な範囲は、パーセント記号 (%) がある最初のス
ナップショットと最後のスナップショットを分離することによって指定され
ます。最初および/または最後のスナップショットは、空白のままとなり、そ
の場合には、ファイルシステムの最も古いか、または最新のスナップショッ
トのの意味を含みます。
同じファイルシステムまたはボリュームの複数のスナップショット (また
は、スナップショットの範囲) は、スナップショットのコンマで区切られた
リストで指定されます。複数のスナップショットを識別するために範囲また
はコンマで区切られたリストを使用するとき、(@ の後の部分の) スナップ
ショットの短い名前だけが指定されるべきです。
-r 子孫のファイルシステムでこの名前がある状態で、すべてのスナッ
プショットを破壊 (するか、または、延期された削除のためのマー
ク) します。
-R クローン、スナップショットと子プロセスを含んで、これらのス
ナップショットのすべてのクローンを再帰的に破壊します。このフ
ラグが指定されるなら、-d フラグは、効果がありません。
-n 予行演習 ("no-op") の削除を行います。データは、削除されませ
ん。これは、何のデータが削除されるか決定するために -v または
-p フラグとともに役に立ちます。
-p 削除されたデータに関するマシンに解析可能な冗長な情報を印刷し
ます。
-v 削除されたデータに関する冗長な情報を印刷します。
-d スナップショット削除を延期します。
それらがプールの大部分を破壊でき、使用中のマウントされたファイルシス
テムのための予期しない振る舞いを引き起こすので、-r または -R オプショ
ンのいずれかを適用するとき、最新の注意を払うべきです。
zfs destroy filesystem|volume#bookmark
与えられたブックマークは、破壊されます。
zfs snapshot|snap [-r] [-o property=value]...
filesystem@snapname|volume@snapname
filesystem@snapname|volume@snapname...
与えられた名前でスナップショットを作成します。ファイルシステムへの成
功したシステムコールによってすべての以前の変更は、スナップショットの
一部分です。すべてのスナップショットが時間内に同じ瞬間に対応できるよ
うに、スナップショットは、不可分に取られます。詳細については、"スナッ
プショット" セクションを参照してください。
-r すべての子孫のデータセットのスナップショットを繰り返し作成し
ます。
-o property=value
指定されたプロパティを設定します。詳細については、"zfs
create" を参照してください。
zfs rollback [-rRf] snapshot
与えられたデータセットを前のスナップショットにロールバック (後退) し
ます。データセットがロールバックされるとき、スナップショット以後に変
更されたすべてのデータは、破棄され、データセットは、スナップショット
の時点の状態に戻ります。デフォルトで、コマンドは、最新のもの以外のス
ナップショットをロールバックすることを拒否します。そうするためには、
-r オプションを指定することによって、すべての中間的なスナップショット
とブックマークを破壊しなければなりません。
-rR オプションは、再帰的なスナップショットの子どもスナップショットを
再帰的に破壊しません。指定されたファイルシステムの直接のスナップ
ショットだけが、これらのオプションのいずれかによって破壊されます。再
帰的なスナップショットを完全にロールバック (後退) するために、利用者
は、個別の子どものスナップショットをロールバックしなければなりませ
ん。
-r 指定したものより最近のあらゆるスナップショットとブックマーク
を破壊します。
-R それらのスナップショットのあらゆるクローンと同様に最近の任意
のスナップショットとブックマークを破壊します。
-f -R オプションを使用して、破壊されるあらゆるクローンファイルシ
ステムを強制的にアンマウントします。
zfs clone [-p] [-o property=value]... snapshot filesystem|volume
与えられたスナップショットのクローンを作成します。詳細については、"ク
ローン" セクションを参照してください。ZFS 階層構造でターゲットのデー
タセットをどこでも位置付けすることができ、オリジナルと同じタイプとし
て作成します。
-p すべての存在しない親のデータセットを作成します。この様に作成
されたデータセットは、それらの親から引き継がれた mountpoint
プロパティに従って、自動的にマウントされます。ターゲットファ
イルシステムまたはボリュームが既に存在しているなら、操作は、
完全に成功します。
-o property=value
指定されたプロパティを設定します。詳細については、"zfs
create" を参照してください。
zfs promote clone-filesystem
クローンファイルシステムが、もはや "origin" スナップショットに依存し
ないように昇格させます。これで、クローンが作成されたファイルシステム
を破壊することが可能となります。origin ファイルシステムが指定された
ファイルシステムのクローンになるようにするために、クローンの親と子の
依存関係が、逆にされます。
クローン化されたスナップショットと、このスナップショットの前のあらゆ
るスナップショットは、現在、昇格されたクローンによって所有されます。
それらが使用する空間は、origin ファイルシステムから昇格されたクローン
まで移動するので、十分な空間は、これらのスナップショットに対応するた
めに利用可能でなければなりません。新しい空間は、この操作によって消費
されませんが、空間のアカウントは、調整されます。昇格されたクローンに
は、それ自体のあらゆる競合しているスナップショットの名前があってはい
けません。あらゆる競合しているスナップショットの名前を変更するために
rename サブコマンドを使用することができます。
zfs rename [-f] filesystem|volume|snapshot filesystem|volume|snapshot
zfs rename [-f] -p filesystem|volume filesystem|volume
zfs rename -u [-p] filesystem filesystem
与えられたデータセットの名前を変更します。スナップショットを除いて、
ZFS 階層構造の新しいターゲットをどこにでも位置付けできます。親のファ
イルシステムまたはボリューム中でスナップショットの名前を変更すること
だけができます。スナップショットの名前を変更するとき、スナップショッ
トの親のファイルシステムは、2 番目の引数の一部として指定される必要は
ありません。名前が変更されたファイルシステムは、マウントポイントを継
承することができます、その場合、それらは、アンマウントされ、新しいマ
ウントポイントに再マウントされます。
-p すべての存在しない親のデータセットを作成します。この様に作成
されたデータセットは、それらの親から継承された mountpoint プ
ロパティに従って、自動的にマウントされます。
-u 名前を変更する間にファイルシステムを再マウントしません。ファ
イルシステムの mountpoint プロパティが legacy または none 設
定されないなら、このオプションが与えられなくても、ファイルシ
ステムは、アンマウントされません。
-f プロセスでアンマウントされる必要があるあらゆるファイルシステ
ムを強制的にアンマウントします。-u フラグとともに使用されるな
ら、このフラグには、効果がありません。
zfs rename -r snapshot snapshot
すべての子孫のデータセットのスナップを繰り返し名前を変更します。ス
ナップは、繰り返し名前を変更できる唯一のデータセットです。
zfs list [-r|-d depth] [-Hp] [-o property[,property]...] [-t
type[,type]...] [-s property]... [-S property]...
filesystem|volume|snapshot...
表の形式で与えられたデータセットのプロパティの情報をリストします。指
定されるなら、利用者は、絶対パス名または相対的なパス名によってプロパ
ティの情報をリストすることができます。デフォルトで、すべてのファイル
システムとボリュームが表示されます。スナップショットは、listsnaps プ
ロパティが on (デフォルトは、off) であるなら、表示されます。次の
フィールド、name, used, available, referenced, mountpoint が表示され
ます、
-r コマンド行のデータセットのあらゆる子供を繰り返し表示します。
-d depth
再帰を depth に制限して、データセットのあらゆる子供を再帰的に
表示します。depth (深さ) 1 は、データセットとその直接の子供だ
けを表示します。
-H スクリプトモードを使用します。任意の空白類の代わりに単一のタ
ブによってヘッダと分離されたフィールドを印刷 (表示) しませ
ん。
-p 解析可能な (正確な) 値で数値を表示します。
-o property[,property]...
表示するためにコンマで区切られたプロパティのリスト。プロパ
ティは、次の通りでなければなりません:
• プロパティの 1 つは、"固有のプロパティ" セクションで説
明されます。
• ユーザプロパティ。
• データセット名を表示する値 name。
• ファイルシステムとボリュームの空間使用率プロパティを表
示する値 space。これは、-o
name,avail,used,usedsnap,usedds,usedrefreserv,usedchild
-t filesystem,volume 構文を指定するためのショートカット
です。
-t type[,type]...
表示するタイプ (type) のコンマで区切られたリスト、ここで type
は、filesystem, snapshot, snap, volume, bookmark または all
の 1 です。例えば、-t snapshot と指定すると、スナップショット
だけが表示されます。
-s property
プロパティの値に基づく昇順でカラムによって出力をソートするた
めのプロパティ。プロパティは、"プロパティ" セクションで説明さ
れたプロパティの 1 つ、またはデータセット名によってソートされ
る特有の値 name でなければなりません。複数の -s プロパティオ
プションを使用して、複数のプロパティを一度に指定することがで
きます。複数の -s オプションは、重要性が減少する順序で左から
右にで評価されます。
次は、ソート基準のリストです:
• 数値の順序で数値タイプのソート。
• アルファベットの順序で文字列タイプのソート。
• 指定された順序にかかわらず、行から定数の下端の行のソー
トのための不適切なタイプ。
• ソートオプションが指定されないなら、"zfs list" の既存の
振る舞いが、保存されます。
-S property
-s オプションと同じですが、降順でプロパティをソートします。
zfs set property=value [property=value]... filesystem|volume|snapshot
各データセットのための与えられた (複数の) 値へのプロパティまたはプロ
パティのリストを設定します。いくつかのプロパティだけを編集することが
できます。どのようなプロパティを設定できるか、と受け付け可能な値に関
する詳細については、"プロパティ" セクションを参照してください。正確な
値として、または B, K, M, G, T, P, E, Z (それぞれ、バイト、キロバイ
ト、メガバイト、ギガバイト、テラバイト、ペタバイト、エクサバイト
(exabyte) またはゼッタバイト (zettabyte)) の接尾辞をつけて人間に読み
込み可能な形式で数値を指定することができます。ユーザプロパティをス
ナップショットで設定することができます。詳細については、"ユーザプロパ
ティ (特性)" セクションを参照してください。
zfs get [-r|-d depth] [-Hp] [-o all | field[,field]...] [-t
type[,type]...] [-s source[,source]...] all | property[,property]...
filesystem|volume|snapshot|bookmark...
与えられたデータセットのためのプロパティを表示します。データセットが
指定されないなら、コマンドは、システムのすべてのデータセットのための
プロパティを表示します。各プロパティについて、次のカラムが表示されま
す:
name データセット名
property プロパティの名
value プロパティの値
source プロパティのソース. local, default, temporary,
inherited, received または none (-) のいずれかを指定
できます.
RECEIVED カラムを除いて、すべてのカラムがデフォルトで表示されます。表
示するカラムを -o オプションの使用によって指定することができます。こ
のコマンドは、"固有のプロパティ" と "ユーザのプロパティ" セクションで
説明されるようにプロパティのコンマで区切られたリストを取ります。
与えられたデータセットのタイプ (ファイルシステム、ボリューム、スナッ
プショットまたはブックマーク) に適用されるすべてのプロパティを表示す
るために特別の値 all を使用することができます。
-r あらゆる子供のプロパティを繰り返し表示します。
-d depth
再帰を depth に制限して、データセットのあらゆる子供を再帰的に
表示します。depth (深さ) 1 は、データセットとその直接の子供だ
けを表示します。
-H スクリプトによってより簡単に解析された形式で出力を表示しま
す。すべてのヘッダは、省略され、フィールドは、任意の空白の量
の代わりに単一のタブによって明白に分離されます。
-p 解析可能な (正確な) 値で数値を表示します。
-o all | field[,field]...
表示するカラムのコンマで区切られたリスト。サポートされる値
は、name,property,value,received,source です。デフォルト値
は、name,property,value,source です。キーワード all は、すべ
てのカラムを指定します。
-t type[,type]...
表示するタイプ (type) のコンマで区切られたリスト、ここで type
は、filesystem, snapshot, volume または all のうちの 1 つで
す。例えば、-t snapshot を指定すると、スナップショット (snap
shot) のみ表示します。
-s source[,source]...
表示するソースのコンマで区切られたリスト。このリストのそれら
以外のソースから来るそれらのプロパティは、無視されます。各
ソースは、次の 1 つでなければなりません:
local,default,inherited,temporary,received,none。デフォルト値
は、すべてのソースです。
zfs inherit [-rS] property filesystem|volume|snapshot...
祖先に設定されたプロパティががないなら、またはそれが存在するなら、前
の受信された値に戻された -S オプションで、デフォルトで復元され、それ
を先祖から継承されることを引き起こして、指定されたプロパティがをクリ
アします。デフォルト値のリストとプロパティを継承することができる詳細
については、"プロパティ" セクションを参照してください。
-r すべての子供のために与えられたプロパティを繰り返し継承しま
す。
-S それが存在するなら、前の受信された値へのプロパティに戻りま
す。そうでなければ、あたかも -S オプションが指定されないかの
ように動作します。
zfs remap filesystem|volume
以前に取り除いて vdev でブロックをもはや参照しなくて、結局、以前に取
り除かれた vdev のための間接的なマッピングオブジェクトのサイズを結局
縮ませることができるように、与えられたファイルシステムまたはボリュー
ムの間接的なブロックをリマップします。すべてのブロックをリマップする
ことは、可能ではないかもしれなくて、スナップショットからの参照がまだ
存在し、リマップができないことに注意してください。
zfs upgrade [-v]
最新のバージョンでないファイルシステムのリストを表示します。
-v 現在のソフトウェアによってサポートされた ZFS ファイルシステム
のバージョンを表示します。現在の ZFS ファイルシステムのバー
ジョンとすべての前のサポートされたバージョンが、各バージョン
で提供される機能の説明とともに表示されます。
zfs upgrade [-r] [-V version] -a | filesystem
ファイルシステムをディスク上の新しいバージョンにアップグレードしま
す。これがいったん行われると、ファイルシステムは、ソフトウェアの古い
バージョンを実行するシステムで、もはやアクセス可能ではありません。ソ
フトウェアの古いバージョンを実行するシステムで、これらのファイルシス
テムの新しいスナップショットから生成された "zfs send" ストリームを、
アクセスすることはできません。
一般的に、ファイルシステムのバージョンは、プールのバージョンと独立し
ています。zpool upgrade コマンドの情報については、zpool(8) を参照して
ください。
ある場合には、ファイルシステムのバージョンとプールのバージョンは、相
互に関連があり、ファイルシステムバージョンをアップグレードする前に、
プールのバージョンをアップグレードしなければなりません。
-r 指定されたファイルシステムとすべての子孫のファイルシステムを
アップグレードします。
-V version
指定された version にアップグレードします。-V フラグが指定さ
れないなら、このコマンドは、最新のバージョンにアップグレード
します。バージョン番号を増加するためだけに、このオプションを
使用できます、そしてこのソフトウェアによってサポートされた最
新のバージョンまでです。
-a すべてのインポートされたプールですべてのファイルシステムを
アップグレードします。
filesystem
指定されたファイルシステムをアップグレードします。
zfs userspace [-Hinp] [-o field[,field]...] [-s field]... [-S field]...
[-t type[,type]...] filesystem|snapshot
指定されたファイルシステムまたはスナップショットの各ユーザによって消
費された空間とクォータを表示します。これは、userused@user と
userquota@user プロパティに対応しています。
-n ユーザ/グループ名の代わりに数値 ID を印刷 (表示) します。
-H ヘッダを印刷 (表示) しないで、タブで区切られた出力を使用しま
す。
-p 正確な (解析可能な) 数値出力を使用します。
-o field[,field]...
次のセットから指定されたフィールドだけを表示します:
type,name,used,quota。デフォルトは、すべてのフィールドを表示
することです。
-s field
このフィールドによって出力をソートします。-s と -S フラグは、
最初に 1 つのフィールド、次に、別のもので、ソートするために複
数の回、指定できます。デフォルトは、-s type -s name です。
-S field
逆順で、このフィールドをソートします。-s を参照してください。
-t type[,type]...
次のセットから指定されたタイプだけを印刷します:
all,posixuser,smbuser,posixgroup,smbgroup。
デフォルトは、-t posixuser,smbuser です。
グループタイプを含むようにデフォルトを変更することができま
す。
-i SID を POSIX ID に変換します。現在、このフラグは、FreeBSD で
効果がありません。
zfs groupspace [-Hinp] [-o field[,field]...] [-s field]... [-S field]...
[-t type[,type]...] filesystem|snapshot
指定されたファイルシステムまたはスナップショットの各グループによって
消費された空間とクォータを表示します。このサブコマンドは、表示するデ
フォルトのタイプが -t posixgroup,smbgroup であることを除いて、"zfs
userspace" と同様です。
zfs mount
現在マウントされているすべての ZFS ファイルシステムを表示します。
-f
zfs mount [-vO] [-o property[,property]...] -a | filesystem
ZFS ファイルシステムをマウントします。
-v マウントの進歩状況を報告します。
-O オーバレイマウントを実行します。オーバレイマウントは、FreeBSD
でサポートされていません。
-o property[,property]...
マウントの存続期間のために一時的に使用するマウントオプション
のオプションのコンマで区切られたリスト。詳細については、"一時
的なマウントポイントのプロパティ" を参照してください。
-a すべての利用可能な ZFS ファイルシステムをマウントします。この
コマンドは、/etc/rc.d/zfs によって FreeBSD システムのスタート
アップで実行されます。詳細については、rc.conf(5) の変数
zfs_enable を参照してください。
filesystem
指定されたファイルシステムをマウントします。
zfs unmount|umount [-f] -a | filesystem|mountpoint
現在マウントされている ZFS ファイルシステムをアンマウントします。
-f たとえ、それが現在使用中であっても、ファイルシステムを強制的
にアンマウントします。
-a すべての利用可能な ZFS ファイルシステムをアンマウントします。
filesystem | mountpoint
指定されたファイルシステムをアンマウントします。また、システ
ムの ZFS ファイルシステムのマウントポイントへのパスをコマンド
に与えることができます。
zfs share -a | filesystem
sharenfs プロパティが設定されている ZFS ファイルシステムを共有しま
す。
-a sharenfs プロパティが設定されている、すべての ZFS ファイルシ
ステムを共有します。このコマンドは、/etc/rc.d/zfs によって
FreeBSD システムのスタートアップで実行されます。詳細について
は、rc.conf(5) の変数 zfs_enable を参照してください。
filesystem
sharenfs プロパティにしたがって指定されたファイルシステムを共
有します。ファイルシステムは、sharenfs プロパティが設定される
とき、共有されます。
zfs unshare -a | filesystem|mountpoint
sharenfs プロパティが設定されている ZFS ファイルシステムの共有を解除
します。
-a sharenfs プロパティが設定されている ZFS ファイルシステムの共
有を解除します。このコマンドは、/etc/rc.d/zfs によって
FreeBSD システムのシャットダウンで実行されます。詳細について
は、rc.conf(5) の変数 zfs_enable を参照してください。
filesystem | mountpoint
指定されたファイルシステムの共有を解除します。また、システム
で共有される ZFS ファイルシステムへのパスをコマンドに与えるこ
とができます。
zfs bookmark snapshot bookmark
与えられたスナップショットのブックマークを作成します。ブックマーク
は、スナップショットが作成されたとき、その時点をマークし、"zfs send"
コマンドのための増分ソースとして使用することができます。
この機能は、使用されるためには有効にされなければなりません。ZFS 機能
フラグと bookmark 機能に関する詳細については、zpool-features(7) を参
照してください。
zfs send [-DLPRcenpv] [-i snapshot | -I snapshot] snapshot
標準出力に書き込まれる、(-i または -I の部分ではない) 最後の snapshot
引数のストリーム表現を作成します。ファイル、または、異なったシステム
(例えば、ssh(1) を使用して) へ出力をリダイレクト (向け直し) すること
ができます。デフォルトで、完全なストリームが生成されます。
-i snapshot
最初の snapshot (増分ソース) から 2 番目の snapshot (増分ター
ゲット) まで増分ストリームを生成します。スナップショット名 (@
文字と続き) の最後の構成要素として増分ソースを指定することが
でき、増分ターゲットとして同じファイルシステムであると仮定さ
れます。
宛先がクローンであるなら、ソースは、完全に指定されなければな
らない (例えば、@origin ではなく pool/fs@origin)、元のスナッ
プショットであるかもしれません。
-I snapshot
最初の snapshot から 2 番目の snapshot まで、すべての中間のス
ナップショットを送信するストリームパッケージを生成します。例
えば、-I @a fs@d は、-i @a fs@b; -i @b fs@c; -i @c fs@d と同
様です。増加するのソースは、-i オプションと同様に指定されま
す。
-R, --replicate
指定されたファイルシステムを複製する複製ストリームパッケージ
と指定されたたスナップショットまで、すべての子孫のファイルシ
ステムを生成します。受信するとき、すべてのプロパティ、スナッ
プショット、子孫のファイルシステム、とクローンは、保持されま
す。
-i または -I フラグが、-R フラグと同時に使用されるなら、増加
する複製ストリームが生成されます。プロパティの現在の値、現在
のスナップショットとファイルシステム名は、ストリームが受信さ
れたとき、設定されます。このストリームが受信されるとき、-F フ
ラグが指定されているなら、送信側に存在しないスナップショット
とファイルシステムは、破壊されます。
-D, --dedup
複製されない (deduplicated) ストリームを生成します。送信スト
リームで複数回送信されているブロックは、一度だけ送信されま
す。また、受信システムは、複製されない (deduplicated) スト
リームを受信するために、この機能もサポートしなければなりませ
ん。このフラグをデータセットの dedup プロパティにかかわらず使
用することができますが、ファイルシステムが dedup 可能なチェッ
クサム (例えば、sha256) を使用するなら、実行は、より良くなり
ます。
-L, --large-block
128KB より大きなブロックを含んでいるストリームを生成します。
large_blocks プール機能が無効にされているなら、またはこのファ
イルシステムの recordsize プロパティが 128KB を越えて設定され
ていないなら、このフラグには、効果がありません。受信している
システムは、同様に有効にされている large_blocks プール機能が
なければなりません。ZFS 機能のフラグと large_blocks 機能に関
する詳細については、zpool-features(7) を参照してください。
-e, --embed
embedded_data プール機能によってディスクに、よりコンパクトに
格納されるブロックのために WRITE_EMBEDDED レコードを使用する
ことによって、よりコンパクトなストリームを生成します。このフ
ラグは、embedded_data 機能が無効にされるなら、効果はありませ
ん。受信システムは、embedded_data 機能を有効にしなければなり
ません。lz4_compress 機能が送信システムでアクティブであるな
ら、受信システムは、同様に、その機能を有効にしなければなりま
せん。ZFS 機能のフラグと embedded_data 機能の詳細については、
zpool-features(7) を参照してください。
-c, --compressed
ディスクでとメモリで圧縮されるブロックのための圧縮された
WRITE レコードを使用することによってよりコンパクトなストリー
ムを生成します (詳細については、圧縮プロパティを参照)。
lz4_compress 機能が送信システムでアクティブであるなら、受信シ
ステムは、同様に有効にされたその機能がなければなりません。
large_blocks 機能が、送信システムで有効にされるが、-L オプ
ションが -c とともに供給されないなら、データは、送信の前に圧
縮復元されるので、小さいブロックサイズに分割することができま
す。
-p, --props
ストリームのデータセットのプロパティを含めます。このフラグ
は、-R が指定されるとき、暗黙に設定されます。また、受信システ
ムは、この機能をサポートしなければなりません。
-n, --dryrun
予行演習 ("no-op") の送信を行います。何も実際の送信データは、
生成されません。これは、何のデータが送信されるかを決定するた
めに -v または -P のフラグとともに役に立ちます。この場合に、
(ストリームが、標準出力に書き込まれて、冗長な出力が、標準エ
ラーに行くところで、non-dry-run (ドライランでない) と対照に)
冗長な出力は、標準出力に書き込まれます
-P, --parsable
生成されたストリームパッケージに関するマシン解析可能な冗長な
情報を印刷します。
-v, --verbose
生成されたストリームパッケージに関する冗長な情報を印刷 (表示)
します。
ストリームの形式は、コミットされています。ZFS の将来のバージョンでス
トリームを受信することができます。
zfs send [-Lce] [-i snapshot|bookmark] filesystem|volume|snapshot
ファイルシステムであるかもしれないし、ブックマークから増分であるかも
しれない、送信ストリームを生成します。宛先がファイルシステムまたはボ
リュームであるなら、プールは、読み出し専用でなければならないか、また
はファイルシステムは、マウントされてはなりません。ファイルシステムま
たはボリュームから生成されたストリームが受信されたとき、デフォルトの
スナップショット名は、(--head--) となります。
-i snapshot|bookmark
増分送信ストリームを生成します。増分ソースは、宛先のヒストリ
で初期のスナップショットでなければなりません。それは、一般的
に宛先のファイルシステムの初期のスナップショットとなり、その
場合に、名前 (# または @ 文字と続き) の最後の構成要素として指
定することができます。
増分ターゲットがクローンであるなら、増分ソースは、基点のス
ナップショット、または基点のファイルシステムの初期のスナップ
ショット、または基点の基点などを指定できます。
-L, --large-block
128KB より大きなブロックを含んでいるストリームを生成します。
large_blocks プール機能が無効にされているなら、またはこのファ
イルシステムの recordsize プロパティが 128KB を越えて設定され
ていないなら、このフラグには、効果がありません。受信している
システムは、同様に有効にされている large_blocks プール機能が
なければなりません。ZFS 機能のフラグと large_blocks 機能に関
する詳細については、zpool-features(7) を参照してください。
-c, --compressed
ディスクでとメモリで圧縮されるブロックのための圧縮された
WRITE レコードを使用することによってよりコンパクトなストリー
ムを生成します (詳細については、圧縮プロパティを参照)。
lz4_compress 機能が送信システムでアクティブであるなら、受信シ
ステムは、同様に有効にされたその機能がなければなりません。
large_blocks 機能が、送信システムで有効にされるが、-L オプ
ションが -c とともに供給されないなら、データは、送信の前に圧
縮復元されるので、小さいブロックサイズに分割することができま
す。
-e, --embed
embedded_data プール機能によってディスクに、よりコンパクトに
格納されるブロックのために WRITE_EMBEDDED レコードを使用する
ことによって、よりコンパクトなストリームを生成します。このフ
ラグは、embedded_data 機能が無効にされるなら、効果はありませ
ん。受信システムは、embedded_data 機能を有効にしなければなり
ません。lz4_compress 機能が送信システムでアクティブであるな
ら、受信システムは、同様に、その機能を有効にしなければなりま
せん。ZFS 機能のフラグと embedded_data 機能の詳細については、
zpool-features(7) を参照してください。
zfs send [-Penv] -t receive_resume_token
割り込まれた受信を再開する送信ストリームを作成します。
receive_resume_token は、受信されていた、ファイルシステムまたはボ
リュームの、このプロパティの値です。より詳しい情報については、zfs
receive -s のための文書を参照してください。
zfs receive|recv [-vnsFu] [-o origin=snapshot] filesystem|volume|snapshot
zfs receive|recv [-vnsFu] [-d | -e] [-o origin=snapshot] filesystem
内容が標準入力で提供されるストリームで指定されるスナップショットを作
成します。完全なストリームが受信されるなら、新しいファイルシステム
が、同様に作成されます。ストリームは、デフォルトで、完全なストリーム
を作成する、"zfs send" サブコマンドを使用して作成されます。"zfs
receive" に対して、"zfs recv" を別名として使用することができます。
増加するストリームが受信されるなら、宛先のファイルシステムは、既に存
在しなければなりません、そして、最新のスナップショットは、増加するス
トリームのソースにマッチしなければなりません。zvol に関して、宛先のデ
バイスリンクは、receive 操作の間に zvol にアクセスすることができない
ことを意味して、破壊されて、再作成されます、
"zfs send -R" コマンドを使用することによって生成されるスナップショッ
トの複製パッケージが受信されるとき、送信位置に存在しないあらゆるス
ナップショットは、"zfs destroy -d" コマンドを使用することによって破壊
されます。
このサブコマンドが引数タイプと -d または -e オプションに依存して作成
する、スナップショット (と完全なストリームが受信されるなら、ファイル
システム) の名前。
引数がスナップショット名であるなら、指定された snapshot が作成されま
す。引数がファイルシステムまたはボリューム名であるなら、送信されたス
ナップショットと同じ名前があるスナップショットは、指定された
filesystem または volume 内に作成されます。-d または -e オプションが
指定されるなら、スナップショット名は、送信されたスナップショットの名
前を指定された filesystem に追加することによって決定されます。-d オプ
ションが指定されるなら、送信されたスナップショットのパスのプール名の
ほかすべては、追加され (例えば、b/c@1 は、送信されたスナップショット
a/b/c@1 から追加しました) -e オプションが指定されるなら、送信されたス
ナップショットのパスの後部だけが追加されます (例えば、c@1 は、送信さ
れたスナップショット a/b/c@1 から追加しました)。-d の場合には、送信さ
れたスナップショットのパスを複製するために必要なあらゆるファイルシス
テムは、指定されたファイルシステム内に作成されます。
-d 上記のパラグラフ (文章) で説明されるような新しいスナップ
ショットの名前を決定するために (プール名なしで) 最初の要素な
しの完全に送信されたスナップショットのパスを使用します。
-e 上記のパラグラフ (文章) で説明されるような新しいスナップ
ショットの名前を決定するために送信されたスナップショットのパ
スの最後の要素だけを使用します。
-u 受信されたストリームに関連しているファイルシステムは、マウン
トされません。
-v 受信された操作を実行するために要求されるストリームと時間に関
する冗長な情報を印刷 (表示) します。
-n 実際にストリームを受信しません。受信操作に使用される名前を確
認するために -v オプションとともに、これを役に立てることがで
きます。
-o origin=snapshot
与えられたスナップショットのクローンとしてストリームが受信さ
れるように強制します。ストリームが完全な送信ストリームである
なら、これは、指定されたスナップショットのクローンとしてスト
リームによって記述されるファイルシステムを作成します。どのス
ナップショットが指定されたかは、スナップショットが存在する限
り、受信の成功または失敗に影響しません。ストリームが増加され
る送信ストリームであるなら、すべての通常の検証は、実行されま
す。
-F 受信操作を実行する前に最近のスナップショットにファイルシステ
ムを強制的にロールバックします。増加する複製ストリームを受信
するなら (例えば、"zfs send -R {-i | -I}" によって生成された
もの)、送信側に存在しないスナップショットとファイルシステムを
破壊します。
-s 受信が割り込まれるなら、それを削除するのではなく、部分的に受
信された状態を保存します。割り込みは、ストリームの終了を早め
るあためです、(例えば、ネットワーク失敗、またはリモートシステ
ムの失敗のために、ストリームがネットワーク接続を越えて読み込
まれているなら)、ストリームのチェックサムエラー、zfs 受信プロ
セスの終了、またはシステムのクリーンでないシャットダウン。
受信は、zfs send -t token によって生成されたストリームで再開
することができます、ここで、token は、受信される、ファイルシ
ステムまたはボリュームの receive_resume_token プロパティの値
です。
このフラグを使用するために、記憶域プールは、有効にされた
extensible_dataset 機能がなければなりません。ZFS の機能のフラ
グに関する詳細については、zpool-features(5) を参照してくださ
い。
zfs receive|recv -A filesystem|volume
その保存された部分的に受信された状態を削除して、割り込まれた zfs
receive -s をアボートします。
zfs allow filesystem|volume
指定されたファイルシステムまたはボリュームに委任されているパーミッ
ションを表示します。詳しい情報については、"zfs allow" の他の形式を参
照してください。
zfs allow [-ldug] user|group[,user|group]...
perm|@setname[,perm|@setname]... filesystem|volume
zfs allow [-ld] -e|everyone perm|@setname[,perm|@setname]...
filesystem|volume
非特権ユーザへファイルシステムのための ZFS の管理パーミッションを委任
します。
[-ug] user|group[, user|group]...
だれのパーミッションが委任されるかを指定します。コンマで区切
られたリストとして複数の実体を指定できます。-ug オプションの
いずれも指定されないなら、引数は、キーワード everyone、次に
ユーザ名として、そして最後にグループ名として優先的に解釈され
ます。"everyone" と名前が付けられたユーザまたはグループを指定
するには、-u または -g オプションを使用します。ユーザと同じ名
前でグループを指定するには、-g オプションを使用します。
[-e|everyone]
パーミッションが "everyone" に委任されるよう指定します。
perm|@setname[,perm|@setname]...
委任されるパーミッション。複数のパーミッションは、コンマで区
切られたリストとして指定されます。パーミッション名は、ZFS サ
ブコマンドとプロパティ名と同じです。下記のプロパティリストを
参照してください。アットマーク (@) で始まる、プロパティのセッ
ト名が、指定されます。詳細については、下記の -s 形式を参照し
てください。
[-ld] filesystem|volume
パーミッションがどこへ委任されるかを指定します。-ld オプショ
ンのいずれか、または両方が、指定されないなら、ファイルシステ
ムまたはボリュームとそのすべての子孫にパーミッションは、許可
されます。-l オプションのみが使用されているなら、指定された
ファイルシステムのためだけに "locally (局所的に)" 許可されま
す。-d オプションのみが使用されているなら、子孫のファイルシス
テムのためだけに許可されます。
一般的に、パーミッションは、ZFS サブコマンドを使用するか、または ZFS
プロパティを変更する能力です。次のパーミッションが、利用可能です:
名前 タイプ 注釈
allow subcommand また、許可されているパーミッショ
ンがなければなければなりません
clone subcommand また、元のファイルシステムに
'create' 能力と 'mount' 能力がな
ければなければなりません
create subcommand また、'mount' 能力がなければなけ
ればなりません
destroy subcommand また、'mount' 能力がなければなけ
ればなりません
diff subcommand 与えられたオブジェクト番号をデー
タセット内でのパスの検索と 'zfs
diff' に必要なスナップショットを
作成する能力を許可します
hold subcommand スナップショットにユーザの hold
を加えることを可能にします
mount subcommand ZFS データセットのマウント/アンマ
ウントを可能にします
promote subcommand また、元のファイルシステムに
'mount' 能力と 'promote' 能力がな
ければなければなりません
receive subcommand また、'mount' 能力と 'create' 能
力がなければなければなりません
release subcommand スナップショットを破壊するかもし
れないユーザの hold を解放するこ
とを可能にします
rename subcommand また、新しい親に 'mount' 能力と
'create' 能力がなければなければな
りません
rollback subcommand また、'mount' 能力がなければなけ
ればなりません
send subcommand
share subcommand NFS プロトコル上でファイルシステ
ムを共有することを可能にします
snapshot subcommand また、'mount' 能力がなければなけ
ればなりません
groupquota other あらゆる groupquota@... プロパ
ティをアクセスを可能にします
groupused other あらゆる groupused@... プロパティ
の読み込みを可能にします
userprop other あらゆるユーザプロパティの変更を
可能にします
userquota other あらゆる userquota@... プロパティ
のアクセスを可能にします
userused other あらゆる userused@... プロパティ
の読み込みを可能にします
aclinherit property
aclmode property
atime property
canmount property
casesensitivity property
checksum property
compression property
copies property
dedup property
devices property
exec property
filesystem_limit property
logbias property
jailed property
mlslabel property
mountpoint property
nbmand property
normalization property
primarycache property
quota property
readonly property
recordsize property
refquota property
refreservation property
reservation property
secondarycache property
setuid property
sharenfs property
sharesmb property
snapdir property
snapshot_limit property
sync property
utf8only property
version property
volblocksize property
volsize property
vscan property
xattr property
zfs allow -c perm|@setname[,perm|@setname]... filesystem|volume
"作成時刻" パーミッションを設定します。これらのパーミッションは、あら
ゆる新たに作成された子孫のファイルシステムのクリエイタに (局所的に)
付与されます。
zfs allow -s @setname perm|@setname[,perm|@setname]... filesystem|volume
パーミッションセットにパーミッションを定義するか、または追加します。
指定されたファイルシステムとその子孫のために他の "zfs allow" コマンド
によってセットを使用することができます。セットは、動的に評価されるの
で、セットへの変更は、直ちに反映されます。パーミッションセットは、ZFS
ファイルシステムとして同じ名前付け制約に従いますが、名前は、"アット
マーク" (@) で始まらなければならなくて、64 文字未満でなければなりませ
ん。
zfs unallow [-rldug] user|group[,user|group]...
[perm|@setname[,perm|@setname]...] filesystem|volume
zfs unallow [-rld] -e|everyone [perm|@setname[,perm|@setname]...]
filesystem|volume
zfs unallow [-r] -c [perm|@setname[,perm|@setname]...] filesystem|volume
"zfs allow" コマンドで付与されたパーミッションを取り除きます。パー
ミッションは、明白に拒否されないので、付与された他のパーミッション
は、まだ有効です。例えば、パーミッションが先祖によって付与される場
合。パーミッションが指定されないなら、指定された user, group または
everyone のためのすべてのパーミッションは、削除されます。everyone を
指定すると (または、-e オプションを使用すると)、すべてのユーザとグ
ループのためのすべてのパーミッションではなく、すべての人 (everyone)
に付与されたパーミッションのみを削除します。-ldugec オプションの説明
については、"zfs allow" コマンドを参照してください。
-r このファイルシステムとすべての子孫からパーミッションを繰り返
し削除します。
zfs unallow [-r] -s @setname [perm|@setname[,perm|@setname]...]
filesystem|volume
パーミッションセットからパーミッションを削除します。パーミッションが
指定されないなら、すべてのパーミッションは、削除され、その結果、セッ
トを完全に削除します。
zfs hold [-r] tag snapshot...
tag 引数で指定された単一の参照を指定されたスナップショットまたは複数
のスナップショットに追加します。各スナップショットには、それ自体のタ
グ名前空間があり、タグは、その空間内でユニークでなければなりません。
hold がスナップショットに存在しているなら、"zfs destroy" コマンドを使
用することによって、そのスナップショットを破壊する試みは、EBUSY を返
します。
-r 与えられたタグがある hold がすべての子孫のファイルシステムの
スナップショットに再帰的に適用されることを指定します。
zfs holds [-Hp] [-r|-d depth] filesystem|volume|snapshot...
与えられたデータセットまたはスナップショットのためのすべての存在する
ユーザ参照をリストします。
-H スクリプト (scripting) のために使用されます。ヘッダを印刷 (表
示) せず、任意の空白類の代わりに単一のタブによってフィールド
を区切ります。
-p 解析可能 (正確) な値の数を表示します。
-r もしあるなら、指定されたスナップショットで holds をリストする
ことに加えて、指定されたデータセットまたはスナップショットの
子孫のスナップショットで設定される holds をリストします。
-d depth
depth への再帰を制限して、指定されたスナップショット、または
指定されたデータセットまたはスナップショットの子孫のあらゆる
holds を再帰的に表示します。
zfs release [-r] tag snapshot...
指定されたスナップショットまたは複数のスナップショットから tag 引数で
指定された単一の参照を削除します。タグは、各スナップショットのために
既に存在していなければなりません。
-r すべての子孫のファイルシステムのスナップショットで、与えられ
たタグで hold を再帰的に解放します。
zfs diff [-FHt] snapshot [snapshot|filesystem]
与えられたファイルシステムのスナップショットと、しばらく経ってからの
そのファイルシステムの別のスナップショットまたはファイルシステムの現
在の内容の間の差分を表示します。最初のカラムは、変更のタイプを示す文
字で、他のカラムは、パス名、(改名の場合の) 新しいパス名、リンクカウン
トの変更とオプションのファイルタイプおよび/または変更時間を示します。
変更のタイプは、次の通りです:
- パスが削除されました
+ パスが追加されました
M パスが修正されました
R パスの名前が変更されました
-F ls(1) の -F オプションに似ている方法で、ファイルのタイプの識
別を表示します。
B ブロックデバイス
C キャラクタデバイス
F 通常ファイル
/ ディレクトリ
@ シンボリックリンク
= ソケット
> ドア (door) (FreeBSD でサポートなし)
| 名前付きパイプ (FreeBSD でサポートなし)
P イベントポート (FreeBSD でサポートなし)
-H ヘッダ行と矢印なしで、より多くの解析可能なタブで区切られた出
力を与えます。
-t 出力の最初のカラムとしてパスの inode 変更時間を表示します。
zfs program [-n] [-t timeout] [-m memory_limit] pool script [arg1 ...]
pool の ZFS チャネルプログラムとして script を実行します。ZFS チャネ
ルプログラムのインタフェースによって、ZFS 管理の操作は、Lua スクリプ
トを通してプログラムに基づいて実行することができます。全体のスクリプ
トは、同時に効果を生じている他の管理の操作なしで、不可分に実行されま
す。ZFS 呼び出しのライブラリは、チャネルプログラムのスクリプトに利用
可能にします。チャネルプログラムは、root の特権でのみ実行することがで
きます。
ZFS チャネルプログラムのインタフェースの完全な文書については、zfs-
program(8) のためのマニュアルページを参照してください。
-n より速く実行する、読み込み専用のチャネルプログラムを実行しま
す。プログラムは、zfs.sync サブモジュールから関数を呼び出すこ
とによってオンディスク (on-disk) の状態を変更することはできま
せん。プロパティと変更が成功するかどうかの決定のような情報を
集めるためにプログラムを使用することができます
(zfs.check.*)。このフラグなしで、すべての保留中の変更は、チャ
ネルプログラムが完了することができる前に、ディスクに同期しな
ければなりません。
-t timeout
ミリ秒単位の実行時間の制限。チャネルプログラムが提供されたタ
イムアウトより長い間実行するなら、それは、停止され、エラー
が、返されます。デフォルトのタイムアウトは、1000 ms で、最大
10000 ms に設定することができます。
-m memory-limit
バイト単位のメモリの制限。チャネルプログラムが、与えられた制
限より多いメモリを割り付けることを試みるなら、それは、停止さ
れ、エラーが返されます。デフォルトのメモリ制限は、10 MB で、
最大 100 MB に設定することができます。
すべての残りの引数の文字列は、引数としてチャネルプログラムに
直接渡されます。詳細については、zfs-program(8) を参照してくだ
さい。
zfs jail jailid filesystem
JID jailid によって識別される jail に指定された filesystem をアタッチ
します。今後は、jailed プロパティが設定されていたなら、このファイルシ
ステムツリーを jail 内から、管理することができます。この機能を使用す
るために、jail は、allow.mount と allow.mount.zfs パラメータが 1 に設
定され、enforce_statfs パラメータは、2 より低い値に設定される必要があ
ります。
jail の管理と上記のパラメータの設定の詳細については、jail(8) を参照し
てください。
zfs unjail jailid filesystem
JID jailid によって識別される jail から指定された filesystem をデタッ
チします。
終了ステータス
次の終了値が返されます:
0 成功して終了。
1 エラーが発生しました。
2 無効のコマンド行のオプションが指定されました。
使用例
使用例 1 ZFS ファイルシステム階層構造を作成する
次のコマンドは、pool/home と名前がつけられたファイルシステムと
pool/home/bob と名前がつけられたファイルシステムを作成します。マウント
ポイント /home は、親のファイルシステムのために設定され、子供のファイル
システムによって自動的に継承されます。
# zfs create pool/home
# zfs set mountpoint=/home pool/home
# zfs create pool/home/bob
使用例 2 ZFS スナップショットを作成する
次のコマンドは、yesterday と名前がつけられたスナップショットを作成しま
す。このスナップショットは、pool/home/bob ファイルシステムのルートで
.zfs/snapshot ディレクトリで要求に応じてマウントされます。
# zfs snapshot pool/home/bob@yesterday
使用例 3 複数のスナップショットを作成して破壊する
次のコマンドは、pool/home とその子孫のすべてのファイルシステムの
yesterday と名前が付けられたスナップショットを作成します。各スナップ
ショットは、そのファイルシステムのルートで .zfs/snapshot ディレクトリで
要求に応じてマウントされます。2 番目のコマンドは、新たに作成されたス
ナップショットを破壊します。
# zfs snapshot -r pool/home@yesterday
# zfs destroy -r pool/home@yesterday
使用例 4 ファイルシステムの圧縮を無効にして有効にする
次のコマンドは、pool/home 下のすべてのファイルシステムのために
compression プロパティを無効にします。次のコマンドは、pool/home/anne の
ために明白に compression を有効にします。
# zfs set compression=off pool/home
# zfs set compression=on pool/home/anne
使用例 5 ZFS データセットをリストする
次のコマンドは、システムのすべてのアクティブなファイルシステムとボ
リュームをリストします。スナップショットは、listsnaps プロパティが on
であるなら、表示されます。デフォルトは、off です。プールプロパティの詳
しい情報については、zpool(8) を参照してください。
# zfs list
NAME USED AVAIL REFER MOUNTPOINT
pool 450K 457G 18K /pool
pool/home 315K 457G 21K /home
pool/home/anne 18K 457G 18K /home/anne
pool/home/bob 276K 457G 276K /home/bob
使用例 6 ZFS ファイルシステムでクォータ (quota) を設定する
次のコマンドは、pool/home/bob のために 50 ギガバイトのクォータをを設定
します。
# zfs set quota=50G pool/home/bob
使用例 7 ZFS のプロパティをリストする
次のコマンドは、pool/home/bob のためのすべてのプロパティをリストしま
す。
# zfs get all pool/home/bob
NAME PROPERTY VALUE SOURCE
pool/home/bob type filesystem -
pool/home/bob creation Tue Jul 21 15:53 2009 -
pool/home/bob used 21K -
pool/home/bob available 20.0G -
pool/home/bob referenced 21K -
pool/home/bob compressratio 1.00x -
pool/home/bob mounted yes -
pool/home/bob quota 20G local
pool/home/bob reservation none default
pool/home/bob recordsize 128K default
pool/home/bob mountpoint /home/bob default
pool/home/bob sharenfs off default
pool/home/bob checksum on default
pool/home/bob compression on local
pool/home/bob atime on default
pool/home/bob devices on default
pool/home/bob exec on default
pool/home/bob filesystem_limit none default
pool/home/bob setuid on default
pool/home/bob readonly off default
pool/home/bob jailed off default
pool/home/bob snapdir hidden default
pool/home/bob snapshot_limit none default
pool/home/bob aclmode discard default
pool/home/bob aclinherit restricted default
pool/home/bob canmount on default
pool/home/bob xattr on default
pool/home/bob copies 1 default
pool/home/bob version 5 -
pool/home/bob utf8only off -
pool/home/bob normalization none -
pool/home/bob casesensitivity sensitive -
pool/home/bob vscan off default
pool/home/bob nbmand off default
pool/home/bob sharesmb off default
pool/home/bob refquota none default
pool/home/bob refreservation none default
pool/home/bob primarycache all default
pool/home/bob secondarycache all default
pool/home/bob usedbysnapshots 0 -
pool/home/bob usedbydataset 21K -
pool/home/bob usedbychildren 0 -
pool/home/bob usedbyrefreservation 0 -
pool/home/bob logbias latency default
pool/home/bob dedup off default
pool/home/bob mlslabel -
pool/home/bob sync standard default
pool/home/bob refcompressratio 1.00x -
次のコマンドは、単一のプロパティ値を取得します。
# zfs get -H -o value compression pool/home/bob
on
次のコマンドは、pool/home/bob のためにローカル設定されたすべてのプロパ
ティをリストします。
# zfs get -s local -o name,property,value all pool/home/bob
NAME PROPERTY VALUE
pool/home/bob quota 20G
pool/home/bob compression on
使用例 8 ZFS ファイルシステムをロールバックする
次のコマンドは、すべての中間的なスナップショットを削除して、
pool/home/anne の内容を yesterday と名前が付けられたスナップショットに
戻します。
# zfs rollback -r pool/home/anne@yesterday
使用例 9 ZFS クローンを作成する
次のコマンドは、初期の内容が pool/home/bob@yesterday と同じである書き込
み可能なファイルシステムを作成します。
# zfs clone pool/home/bob@yesterday pool/clone
使用例 10 ZFS クローンを昇格する
次のコマンドは、どのようにファイルシステムへの変更をテストするかを例証
し、次に、クローン、クローン昇格と名前の変更を使用して、元のファイルシ
ステムを変更されたものに置き換えます:
# zfs create pool/project/production
データで /pool/project/production 投入して、次のコマンドを続けます:
# zfs snapshot pool/project/production@today
# zfs clone pool/project/production@today pool/project/beta
今、/pool/project/beta への変更を行い、次のコマンドを続けます:
# zfs promote pool/project/beta
# zfs rename pool/project/production pool/project/legacy
# zfs rename pool/project/beta pool/project/production
いったん古いバージョンがもう必要でないと、それを破壊できます
# zfs destroy pool/project/legacy
使用例 11 ZFS のプロパティを継承する
次のコマンドによって、pool/home/bob と pool/home/anne は、それらの親か
ら checksum プロパティを継承します。
# zfs inherit checksum pool/home/bob pool/home/anne
使用例 12 ZFS データをリモートで複製する
次のコマンドは、リモートマシンに完全なストリームを、次に、増加のスト
リームを送信し、それぞれ、poolB/received/fs@a と poolB/received/fs@b に
それらを復旧します。poolB は、ファイルシステム poolB/received を含まな
ければならなくて、最初に poolB/received/fs を含んではいけません。
# zfs send pool/fs@a | ssh host zfs receive poolB/received/fs@a
# zfs send -i a pool/fs@b | ssh host zfs receive poolB/received/fs
使用例 13 "zfs receive -d" オプションを使用する
次のコマンドは、poolA/fsA/fsB@snap の完全なストリームをリモートマシンに
送信し、poolB/received/fsA/fsB@snap にそれを受信します。スナップショッ
トの名前の fsA/fsB@snap ポーション (部分) は、送信するスナップショット
の名前から決定されます。poolB は、ファイルシステム poolB/received を含
まなければなりません。poolB/received/fsA が存在していないなら、それは空
のファイルシステムとして作成されます。
# zfs send poolA/fsA/fsB@snap | ssh host zfs receive -d poolB/received
使用例 14 ユーザプロパティを設定する
次の例は、データセットのためのユーザ定義 com.example:department プロパ
ティを設定します。
# zfs set com.example:department=12345 tank/accounting
使用例 15 ローリングスナップショットを実行する
次の例は、どのように一貫した名前付けスキームでスナップショットの歴史を
維持するかを示しています。1 週間相当のスナップショットを保持するため
に、ユーザは、次のように、最も古いスナップショットを破壊して、残ってい
るスナップショットの名前を変更して、次に、新しいスナップショットを作成
します:
# zfs destroy -r pool/users@7daysago
# zfs rename -r pool/users@6daysago @7daysago
# zfs rename -r pool/users@5daysago @6daysago
# zfs rename -r pool/users@4daysago @5daysago
# zfs rename -r pool/users@3daysago @4daysago
# zfs rename -r pool/users@2daysago @3daysago
# zfs rename -r pool/users@yesterday @2daysago
# zfs rename -r pool/users@today @yesterday
# zfs snapshot -r pool/users@today
使用例 16 ZFS ファイルシステムで "sharenfs" プロパティオプションを設定す
る
次のコマンドは、tank/home ファイルシステムで特有のネットワークのための
ルートアクセスを有効にするために、sharenfs プロパティのオプションがどの
ように設定されているかを示します。sharenfs プロパティの内容は、有効な
exports(5) オプションです。
# zfs set sharenfs="maproot=root,network 192.168.0.0/24" tank/home
同じ結果でこのコマンドを書き込むための別の方法は、次の通りです:
# set zfs sharenfs="-maproot=root -network 192.168.0.0/24" tank/home
使用例 17 ZFS データセットで ZFS 管理パーミッションを委任する
次の例は、ユーザ cindys が tank/cindys でスナップショットをを作成して、
破壊して、マウントして、取ることができるよう、どのようにパーミッション
を設定するかを示します。また、tank/cindys のパーミッションが、表示され
ます。
# zfs allow cindys create,destroy,mount,snapshot tank/cindys
# zfs allow tank/cindys
---- Permissions on tank/cindys --------------------------------------
Local+Descendent permissions:
user cindys create,destroy,mount,snapshot
使用例 18 ZFS データセットで作成時刻パーミッションを委任する
次の例は、tank/users のファイルシステムを作成するためにグループ staff
の誰かにどのように付与するかを示します。また、この構文によって、staff
メンバは、それら自体のファイルシステムを破壊できますが、他の誰かのファ
イルシステムを破壊できません。また、tank/users のパーミッションも表示さ
れます。
# zfs allow staff create,mount tank/users
# zfs allow -c destroy tank/users
# zfs allow tank/users
---- Permissions on tank/users ---------------------------------------
Permission sets:
destroy
Local+Descendent permissions:
group staff create,mount
使用例 19 ZFS データセットでパーミッション設定の定義して付与する
次の例は、tank/users ファイルシステムに設定されたパーミッションをどのよ
うに定義して、付与するかを示します。また、tank/users のパーミッションも
表示されます。
# zfs allow -s @pset create,destroy,snapshot,mount tank/users
# zfs allow staff @pset tank/users
# zfs allow tank/users
---- Permissions on tank/users ---------------------------------------
Permission sets:
@pset create,destroy,mount,snapshot
Local+Descendent permissions:
group staff @pset
使用例 20 ZFS データセットでプロパティパーミッションを委任する
次の例は、users/home ファイルシステムでクォータと予約を設定する能力を付
与するかを示します。また、users/home のパーミッションも表示されます。
# zfs allow cindys quota,reservation users/home
# zfs allow users/home
---- Permissions on users/home ---------------------------------------
Local+Descendent permissions:
user cindys quota,reservation
# su - cindys
cindys% zfs set quota=10G users/home/marks
cindys% zfs get quota users/home/marks
NAME PROPERTY VALUE SOURCE
users/home/marks quota 10G local
使用例 21 ZFS データセットで ZFS 委任パーミッションを削除する
次の例は、tank/users ファイルシステムで staff グループからスナップ
ショットのパーミッションをどのように削除するかを示しています。また、
tank/users のパーミッションも表示します。
# zfs unallow staff snapshot tank/users
# zfs allow tank/users
---- Permissions on tank/users ---------------------------------------
Permission sets:
@pset create,destroy,mount,snapshot
Local+Descendent permissions:
group staff @pset
使用例 22 スナップショットと ZFS データセットの間の差分を表示する
次の使用例は、ZFS データセットの前のスナップショットとその現在の状態の
間の変更されたものを調べる方法を表示します。-F オプションは、影響を受け
たファイルのためのタイプ情報を示すために使用されます。
# zfs diff tank/test@before tank/test
M / /tank/test/
M F /tank/test/linked (+1)
R F /tank/test/oldname -> /tank/test/newname
- F /tank/test/deleted
+ F /tank/test/created
M F /tank/test/modified
関連項目
chmod(2), fsync(2), exports(5), fstab(5), rc.conf(5), jail(8), mount(8),
umount(8), zpool(8)
作者
このマニュアルページは、FreeBSD のために修正されカスタマイズされ、Common
Development and Distribution License (CDDL) (共通の開発と配布ライセンス)
の下で許諾されている OpenSolaris マニュアルページ zfs(1M) の mdoc(7) の再
実装です。
このマニュアルページの mdoc(7) の実装は、最初に Martin Matuska
<mm@FreeBSD.org> によって書かれました。
FreeBSD 11.2 December 6, 2017 FreeBSD 11.2