exportfs(8)

NOM
exportfs - Gestion de la liste des systèmes de fichiers partagés par NFS

SYNOPSIS
/usr/sbin/exportfs [-avi] [-o options,...] [client:/chemin ...]
/usr/sbin/exportfs -r [-v]
/usr/sbin/exportfs [-av] -u [client:/chemin ...]
/usr/sbin/exportfs [-v]
/usr/sbin/exportfs -f
/usr/sbin/exportfs -s

DESCRIPTION
Un serveur NFS tient à jour une liste des systèmes de fichiers physiques locaux accessibles aux clients NFS. Chaque système de fichiers de cette liste est appelé système de fichiers partagé, ou alors partage en plus court.

La commande exportfs est utilisée pour la gestion de la liste actuelle de systèmes de fichiers partagés par NFS. Cette liste est enregistrée dans un fichier spécifique nommé /var/lib/nfs/etab. Ce fichier sera lu par rpc.mountd dès qu'un client distant enverra une requête NFS MOUNT.

Dans le cas général, la liste principale des partages est initialisée à partir du contenu du fichier /etc/exports et des fichiers présents dans /etc/exports.d/ à l'aide de la commande exportfs -a. Cependant, un administrateur système peut ajouter ou supprimer des partages sans modifier /etc/exports ou les fichiers sous /etc/exports.d/ à l'aide de la commande exportfs.

exportfs et son programme associé rpc.mountd fonctionnent sous l'un des deux modes suivants : le mode traditionnel, qui s'applique aux versions 2.4 et précédentes du noyau Linux, et un mode plus récent sous les noyaux 2.6 et suivants, accessible à la condition que le système de fichiers virtuel de nfsd soit bien monté sous /proc/fs/nfsd ou /proc/fs/nfs. Si ce système de fichiers n'est pas monté en 2.6, c'est le mode traditionnel qui sera utilisé.

Dans le mode plus récent, exportfs ne donne aucune information au noyau, il n'en fournit qu'à rpc.mountd par l'intermédiaire du fichier /var/lib/nfs/etab. rpc.mountd écoutera les requêtes du noyau pour obtenir les renseignements nécessaires à propos des partages.

Dans le mode traditionnel, les partages qui indiquent un hôte spécifique, plutôt qu'un sous-réseau ou un groupe de machines sont directement inscrits dans la table des partages du noyau ainsi que dans le fichier /var/lib/nfs/etab. De plus, tous les partages définis dans /var/lib/nfs/rmtab correspondant à une demande de partage non spécifique à un hôte entraînera l'ajout, dans la table des partages du noyau, d'une entrée correspondante à l'hôte effectif dans rmtab.

OPTIONS

-d, --debug mot-clé
    Turn on debugging. Valid kinds are: all, auth, call, general and parse. Debugging can also be turned on by setting debug= in the [exportfs] section of /etc/nfs.conf.

-a  Partager ou interrompre le partage de tous les répertoires.

-o options,...
    Indiquer une liste d'options de partage, à la manière de exports(5).

-i  Ne pas tenir compte du fichier /etc/exports ni du répertoire /etc/exports.d/. Seules les options par défaut ou celles données sur la ligne de commande sont utilisées.

-r  Relancer le partage de tous les répertoires. /var/lib/nfs/etab est synchronisé avec /etc/exports et le répertoire /etc/exports.d/. Avec cette option, les entrées qui ont disparu de /etc/exports ou /etc/exports.d/ seront supprimées de /var/lib/nfs/etab. Dans la table des partages du noyau, les entrées qui ne sont plus valables seront également enlevées.

-u  Interrompre le partage d'un ou plusieurs répertoires.

-f  Si /proc/fs/nfsd ou /proc/fs/nfs sont montés, vider toute la liste des partages du noyau. Les entrées correspondant aux clients actifs sont ajoutées à la liste des partages du noyau par rpc.mountd lors de leur requête de montage NFS.

-v  Mode volubile. Lors d'un partage ou de l'arrêt d'un partage, afficher ce qui se passe. Lors de l'affichage de la liste actuelle des partages, afficher aussi la liste des options de partage.

-s  Display the current export list suitable for /etc/exports.

FICHIER DE CONFIGURATION
The [exportfs] section of the /etc/nfs.conf configuration file can contain a debug value, which can be one or more from the list general, call, auth, parse, all. When a list is given, the members should be comma-separated. exportfs will also recognize the state-directory-path value from the [mountd] section.

DISCUSSION

  Partage de répertoires
Le premier synopsis montre comment utiliser la commande exportfs pour ajouter de nouvelles entrées à la liste des partages. Quand on lance exportfs -a, tous les partages listés dans /etc/exports et /etc/exports.d/ sont ajoutés à /var/lib/nfs/etab. La liste des partages du noyau est également mise à jour au besoin.

