Consulta de información del sistema de archivos ZFS

El comando zfs list ofrece un mecanismo ampliable para ver y consultar información del conjunto de datos. En esta sección se explican las consultas básicas y complejas.

Visualización de información básica de ZFS

Puede visualizar información básica del conjunto de datos mediante el comando zfs list sin opciones. Este comando muestra los nombres de todos los conjuntos de datos en el sistema y los de sus propiedades used, available, referenced y mountpoint. Para obtener más información sobre estas propiedades, consulte Introducción a las propiedades de ZFS.

Por ejemplo:

# 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

También puede utilizar este comando para visualizar conjuntos de datos específicos si proporciona el nombre del conjunto de datos en la línea de comandos. Asimismo, utilice la opción -r para mostrar repetidamente todos los descendientes del conjunto de datos. Por ejemplo:

# 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  -

Puede utilizar el comando lista zfs con el punto de montaje de un sistema de archivos. Por ejemplo:

# zfs list /pool/home/marks
NAME              USED  AVAIL  REFER  MOUNTPOINT
pool/home/marks   277K  16.5G   277K  /pool/home/marks

El ejemplo siguiente muestra cómo visualizar información básica sobre tank/home/chua y todos sus conjuntos de datos descendientes.

# 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

Para obtener más información sobre el comando zfs list, consulte zfs(1M).

Creación de consultas de ZFS complejas

La salida zfs list se puede personalizar mediante las opciones -o, -t y -H.

Puede personalizar la salida del valor de las propiedades mediante la opción -o y una lista separada por comas de las propiedades en cuestión. También puede proporcionar una propiedad del conjunto de datos como argumento válido. Para obtener una lista de todas las propiedades de conjuntos de datos compatibles, consulte Introducción a las propiedades de ZFS. Además de las propiedades que se definen, la lista de la opción -o también puede contener el name literal para indicar que la salida debe incluir el nombre del conjunto de datos.

El ejemplo siguiente utiliza zfs list para mostrar el nombre del conjunto de datos, junto con los valores de las propiedades sharenfs y 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

Puede utilizar la opción -t para especificar los tipos de conjuntos de datos que se deben mostrar. Los tipos válidos se describen en la tabla siguiente.

Las opciones -t toman una lista separada por comas de los tipos de conjuntos de datos que mostrar. El ejemplo siguiente utiliza las opciones -t y - o simultáneamente para mostrar el nombre y la propiedad used para todos los sistemas:

# zfs list -t filesystem -o name,used
NAME              USED
pool              476K
pool/clone         18K
pool/home         296K
pool/home/marks   277K
pool/test          18K

Puede utilizar la opción -H para omitir la cabecera zfs list de la salida que se ha generado. Con la opción -H, todos los espacios en blanco se sustituyen por el carácter de tabulación. Puede usar esta opción si necesita una salida analizable; por ejemplo, con las secuencias de comandos. El ejemplo siguiente muestra la salida generada a partir del uso del comando zfs list con la opción -H:

# zfs list -H -o name
pool
pool/clone
pool/home
pool/home/marks
pool/home/marks@snap
pool/test