Команда 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).
Вывод команды zfs list можно настроить с помощью параметров -o, -f и -H.
Параметр -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 |
Файловые системы и клоны |
volume |
Тома |
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 |