idmapd.conf
Section: File Formats (5)Updated: 19 Nov 2008
Index Return to Main Contents
NAME
idmapd.conf - configuration file for libnfsidmapSYNOPSIS
Configuration file for libnfsidmap. Used by idmapd and svcgssd to map NFSv4 name to and from ids.DESCRIPTION
The idmapd.conf configuration file consists of several sections, initiated by strings of the form [General] and [Mapping]. Each section may contain lines of the formvariable = valueThe recognized sections and their recognized variables are as follows:
[General] section variables
- Verbosity
- Verbosity level of debugging (Default: 0)
- Domain
- The local NFSv4 domain name. An NFSv4 domain is a namespace with a unique username<->UID and groupname<->GID mapping. (Default: Host's fully-qualified DNS domain name)
- Local-Realms
-
A comma-separated list of Kerberos realm names that may be considered equivalent to the
local realm name. For example, users juser@ORDER.EDU and juser@MAIL.ORDER.EDU
may be considered to be the same user in the specified
Domain.
(Default: the host's default realm name)
Note: If a value is specified here, the default local realm must be included as well.
[Mapping] section variables
- Nobody-User
- Local user name to be used when a mapping cannot be completed.
- Nobody-Group
- Local group name to be used when a mapping cannot be completed.
[Translation] section variables
- Method
- A comma-separated, ordered list of mapping methods (plug-ins) to use when mapping between NFSv4 names and local IDs. Each specified method is tried in order until a mapping is found, or there are no more methods to try. The methods included in the default distribution include "nsswitch", "umich_ldap", and "static". (Default: nsswitch)
- GSS-Methods
- An optional comma-separated, ordered list of mapping methods (plug-ins) to use when mapping between GSS Authenticated names and local IDs. (Default: the same list as specified for Method)
[Static] section variables
The "static" translation method uses a static list of GSS-Authenticated names to local user names. Entries in the list are of the form:
principal@REALM = localusername
[UMICH_SCHEMA] section variables
If the "umich_ldap" translation method is specified, the following variables within the [UMICH_SCHEMA] section are used.
- LDAP_server
- LDAP server name or address (Required if using UMICH_LDAP)
- LDAP_base
- Absolute LDAP search base. (Required if using UMICH_LDAP)
- LDAP_people_base
- Absolute LDAP search base for people accounts. (Default: The LDAP_base value)
- LDAP_group_base
- Absolute LDAP search base for group accounts. (Default: The LDAP_base value)
- LDAP_canonicalize_name
- Whether or not to perform name canonicalization on the name given as LDAP_server (Default: "true")
- LDAP_use_ssl
- Set to "true" to enable SSL communication with the LDAP server. (Default: "false")
- LDAP_ca_cert
- Location of a trusted CA certificate used when SSL is enabled (Required if LDAP_use_ssl is true)
- NFSv4_person_objectclass
- The object class name for people accounts in your local LDAP schema (Default: NFSv4RemotePerson)
- NFSv4_name_attr
- Your local schema's attribute name to be used for NFSv4 user names (Default: NFSv4Name)
- NFSv4_uid_attr
- Your local schema's attribute name to be used for uidNumber (Default: uidNumber)
- GSS_principal_attr
- Your local schema's attribute name for GSSAPI Principal names (Default: GSSAuthName)
- NFSv4_acctname_attr
- Your local schema's attribute name to be used for account names (Default: uid)
- NFSv4_group_objectclass
- The object class name for group accounts in your local LDAP schema (Default: NFSv4RemoteGroup)
- NFSv4_gid_attr
- Your local schema's attribute name to be used for gidNumber (Default: gidNumber)
- NFSv4_group_attr
- Your local schema's attribute name to be used for NFSv4 group names (Default: NFSv4Name)
- LDAP_use_memberof_for_groups
- Some LDAP servers do a better job with indexing where searching through all the groups searching for the user in the memberuid list. Others like SunOne directory that search can takes minutes if there are thousands of groups. So setting LDAP_use_memberof_for_groups to true in the configuration file will use the memberof lists of the account and search through only those groups to obtain gids. (Default: false)
- NFSv4_member_attr
- If LDAP_use_memberof_for_groups is true, this is the attribute to be searched for. (Default: memberUid)
- NFSv4_grouplist_filter
- An optional search filter for determining group membership. (No Default)
- LDAP_timeout_seconds
- Number of seconds before timing out an LDAP request (Default: 4)
EXAMPLES
An example /etc/idmapd.conf file:[General] Verbosity = 0 Domain = domain.org Local-Realms = DOMAIN.ORG,MY.DOMAIN.ORG,YOUR.DOMAIN.ORG [Mapping] Nobody-User = nfsnobody Nobody-Group = nfsnobody [Translation] Method = umich_ldap,nsswitch GSS-Methods = umich_ldap,static [Static] johndoe@OTHER.DOMAIN.ORG = johnny [UMICH_SCHEMA] LDAP_server = ldap.domain.org LDAP_base = dc=org,dc=domain
SEE ALSO
idmapd(8) svcgssd(8)BUGS
Report bugs to <nfsv4@linux-nfs.org>
Index
This document was created by man2html, using the manual pages.
Time: 04:45:56 GMT, September 16, 2022 Content-type: text/html; charset=UTF-8
RPC.IDMAPD
Section: Maintenance Commands (8)Index Return to Main Contents
BSD mandoc
NAME
rpc.idmapd - NFSv4 ID <-> Name MapperSYNOPSIS
rpc.idmapd [-h ] [-f ] [-v ] [-C ] [-S ] [-p path ] [-c path ]DESCRIPTION
rpc.idmapd is the NFSv4 ID <-> name mapping daemon. It provides functionality to the NFSv4 kernel client and server, to which it communicates via upcalls, by translating user and group IDs to names, and vice versa.Note that on more recent kernels only the NFSv4 server uses . The NFSv4 client instead uses nfsidmap(8), and only falls back to rpc.idmapd if there was a problem running the nfsidmap(8) program.
The options are as follows:
- -h
- Display usage message.
- -v
- Increases the verbosity level (can be specified multiple times).
- -f
- Runs rpc.idmapd in the foreground and prints all output to the terminal.
- -p path
- Specifies the location of the RPC pipefs to be path The default value is "/var/lib/nfs/rpc_pipefs".
- -c path
- Use configuration file path
- -C
- Client-only: perform no idmapping for any NFS server, even if one is detected.
- -S
- Server-only: perform no idmapping for any NFS client, even if one is detected.
EXAMPLES
rpc.idmapd -f -vvvRuns rpc.idmapd printing all messages to console, and with a verbosity level of 3.
FILES
/etc/idmapd.confSEE ALSO
idmapd.conf5, nfsidmap(8)AUTHORS
The rpc.idmapd software has been developed by Marius Aamodt Eriksen Aq marius@citi.umich.edu .
Index
This document was created by man2html, using the manual pages.
Time: 04:46:00 GMT, September 16, 2022
0 댓글