Gestion des propriétés ZFS

La gestion des propriétés de jeu de données s'effectue à l'aide des sous-commandes set, inherit et get de la commande zfs.

• Définition des propriétés ZFS

• Héritage des propriétés ZFS

• Envoi de requêtes sur les propriétés ZFS

Définition des propriétés ZFS

La commande zfs set permet de modifier les propriétés de jeu de données pouvant être définies. Vous pouvez également définir les propriétés lors de la création des jeux de données à l'aide de la commande zfs create. Pour consulter la listes des propriétés de jeu de données définies, reportez-vous à la section Propriétés ZFS natives définies.

La commande zfs set permet d'indiquer une séquence propriété/valeur au format property=value, suivie du nom du jeu de données. Lors de chaque appel de la commande zfs set, vous ne pouvez définir ou modifier qu'une propriété à la fois.

L'exemple suivant illustre la définition de la propriété atime sur la valeur off pour tank/home.

# zfs set atime=off tank/home

Vous pouvez également définir les propriétés des systèmes de fichiers une fois ces derniers créés. Par exemple :

# zfs create -o atime=off tank/home

Vous pouvez spécifier des valeurs de propriété numériques en utilisant les suffixes faciles à utiliser suivants (par taille croissante) : BKMGTPEZ. Ces suffixes peuvent être suivis de la lettre b (signifiant "byte", octet) à l'exception du suffixe B, qui fait déjà référence à cette unité de mesure. Les quatre invocations suivantes de zfs set sont des expressions numériques équivalentes qui définissent la propriété quota sur la valeur de 20 Go sur le système de fichiers users/home/mark :

# zfs set quota=20G users/home/mark
# zfs set quota=20g users/home/mark
# zfs set quota=20GB users/home/mark
# zfs set quota=20gb users/home/mark

Si vous tentez de définir une propriété sur un système de fichiers à 100% de sa capacité, un message semblable à celui-ci s'affichera :

# zfs set quota=20gb users/home/mark
cannot set property for '/users/home/mark': out of space

Les valeurs des propriétés non numériques respectent la casse et doivent être en lettres minuscules, à l'exception de mountpoint. Les valeurs de cette propriété peuvent contenir à la fois des majuscules et des minuscules.

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

Héritage des propriétés ZFS

A l'exception des quotas et des réservations, toutes les propriétés pouvant être définies héritent de la valeur du système de fichiers parent (sauf si un quota ou une réservation est explicitement défini sur le système de fichiers descendant). Si aucune valeur explicite n'est définie pour une propriété d'un système ascendant, la valeur par défaut de cette propriété est appliquée. Vous pouvez utiliser la commande zfs inherit pour effacer la valeur d'une propriété et faire ainsi hériter la valeur du système de fichiers parent.

L'exemple suivant utilise la commande zfs set pour activer la compression du système de fichiers tank/home/jeff. La commande zfs inherit est ensuite exécutée afin de supprimer la valeur de la propriété compression, entraînant ainsi l'héritage de la valeur par défaut off. En effet, la propriété compression n'est définie localement ni pour home, ni pour tank ; la valeur par défaut est donc appliquée. Si la compression avait été activée pour ces deux systèmes, la valeur définie pour le système ascendant direct aurait été utilisée (en l'occurrence, home).

# zfs set compression=on tank/home/jeff
# zfs get -r compression tank/home
NAME                  PROPERTY     VALUE     SOURCE
tank/home             compression  off       default
tank/home/eric        compression  off       default
tank/home/eric@today  compression  -         -
tank/home/jeff        compression  on        local
# zfs inherit compression tank/home/jeff
# zfs get -r compression tank/home
NAME                  PROPERTY     VALUE     SOURCE
tank/home             compression  off       default
tank/home/eric        compression  off       default
tank/home/eric@today  compression  -         -
tank/home/jeff        compression  off       default

La sous-commande inherit est appliquée de manière récursive lorsque l'option -r est spécifiée. Dans l'exemple suivant, la commande entraîne l'héritage de la valeur de la propriété compression pour tank/home ainsi que pour ses éventuels descendants :

# zfs inherit -r compression tank/home

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

Envoi de requêtes sur les propriétés ZFS

Le moyen le plus simple pour envoyer une requête sur les valeurs de propriété consiste à exécuter la commande zfs list. Pour plus d'informations, reportez-vous à la section Affichage des informations de base des systèmes ZFS. Cependant, dans le cadre de requêtes complexes et pour les scripts, utilisez la commande zfs get afin de fournir des informations plus détaillées dans un format personnalisé.

La commande zfs get permet de récupérer les propriétés de jeu de données. L'exemple suivant illustre la récupération d'une seule valeur de propriété au sein d'un jeu de données :

# zfs get checksum tank/ws
NAME             PROPERTY       VALUE                      SOURCE
tank/ws          checksum       on                         default

La quatrième colonne SOURCE indique l'origine de la valeur de cette propriété. Le tableau ci-dessous définit les valeurs possibles de la source.

Tableau 5-3 Valeurs possibles de la colonne SOURCE (commande zfs get)

Le mot-clé all permet de récupérer toutes les valeurs de propriétés du jeu de données. Les exemples suivants utilisent le mot-clé all :

