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.

Exemple :

# 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

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. Exemple :

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

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

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

L'exemple suivant illustre la manière d'afficher les informations de base sur tank/home/chua et tous ses jeux de données descendants :

# 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

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 sharenfs et 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

L'option -t permet de spécifier le type de jeu de données à afficher. Les types corrects sont décrits dans le tableau suivant.

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 -t filesystem -o name,used
NAME              USED
pool              476K
pool/clone         18K
pool/home         296K
pool/home/marks   277K
pool/test          18K

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 -H -o name
pool
pool/clone
pool/home
pool/home/marks
pool/home/marks@snap
pool/test