idmapd.conf(5)
NAME
idmapd.conf - configuration file for libnfsidmap
SYNOPSIS
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 form
variable = value
The 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>
19 Nov 2008 idmapd.conf(5)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