# zfs get all tank/home
NAME       PROPERTY              VALUE                  SOURCE
tank/home  aclinherit            restricted             default
tank/home  aclmode               discard                default
tank/home  atime                 on                     default
tank/home  available             66.9G                  -
tank/home  canmount              on                     default
tank/home  casesensitivity       mixed                  -
tank/home  checksum              on                     default
tank/home  compression           off                    default
tank/home  compressratio         1.00x                  -
tank/home  copies                1                      default
tank/home  creation              Fri May 11 10:58 2012  -
tank/home  dedup                 off                    default
tank/home  devices               on                     default
tank/home  encryption            off                    -
tank/home  exec                  on                     default
tank/home  keysource             none                   default
tank/home  keystatus             none                   -
tank/home  logbias               latency                default
tank/home  mlslabel              none                   -
tank/home  mounted               yes                    -
tank/home  mountpoint            /tank/home             default
tank/home  multilevel            off                    -
tank/home  nbmand                off                    default
tank/home  normalization         none                   -
tank/home  primarycache          all                    default
tank/home  quota                 none                   default
tank/home  readonly              off                    default
tank/home  recordsize            128K                   default
tank/home  referenced            43K                    -
tank/home  refquota              none                   default
tank/home  refreservation        none                   default
tank/home  rekeydate             -                      default
tank/home  reservation           none                   default
tank/home  rstchown              on                     default
tank/home  secondarycache        all                    default
tank/home  setuid                on                     default
tank/home  shadow                none                   -
tank/home  share.*               ...                    local
tank/home  snapdir               hidden                 default
tank/home  sync                  standard               default
tank/home  type                  filesystem             -
tank/home  used                  8.54M                  -
tank/home  usedbychildren        8.49M                  -
tank/home  usedbydataset         43K                    -
tank/home  usedbyrefreservation  0                      -
tank/home  usedbysnapshots       0                      -
tank/home  utf8only              off                    -
tank/home  version               6                      -
tank/home  vscan                 off                    default
tank/home  xattr                 on                     default
tank/home  zoned                 off                    default

L'option -s spécifiée avec la commande zfs get permet de spécifier, en fonction du type de source, les propriétés à afficher. Cette option permet d'indiquer la liste des types de sources souhaités, séparés par une virgule. Seules les propriétés associées au type de source spécifié sont affichées. Les types de source valides sont local, default, inherited, temporary et none. L'exemple suivant indique l'ensemble des propriétés définies localement sur tank/ws.

# zfs get -s local all tank/ws
NAME     PROPERTY              VALUE                  SOURCE
tank/ws  compression           on                     local

Les options décrites ci-dessus peuvent être associées à l'option -r afin d'afficher de manière récursive les propriétés spécifiées sur les systèmes enfant du système de fichiers concerné. Dans l'exemple suivant, toutes les propriétés temporaires de l'ensemble des systèmes de fichiers de tank/home sont affichées de façon récursive :

# zfs get -r -s temporary all tank/home
NAME             PROPERTY       VALUE                      SOURCE
tank/home          atime          off                      temporary
tank/home/jeff     atime          off                      temporary
tank/home/mark     quota          20G                      temporary

Vous pouvez interroger les valeurs d'une propriété à l'aide de la commande zfs get sans spécifier le système de fichiers cible (la commande fonctionne sur tous les systèmes de fichiers et les pools). Par exemple :

# zfs get -s local all
tank/home               atime          off                    local
tank/home/jeff          atime          off                    local
tank/home/mark          quota          20G                    local

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

Envoi de requête sur les propriétés ZFS pour l'exécution de scripts

La commande zfs get prend en charge les options -H et -o, qui permettent l'exécution de scripts. Vous pouvez utiliser l'option -H pour omettre les informations d'en-tête et pour remplacer un espace par un caractère de tabulation. L'uniformisation des espaces permet de faciliter l'analyse des données. Vous pouvez utiliser l'option -o pour personnaliser la sortie de l'une des façons suivantes :

• Le littéral nom peut être utilisé avec une liste séparée par des virgules de propriétés comme l'explique la section Présentation des propriétés ZFS.

• Une liste de champs littéraux séparés par des virgules (name, value, property et source) suivi d'un espace et d'un argument. En d'autres termes, il s'agit d'une liste de propriétés séparées par des virgules.

L'exemple suivant illustre la commande permettant de récupérer une seule valeur en spécifiant les options -H et -o de la commande zfs get:

# zfs get -H -o value compression tank/home
on

L'option -p indique les valeurs numériques sous leur forme exacte. Par exemple, 1 Mo serait signalé sous la forme 1000000. Cette option peut être utilisée comme suit :

# zfs get -H -o value -p used tank/home
182983742

L'option -r permet de récupérer de manière récursive les valeurs demandées pour l'ensemble des descendants et peut s'utiliser avec toutes les options mentionnées précédemment. Dans l'exemple suivant, les options -H, -o et - r sont spécifiées afin de récupérer le nom du système de fichiers et la valeur de la propriété used pour export/home et ses descendants, tout en excluant les en-têtes dans la sortie :

# zfs get -H -o name,value -r used export/home