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.
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).
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.
Tableau 6–2 Types de jeux de données ZFS
Type |
Description |
---|---|
filesystem |
Systèmes de fichiers et clones |
Volume |
Volumes |
Instantané |
Instantanés |
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 |