nfsidmap - Online Linux Manual PageSection : 5
Updated : 1 October 2010
NAMEnfsidmap − The NFS idmapper upcall program
SYNOPSISnfsidmap [-v] [-t timeout] key desc"
nfsidmap [-v] [-c]"
nfsidmap [-v] [-u|-g|-r user]"
nfsidmap -d"
nfsidmap -l"
nfsidmap -h"
DESCRIPTIONThe NFSv4 protocol represents the local system's UID and GID values on the wire as strings of the form user@domain. The process of translating from UID to string and string to UID is referred to as "ID mapping." The system derives the user part of the string by performing a password or group lookup. The lookup mechanism is configured in /etc/idmapd.conf. By default, the domain part of the string is the system's DNS domain name. It can also be specified in /etc/idmapd.conf if the system is multi-homed, or if the system's DNS domain name does not match the name of the system's Kerberos realm. The /usr/sbin/nfsidmap program performs translations on behalf of the kernel. The kernel uses the request-key mechanism to perform an upcall. /usr/sbin/nfsidmap is invoked by /sbin/request-key, performs the translation, and initializes a key with the resulting information. The kernel then caches the translation results in the key. nfsidmap can also clear cached ID map results in the kernel, or revoke one particular key. An incorrect cached key can result in file and directory ownership reverting to "nobody" on NFSv4 mount points. In addition, the -d and -l options are available to help diagnose misconfigurations. They have no effect on the keyring containing ID mapping results.
OPTIONS-c Clear the keyring of all the keys. -d Display the system's effective NFSv4 domain name on stdout. -g user Revoke the gid key of the given user. -h Display usage message. -l Display on stdout all keys currently in the keyring used to cache ID mapping results. These keys are visible only to the superuser. -r user Revoke both the uid and gid key of the given user. -t timeout Set the expiration timer, in seconds, on the key. The default is 600 seconds (10 mins). -u user Revoke the uid key of the given user. -v Increases the verbosity of the output to syslog (can be specified multiple times).
CONFIGURINGThe file /etc/request-key.conf will need to be modified so /sbin/request-key can properly direct the upcall. The following line should be added before a call to keyctl negate: createid_resolver**/usr/sbin/nfsidmap -t 600 %k %d This will direct all id_resolver requests to the program /usr/sbin/nfsidmap. The -t 600 defines how many seconds into the future the key will expire. This is an optional parameter for /usr/sbin/nfsidmap and will default to 600 seconds when not specified. The idmapper system uses four key descriptions: uid: Find the UID for the given user
gid: Find the GID for the given group
user: Find the user name for the given UID
group: Find the group name for the given GID You can choose to handle any of these individually, rather than using the generic upcall program. If you would like to use your own program for a uid lookup then you would edit your request-key.conf so it looks similar to this: createid_resolveruid:**/some/other/program %k %d
createid_resolver**/usr/sbin/nfsidmap %k %d Notice that the new line was added above the line for the generic program. request-key will find the first matching line and run the corresponding program. In this case, /some/other/program will handle all uid lookups, and /usr/sbin/nfsidmap will handle gid, user, and group lookups.
FILES/etc/idmapd.conf ID mapping configuration file /etc/request-key.conf Request key configuration file
SEE ALSOidmapd.conf(5), request-key(8)
AUTHORBryan Schumaker, <bjschuma@netapp.com> 0
Johanes Gumabo
Data Size : 11,588 byte
man-nfsidmap.5Build : 2024-12-05, 20:55 :
Visitor Screen : x
Visitor Counter ( page / site ) : 2 / 172,549
Visitor ID : :
Visitor IP : 3.144.25.130 :
Visitor Provider : AMAZON-02 :
Provider Position ( lat x lon ) : 39.962500 x -83.006100 : x
Provider Accuracy Radius ( km ) : 1000 :
Provider City : Columbus :
Provider Province : Ohio , : ,
Provider Country : United States :
Provider Continent : North America :
Visitor Recorder : Version :
Visitor Recorder : Library :
Online Linux Manual Page : Version : Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page : Library : lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page : Library : lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base : Version : Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base : Library : lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.