nfsd(7) Miscellaneous Information Manual nfsd(7) NOM nfsd -- Systeme de fichiers special permettant le controle du serveur NFS de Linux SYNOPSIS mount -t nfsd nfsd /proc/fs/nfsd DESCRIPTION Le systeme de fichiers nfsd est un systeme de fichiers special permettant l'acces au serveur NFS de Linux. L'ecriture dans des fichiers de ce systeme de fichiers peut affecter le comportement du serveur. La lecture du contenu de ces fichiers peut fournir des informations a propos du serveur. Comme pour ce systeme de fichiers, il existe un ensemble de fichiers dans le systeme de fichiers procfs (habituellement monte dans /proc) qui permettent le controle du serveur NFS. Cette page de manuel decrit tous ces fichiers. Les programmes exportfs et mountd qui font partie du paquet nfs-utils s'attendent a trouver ce systeme de fichiers monte a l'emplacement /proc/fs/nfsd ou /proc/fs/nfs. DETAILS Les fichiers presents dans le systeme de fichiers nfsd sont : exports Ce fichier contient la liste des systemes de fichiers qui sont actuellement partages, les clients vers lesquels ils le sont, ainsi que la liste des options de partage pour chacune des paires client/systeme de fichiers. Cela ressemble au contenu du fichier /proc/fs/nfs/exports du noyau 2.4. La difference, c'est qu'un client ne correspond pas necessairement a une seule et unique machine. Il peut s'agir d'un nombre important d'hotes qui seront traites a l'identique. Chaque ligne de ce fichier contient un chemin, le nom d'un client et un certain nombre d'options entre parentheses. Tout caractere espace, tabulation, retour a la ligne ou barre oblique inverse present dans le nom d'un chemin ou d'un client sera remplace par un caractere barre oblique inverse (antislash) suivi du code ASCII de ce caractere, exprime en octal. threads Ce fichier contient le nombre de processus legers (thread) de nfsd actuellement en cours d'execution. La lecture du fichier affichera le nombre de processus legers. Ecrire un nombre decimal en ASCII modifiera le nombre de processus legers (a la hausse ou a la baisse) afin d'atteindre la valeur demandee. filehandle C'est un fichier un peu inhabituel, puisque ce qu'on y lit depend de ce que l'on vient juste d'y ecrire. Il offre une interface transactionnelle afin qu'un programme puisse ouvrir ce fichier, y ecrire une requete et y lire la reponse. Si deux programmes differents ouvrent, ecrivent et lisent ce fichier au meme moment, leurs requetes ne se melangeront pas. Les requetes ecrites dans filehandle devront etre de la forme un nom de client, un nom de chemin et un nombre d'octets. Un retour a la ligne terminera la requete, les champs seront separes par une espace et tout caractere special sera protege et ecrit en octal. Grace a cette ecriture, le programme pourra acceder a un descripteur de fichier (<< filehandle >>) pour ce chemin, tel qu'il est partage pour ce client. La taille de ce descripteur de fichier (<< filehandle >>) sera au plus le nombre d'octets demande. Le descripteur de fichier (<< filehandle >>) sera represente en hexadecimal et prefixe par << \x >>. clients/ Ce repertoire contient un sous-repertoire pour chaque client NFSv4. Chaque fichier de ce sous-repertoire fournit des details sur le client au format YAML. En plus, ecrire << expire\n >> dans le fichier ctl force le serveur a revoquer tout statut detenu par ce client. Le repertoire /proc/net/rpc du systeme de fichiers procfs contient un certain nombre de fichiers et de repertoires. Ces fichiers contiennent des statistiques qui peuvent etre affichees grace au programme nfsstat. Les repertoires contiennent des informations sur les differents caches que le serveur NFS utilise pour assurer le suivi des permissions d'acces dont disposent les differents clients sur les differents systemes de fichiers. Ces caches sont : auth.unix.ip Ce cache contient la correspondance entre les adresses IP et les noms du domaine d'authentification auxquels ces adresses IP sont rattachees. nfsd.export Ce cache contient la correspondance entre les repertoires, les domaines et les options de partage. nfsd.fh Ce cache contient la correspondance entre les domaines, les identifiants du systeme de fichiers et les repertoires. L'identifiant du systeme de fichiers est stocke dans les descripteurs de fichier (<< filehandle >>) et est compose d'un nombre indiquant le type d'identifiant, ainsi qu'un nombre d'octets en hexadecimal indiquant le contenu de cet identifiant. Chaque repertoire representant un cache peut contenir de 1 a 3 fichiers. Ce sont : flush Quand un nombre de secondes depuis l'epoque Unix (1 janvier 1970) est ecrit dans ce fichier, toutes les entrees du cache qui ont ete mises a jour avant ce fichier seront invalidees et videes du cache. Ecrire une date dans le futur (en secondes depuis l'epoque Unix) dans ce fichier videra tout. Ce fichier est le seul qui est toujours present. content Ce fichier, s'il est present, contient une representation litterale de tous les contenus du cache, un par ligne. Si un contenu est toujours dans le cache (parce qu'il est actuellement en cours d'utilisation), mais qu'il est depasse, ou invalide pour une raison quelconque, il sera affiche en tant que commentaire (avec un diese en debut de ligne). channel Ce fichier, s'il existe, sert de canal de communication entre le serveur nfs en mode noyau et le programme en espace utilisateur. Quand le noyau a besoin d'informations qui ne sont pas dans le cache, il ecrit une ligne dans le fichier channel qui fournit une cle pour cette information. Un programme en mode utilisateur pourra la lire, trouver une reponse, puis ecrire une ligne contenant la cle, une date d'expiration et le contenu de la reponse. Par exemple, le noyau pourrait ecrire nfsd 127.0.0.1 dans le fichier auth.unix.ip/content. Le programme en espace utilisateur pourrait alors ecrire nfsd 127.0.0.1 1057206953 localhost pour dire que 127.0.0.1 doit correspondre a << localhost >>, a ce moment precis. Si le programme utilise select(2) ou poll(2) pour decouvrir s'il peut lire le contenu de channel, il n'obtiendra jamais la fin de fichier. Si toutes les requetes ont ete resolues, il sera bloque jusqu'a ce qu'une autre requete arrive. Dans le systeme de fichiers /proc, 4 fichiers peuvent etre utilises pour tracer un peu plus nfsd et les autres programmes associes. Il s'agit de : /proc/sys/sunrpc/nfs_debug /proc/sys/sunrpc/nfsd_debug /proc/sys/sunrpc/nlm_debug /proc/sys/sunrpc/rpc_debug Ils controlent respectivement le tracage de client NFS, du serveur NFS, du gestionnaire de verrouillage reseau (lockd) et de la couche RPC sous-jacente. Des nombres decimaux peuvent etre lus ou ecrits dans ces fichiers. Chaque nombre represente un schema de bits dans lequel les bits positionnes indiquent certaines classes de tracage a activer. Consultez les fichiers d'en-tetes du noyau (kernel header files) pour savoir a quoi correspond chaque nombre. NOTES Ce systeme de fichiers n'est disponible que dans les versions 2.6 et suivantes du noyau Linux (ainsi que dans les dernieres versions de developpement 2.5 amenant vers la serie 2.6). Cette page de manuel ne concerne pas les noyaux 2.4 et precedents. Auparavant, l'appel systeme nfsctl etait utilise pour la communication entre nfsd et les utilitaires de l'utilisateur. Cet appel systeme a ete retire de la version 3.1 du noyau. Les versions anterieures de nfs-utils etaient capables de se rabattre sur nfsctl si necessaire ; cela a ete supprime de nfs-utils 1.3.5. VOIR AUSSI nfsd(8), rpc.nfsd(8), exports(5), nfsstat(8), mountd(8), exportfs(8). AUTEUR NeilBrown TRADUCTION La traduction francaise de cette page de manuel a ete creee par Valery Perrin , Sylvain Cherrier , Thomas Huriaux , Dominique Simen , Nicolas Sauzede , Romain Doumenc , David Prevot , Denis Mugnier , Cedric Boutillier et Jean-Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . 3 juillet 2003 nfsd(7)