Table of ContentsLibraryView in Frames

Specifying entries in the /etc/usermap.cfg file

Data ONTAP uses the /etc/usermap.cfg file to map user names. In its simplest form, each /etc/usermap.cfg entry contains a pair of names: the Windows name and the UNIX name. Data ONTAP can translate the Windows name to the UNIX name or vice versa.

About this task

When CIFS is started, if the /etc/usermap.cfg file is missing, a default file is created. It contains commented-out sample map entries that are useful for improving security.

When Data ONTAP receives a connection request from a CIFS user, it searches the /etc/usermap.cfg file to see whether an entry matches the user’s Windows domain name and user name.

If an entry is found, Data ONTAP uses the UNIX name specified in the entry to look up the UID and GID from the UNIX password database. If the UNIX name is a null string, Data ONTAP denies access to the CIFS user.

If an entry is not found, Data ONTAP converts the Windows name to lowercase and considers the UNIX name to be the same as the Windows name. Data ONTAP uses this UNIX name to look up the UID and GID from the UNIX password database.

Data ONTAP scans the file sequentially. It uses the first matching entry for mapping.

For information about character coding of the /etc/usermap.cfg file, see the information about the contents of the /etc directory in the Storage Management Guide.


  1. Specify each entry using the following format: [IP_qualifier:] Windows_name [direction] [IP_qualifier:] UNIX_name

After you finish

You can embed comments in the file by beginning the comment lines with #. Comments at the end of an entry are also allowed if preceded by #. Blank lines are ignored.