The host:/path argument specifies a local directory to export, along with the client or clients who are permitted to access it. See exports(5) for a description of supported options and access list formats.

IPv6 presentation addresses contain colons, which are already used to separate the "host" and "path" command line arguments. When specifying a client using a raw IPv6 address, enclose the address in square brackets. For IPv6 network addresses, place the prefix just after the closing bracket.

To export a directory to the world, simply specify :/path.

Les options de partage pour une paire hôte/répertoire donnée proviennent de plusieurs sources. Les options de partage par défaut sont sync,ro,root_squash,wdelay. Elles peuvent être surchargées par les entrées du fichier /etc/exports ou du répertoire /etc/exports.d/.

Un administrateur système peut surcharger les options de ces sources à l'aide de l'option -o d'exportfs. Cette option utilise une liste d'options séparées par des virgules de manière similaire à ce qui serait fait si ces options étaient écrites dans le fichier /etc/exports. Ainsi, exportfs peut être utilisé pour modifier les options de partage d'un répertoire déjà partagé.

  Arrêt du partage de répertoires
Ce troisième synopsis montre comment arrêter le partage d'un répertoire actuellement offert. Quand on lance exportfs -ua, toutes les entrées présentes dans /var/lib/nfs/etab sont retirées de la table des partages du noyau, puis le fichier est vidé. Cela stoppe effectivement toute activité NFS.

Pour supprimer une entrée de partage, vous pouvez indiquer un couple client:/chemin. L'entrée indiquée sera supprimée de /var/lib/nfs/etab, ainsi que celle correspondante dans le noyau (si elle existe).

  Affichage du contenu de la table des partages
L'utilisation de exportfs sans option affiche la liste actuelle des systèmes de fichiers partagés. Avec l'option -v, exportfs affiche les options spécifiques à chaque partage.

EXEMPLES
L'exemple suivant ajoute tous les répertoires indiqués dans /etc/exports et /etc/exports.d/ à /var/lib/nfs/etab, puis les entrées de partages résultantes sont inscrites dans le noyau :

# exportfs -a

Pour offrir le répertoire /usr/tmp à l'hôte django, en permettant les requêtes non sécurisées de verrouillage de fichier :

# exportfs -o insecure_locks django:/usr/tmp

Pour cesser de partager le répertoire /usr/tmp :

# exportfs -u django:/usr/tmp

Pour cesser de partager tous les partages indiqués dans /etc/exports et le répertoire /etc/exports.d/ :

# exportfs -au

To export the /usr/tmp directory to IPv6 link-local clients:

# exportfs [fe80::]/64:/usr/tmp

NOTES D'UTILISATION
Le partage à destination de réseaux IP ou de domaines DNS et NIS ne permet pas l'accès NFS immédiat aux clients NFS de ces groupes. En fait, ce type de partage est une indication pour rpc.mountd(8) d'honorer toute requête de montage provenant de ces clients. Ce n'est normalement pas un gros problème, puisque tout montage existant est préservé dans rmtab de redémarrage en redémarrage.

Lors de l'arrêt d'un partage à destination de domaines ou de réseaux, tout partage en cours pour les membres de ce groupe sera vérifié par rapport à la liste des partages valides restants. Dans le cas où ce partage n'est alors plus autorisé, il est supprimé.

FICHIERS

/etc/exports
    Fichier d'entrée contenant la liste des partages, leurs options et la liste des contrôles d'accès.

/etc/exports.d
    répertoire où les fichiers d'entrée supplémentaires sont stockés. Note : uniquement les fichiers se terminant par .exports sont utilisés.

/var/lib/nfs/etab
    Liste principale des partages.

/var/lib/nfs/rmtab
    Liste des clients se connectant aux partages du serveur.

VOIR AUSSI
exports(5), nfs.conf(5), rpc.mountd(8), netgroup(5)

AUTEURS
Olaf Kirch <okir@monad.swb.de>
Neil Brown <neilb@cse.unsw.edu.au>

TRADUCTION
La traduction française de cette page de manuel a été créée par Valéry Perrin <valery.perrin.debian@free.fr>, Sylvain Cherrier <sylvain.cherrier@free.fr>, Thomas Huriaux <thomas.huriaux@gmail.com>, Dominique Simen <dominiquesimen@hotmail.com>, Nicolas Sauzède <nsauzede@free.fr>, Romain Doumenc <rd6137@gmail.com>, David Prévot <david@tilapin.org>, Denis Mugnier <myou72@orange.fr> et Cédric Boutillier <cedric.boutillier@gmail.com> Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à <debian-l10n-french@lists.debian.org>.