Envoi de requêtes sur les informations des systèmes de fichiers ZFS

La commande zfs list contient un mécanisme extensible permettant d'afficher et d'envoyer des requêtes sur les informations des systèmes de fichiers. Cette section décrit les requêtes de base ainsi que les requêtes plus complexes.

Affichage des informations de base des systèmes ZFS

La commande zfs list spécifiée sans option permet de répertorier les informations de base sur les jeux de données. Cette commande affiche le nom de tous les jeux de données définis sur le système ainsi que les valeurs used, available, referenced et mountpoint correspondantes. Pour plus d'informations sur ces propriétés, reportez-vous à la section Présentation des propriétés ZFS.

Par exemple :

# 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

Cette commande permet d'afficher des jeux de données spécifiques. Pour cela, spécifiez le nom du ou des jeux de données à afficher sur la ligne de commande. Vous pouvez également spécifier l'option -r pour afficher de manière récursive tous les descendants des jeux de données. Par exemple :

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

Vous pouvez utiliser la commande zfs list avec le point de montage d'un système de fichiers. Par exemple :

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

L'exemple suivant montre comment afficher des informations de base sur tank/home/gina et l'ensemble de ses systèmes de fichiers descendants :

# 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

Pour plus d'informations sur la commande zfs list, reportez-vous à la page de manuel zfs(1M).

Création de requêtes ZFS complexes

Les options o, -t et -H permettent de personnaliser la sortie de la commande -zfs list.

Vous pouvez également personnaliser la sortie des valeurs de propriété en spécifiant l'option -o ainsi que la liste des propriétés souhaitées séparées par une virgule. Toute propriété de jeu de données peut être utilisée en tant qu'argument valide. Pour consulter la liste de toutes les propriétés de jeu de données prises en charge, reportez-vous à la section Présentation des propriétés ZFS. Outre les propriétés répertoriées dans cette section, la liste de l'option -o peut également contenir la valeur littérale name afin de définir l'inclusion du nom de jeu de données dans la sortie.

Les exemples suivants illustrent l'utilisation de la commande zfs list pour afficher le nom de jeu de données et des valeurs share.nfs et 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

L'option -t permet de spécifier le type de jeu de données à afficher. Le tableau suivant décrit les différents types valides.

Tableau 5-2 Types d'objets ZFS

L'option -t permet de spécifier la liste des types de jeux de données à afficher, séparés par une virgule. L'exemple suivant illustre l'affichage du nom et de la propriété -used de l'ensemble des systèmes de fichiers via l'utilisation simultanée des options -t et o :

# 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

L'option -H permet d'exclure l'en-tête de la commande zfs list lors de la génération de la sortie. L'option -H permet de remplacer les espaces par un caractère de tabulation. Cette option permet notamment d'effectuer des analyses sur les sorties (par exemple, des scripts). L'exemple suivant illustre la sortie de la commande zfs list spécifiée avec l'option -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