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 The nfsd filesystem is a special filesystem which provides access to the Linux NFS server. Writing to files in this filesystem can affect the server. Reading from them can provide information about the server. 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. The exportfs and mountd programs (part of the nfs-utils package) expect to find this filesystem mounted at /proc/fs/nfsd or /proc/fs/nfs. DETAILS Files in the nfsd filesystem include: 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 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 << ex >>. clients/ This directory contains a subdirectory for each NFSv4 client. Each file under that subdirectory gives some details about the client in YAML format. In addition, writing "expire\n" to the ctl file will force the server to immediately revoke all state held by that 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 When a number of seconds since epoch (1 Jan 1970) is written to this file, all entries in the cache that were last updated before that file become invalidated and will be flushed out. Writing a time in the future (in seconds since epoch) will flush everything. This is the only file that will always be 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 lesquels ces bits definissent 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. Previously the nfsctl systemcall was used for communication between nfsd and user utilities. That systemcall was removed in kernel version 3.1. Older nfs-utils versions were able to fall back to nfsctl if necessary; that was removed from 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 et Cedric Boutillier 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)