zfs list コマンドを使って、データセット情報を表示してクエリー検索を行うことができます。さらに、必要に応じてその操作を拡張することができます。このセクションでは、基本的なクエリーと複雑なクエリーについて説明します。
zfs list コマンドをオプションなしで使用すると、基本的なデータセット情報を表示できます。このコマンドでは、システム上のすべてのデータセットの名前と、それらの used、available、 referenced、および mountpoint プロパティーの値が表示されます。これらのプロパティーの詳細については、ZFS のプロパティーの概要を参照してください。
例:
# zfs list users 2.00G 64.9G 32K /users users/home 2.00G 64.9G 35K /users/home users/home/cindy 548K 64.9G 548K /users/home/cindy users/home/mark 1.00G 64.9G 1.00G /users/home/mark users/home/neil 1.00G 64.9G 1.00G /users/home/neil
このコマンドを使用するときに、コマンド行にデータセット名を指定すれば、特定のデータセットを表示することもできます。また、–r オプションを使って、そのデータセットのすべての子孫を再帰的に表示することもできます。例:
# zfs list -t all -r users/home/mark NAME USED AVAIL REFER MOUNTPOINT users/home/mark 1.00G 64.9G 1.00G /users/home/mark users/home/mark@yesterday 0 - 1.00G - users/home/mark@today 0 - 1.00G -
zfs list コマンドは、ファイルシステムのマウントポイントとともに使用することができます。例:
# zfs list /user/home/mark NAME USED AVAIL REFER MOUNTPOINT users/home/mark 1.00G 64.9G 1.00G /users/home/mark
次の例は、tank/home/gina およびそのすべての子孫ファイルシステムに関する基本情報を表示する方法を示しています。
# zfs list -r users/home/gina NAME USED AVAIL REFER MOUNTPOINT users/home/gina 2.00G 62.9G 32K /users/home/gina users/home/gina/projects 2.00G 62.9G 33K /users/home/gina/projects users/home/gina/projects/fs1 1.00G 62.9G 1.00G /users/home/gina/projects/fs1 users/home/gina/projects/fs2 1.00G 62.9G 1.00G /users/home/gina/projects/fs2
zfs list コマンドの詳細は、zfs(1M) のマニュアルページを参照してください。
–o、–t、および –H オプションを使用して、zfs list の出力をカスタマイズすることができます。
–o オプションと必要なプロパティーのコンマ区切りのリストを使用すれば、プロパティー値の出力をカスタマイズできます。任意のデータセットプロパティーを有効な引数として指定できます。サポートされているすべてのデータセットプロパティーのリストは、ZFS のプロパティーの概要を参照してください。また、定義されているプロパティー以外に、–o オプションのリストにリテラル name を指定すれば、出力にデータセットの名前が表示されるはずです。
次の例では、zfs list と一緒に share.nfs および mountpoint プロパティー値を使用して、データセット名を表示しています。
# zfs list -r -o name,share.nfs,mountpoint users/home NAME NFS MOUNTPOINT users/home on /users/home users/home/cindy on /users/home/cindy users/home/gina on /users/home/gina users/home/gina/projects on /users/home/gina/projects users/home/gina/projects/fs1 on /users/home/gina/projects/fs1 users/home/gina/projects/fs2 on /users/home/gina/projects/fs2 users/home/mark on /users/home/mark users/home/neil on /users/home/neil
–t オプションを使用して、表示するデータセットのタイプを指定できます。次の表は、有効な種類について説明しています。
|
–t オプションには、表示されるデータセットのタイプのコンマ区切りリストを指定します。次の例は、–t および –o オプションを使用して、すべてのファイルシステムの名前と used プロパティーを表示します。
# zfs list -r -t filesystem -o name,used users/home NAME USED users/home 4.00G users/home/cindy 548K users/home/gina 2.00G users/home/gina/projects 2.00G users/home/gina/projects/fs1 1.00G users/home/gina/projects/fs2 1.00G users/home/mark 1.00G users/home/neil 1.00G
–H オプションを使用すると、生成される出力から zfs list ヘッダーを省略できます。–H オプションを使用した場合、空白はすべてタブ文字で置き換えられます。このオプションは、スクリプトで使えるようにする場合など、解析しやすい出力を必要とするときに利用できます。次の例は、zfs list コマンドに –H オプションを付けて使用した場合に生成される出力を示しています。
# zfs list -r -H -o name users/home users/home users/home/cindy users/home/gina users/home/gina/projects users/home/gina/projects/fs1 users/home/gina/projects/fs2 users/home/mark users/home/neil
不完全なデータセットは、zfs receive を実行することによって開始されたデータセット転送が中断されたときに作成されます。不完全なデータセットを表示するには、zfs list –I コマンドを使用できます。各データセットの状態は、receiving (受信中) または resumable (再開可能) のいずれかです。–I オプションの引数は、all、resumable、または receiving です。
# zfs list -I all NAME USED AVAIL REFER TYPE STATE users/home/dst 189M 910G 189M volume resumable
次のコマンドを使用して、再開可能なデータセットの名前のみ表示できます。
# # zfs list -HI resumable users/home/dst
zfs list –o コマンドで –p オプションを使用して、マシンによる解析が可能な数値出力を作成できます。例:
# zfs list -o guid users/home GUID 3.30E # zfs list -po guid users/home GUID 3807001345661527925