1RPC.IDMAPD(8)             BSD System Manager's Manual            RPC.IDMAPD(8)
2

NAME

4     rpc.idmapd — NFSv4 ID <-> Name Mapper
5

SYNOPSIS

7     rpc.idmapd [-h] [-f] [-v] [-C] [-S] [-p path] [-c path]
8

DESCRIPTION

10     rpc.idmapd is the NFSv4 ID <-> name mapping daemon.  It provides func‐
11     tionality to the NFSv4 kernel client and server, to which it communicates
12     via upcalls, by translating user and group IDs to names, and vice versa.
13
14     The system derives the user part of the string by performing a password
15     or group lookup.  The lookup mechanism is configured in /etc/idmapd.conf
16
17     By default, the domain part of the string is the system's DNS domain
18     name.  It can also be specified in /etc/idmapd.conf if the system is
19     multi-homed, or if the system's DNS domain name does not match the name
20     of the system's Kerberos realm.
21
22     When the domain is not specified in /etc/idmapd.conf the local DNS server
23     will be queried for the _nfsv4idmapdomain text record. If the record ex‐
24     ists that will be used as the domain. When the record does not exist, the
25     domain part of the DNS domain will used.
26
27     Note that on more recent kernels only the NFSv4 server uses rpc.idmapd.
28     The NFSv4 client instead uses nfsidmap(8), and only falls back to
29     rpc.idmapd if there was a problem running the nfsidmap(8) program.
30
31     The options are as follows:
32
33     -h           Display usage message.
34
35     -v           Increases the verbosity level (can be specified multiple
36                  times).
37
38     -f           Runs rpc.idmapd in the foreground and prints all output to
39                  the terminal.
40
41     -p path      Specifies the location of the RPC pipefs to be path.  The
42                  default value is "/var/lib/nfs/rpc_pipefs".
43
44     -c path      Use configuration file path.  This option is deprecated.
45
46     -C           Client-only: perform no idmapping for any NFS server, even
47                  if one is detected.
48
49     -S           Server-only: perform no idmapping for any NFS client, even
50                  if one is detected.
51

CONFIGURATION FILES

53     rpc.idmapd recognizes the following value from the [general] section of
54     the /etc/nfs.conf configuration file:
55
56     pipefs-directory
57                  Equivalent to -p.
58
59     All other settings related to id mapping are found in the
60     /etc/idmapd.conf configuration file.
61

EXAMPLES

63     rpc.idmapd -f -vvv
64
65     Runs rpc.idmapd printing all messages to console, and with a verbosity
66     level of 3.
67

FILES

69     /etc/idmapd.conf, /etc/nfs.conf
70

SEE ALSO

72     idmapd.conf(5), nfs.conf(5), nfsidmap(8)
73

AUTHORS

75     The rpc.idmapd software has been developed by Marius Aamodt Eriksen
76     ⟨marius@citi.umich.edu⟩.
77
78BSD                            February 3, 2003                            BSD
Impressum