Consultando informações sobre o sistema de arquivos ZFS

O comando zfs list oferece um amplo mecanismo para exibição e consulta de informações sobre o conjunto de dados. Nesta seção, serão tratadas tanto as consultas básicas quantos as consultas complexas.

Listando informações básicas do ZFS

É possível listar as informações básicas do conjunto de dados usando o comando zfs list sem opções. Esse comando exibe os nomes de todos os conjuntos de dados no sistema e os valores de suas propriedades utilizadas, disponíveis, referenciadas e ponto de montagem. Para obter mais informações sobre essas propriedades, consulte Introduzindo as propriedades do ZFS.

Por exemplo:

# 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

Também é possível usar este comando para exibir conjuntos de dados específicos proporcionando o nome do banco de dados na linha de comando. Adicionalmente, use a opção -r para exibir repetidamente todos os descendentes de tal conjunto de dados. Por exemplo:

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

É possível utilizar o comando zfs list com o ponto de montagem de um sistema de arquivos. Por exemplo:

# zfs list /user/home/mark
NAME              USED  AVAIL  REFER  MOUNTPOINT
users/home/mark  1.00G  64.9G  1.00G  /users/home/mark

O exemplo a seguir ilustra como exibir informações básicas sobre tank/home/gina e todos os seus conjuntos de dados descendentes:

# 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

Para obter informações adiiconais sobre o comando zfs list , consulte zfs(1M).

Criando consultas complexas de ZFS

A saída zfs list pode ser personalizada utilizando as opções -o, -f e -H.

É possível personalizar a saída do valor da propriedade usando a opção -o e uma lista separada por vírgula das propriedades desejadas. É possível abastecer qualquer propriedade de conjunto de dados como um argumento válido. Para obter uma lista de todas as propriedades de conjunto de dados suportadas, consulte Introduzindo as propriedades do ZFS. Além das propriedades definidas, a lista da opção -o também pode conter o nome literal para indicar que a saída deve incluir o nome do conjunto de dados.

O exemplo a seguir utiliza zfs list para exibir o nome do conjunto de dados, juntamente com os valores das propriedades sharenfs e mountpoint .

# zfs list -r -o name,sharenfs,mountpoint users/home
NAME                          SHARENFS  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

A opção -t pode ser usada para especificar os tipos de conjuntos de dados a serem exibidos. Os tipos válidos estão descritos na tabela abaixo.

Tabela 5-2 Tipos de Objetos ZFS

As opções -t utilizam uma lista separada por vírgulas dos tipos de conjuntos de dados a serem exibidos. O exemplo abaixo usa simultaneamente as opções -t e -o para exibir o nome e a propriedade used em todos os sistemas de arquivos:

# 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

A opção -H pode ser usada para omitir o cabeçalho zfs list da saída gerada. Com a opção -H, todo espaço em branco é substituído pelo caractere Tab. Esta opção pode ser útil quando uma saída analisável é necessária, por exemplo, ao realizar script. O exemplo abaixo ilustra a saída gerada do uso do comando zfs list com a opção -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