zfs list コマンドを使って、データセット情報を表示してクエリー検索を行うことができます。さらに、必要に応じてその操作を拡張することができます。この節では、基本的なクエリーと複雑なクエリーについて説明します。
zfs list コマンドをオプションなしで使用すると、基本的なデータセット情報を表示できます。このコマンドでは、システム上のすべてのデータセットの名前と、それらの used、available、 referenced、および mountpoint プロパティーの値が表示されます。これらのプロパティーの詳細については、「ZFS のプロパティーの紹介」を参照してください。
次に例を示します。
# zfs list NAME USED AVAIL REFER MOUNTPOINT pool 476K 16.5G 21K /pool pool/clone 18K 16.5G 18K /pool/clone pool/home 296K 16.5G 19K /pool/home pool/home/marks 277K 16.5G 277K /pool/home/marks pool/home/marks@snap 0 - 277K - pool/test 18K 16.5G 18K /test |
このコマンドを使用するときに、コマンド行にデータセット名を指定すれば、特定のデータセットを表示することもできます。また、-r オプションを使って、そのデータセットのすべての子孫を再帰的に表示することもできます。次に例を示します。
# zfs list -r pool/home/marks NAME USED AVAIL REFER MOUNTPOINT pool/home/marks 277K 16.5G 277K /pool/home/marks pool/home/marks@snap 0 - 277K - |
zfs list コマンドは、ファイルシステムのマウントポイントとともに使用することができます。次に例を示します。
# zfs list /pool/home/marks NAME USED AVAIL REFER MOUNTPOINT pool/home/marks 277K 16.5G 277K /pool/home/marks |
次の例は、tank/home/chua およびそのすべての子孫データセットの基本情報を表示する方法を示しています。
# zfs list -r tank/home/chua NAME USED AVAIL REFER MOUNTPOINT tank/home/chua 26.0K 4.81G 10.0K /tank/home/chua tank/home/chua/projects 16K 4.81G 9.0K /tank/home/chua/projects tank/home/chua/projects/fs1 8K 4.81G 8K /tank/home/chua/projects/fs1 tank/home/chua/projects/fs2 8K 4.81G 8K /tank/home/chua/projects/fs2 |
zfs list コマンドの追加情報については、zfs(1M) を参照してください。
-o、-t、および -H オプションを使用して、zfs list の出力をカスタマイズすることができます。
-o オプションと必要なプロパティーのコンマ区切りのリストを使用すれば、プロパティー値の出力をカスタマイズできます。任意のデータセットプロパティーを有効な引数として指定できます。サポートされているすべてのデータセットプロパティーのリストは、「ZFS のプロパティーの紹介」を参照してください。また、定義されているプロパティー以外に、-o オプションのリストにリテラル name を指定すれば、出力にデータセットの名前が表示されるはずです。
次の例では、zfs list と一緒に sharenfs と mountpoint プロパティー値を使用して、データセット名を表示しています。
# zfs list -o name,sharenfs,mountpoint NAME SHARENFS MOUNTPOINT tank off /tank tank/home on /tank/home tank/home/ahrens on /tank/home/ahrens tank/home/bonwick on /tank/home/bonwick tank/home/chua on /tank/home/chua tank/home/eschrock on legacy tank/home/moore on /tank/home/moore tank/home/tabriz ro /tank/home/tabriz |
-t オプションを使用すれば、表示するデータセットの種類を指定できます。次の表は、有効な種類について説明しています。
表 6–2 ZFS データセットの種類
種類 |
説明 |
---|---|
filesystem |
ファイルシステムとクローン |
ボリューム |
ボリューム |
snapshot |
スナップショット |
-t オプションには、表示するデータセットの種類をコンマ区切りのリストとして指定します。次の例では、-t オプションと - o オプションを同時に使用して、すべてのファイルシステムの名前と used プロパティーを表示しています。
# zfs list -t filesystem -o name,used NAME USED pool 476K pool/clone 18K pool/home 296K pool/home/marks 277K pool/test 18K |
-H オプションを使用すると、生成される出力から zfs list ヘッダーを省略できます。-H オプションを使用した場合、空白はすべてタブ文字で置き換えられます。このオプションは、スクリプトで使えるようにする場合など、解析しやすい出力を必要とするときに利用できます。次の例では、zfs list コマンドと -H オプションを使用して生成される出力を示しています。
# zfs list -H -o name pool pool/clone pool/home pool/home/marks pool/home/marks@snap pool/test |