Параметр разрешает задать файл определяющий соответствие имен пользователей для клиентов на сервере. Может использоваться в нескольких целях.
Самое стандартное применение это соответствие имен пользователей DOS и Windows именам, используемым на Unix системе. Другой применение сопоставления нескольких пользователей одному имени пользователя для упрощения использования общего ресурса.
     Заметьте, что для пользователя или режима безопасности share, сопоставление пользователя применимо до утверждения пользовательских вверительных грамот (credentials). Серверы члены домена (домена или ads) применяют сопоставление имени пользователя после того, как пользователь был успешно зарегистрирован контроллером домена и требуют полного имени в таблице соответствия (например, biddle = DOMAINfoo).
     Файл соответствия просматривается построчно. Каждая строка должна содержать имя пользователя UNIX слева, потом ‘=’, далее список имен пользователей справа. Список имен пользователя справа может содержать имена в формате @group, тогда они будут соответствовать любому имени пользователя UNIX в этой группе. Специальное имя клиента ‘*’ является групповым символом и соответствует любому имени. Каждая строка файла соответствий может достигать 1023 символов. Файл обрабатывается построчно, беря имя пользователя и сравнивая его с каждым именем пользователя справа от знака ‘=’. Если имя соответствует любому из имен справа тогда, оно заменяется именем слева. Обработка продолжится со следующей строки. Если строка начинается с ‘#’ или ‘;’ она игнорируется. Если строка начинается ‘!’ тогда обработка файла остановится после этой строки, если соответствие найдено. Иначе поиск соответствия продолжится дальше. Используя ‘!’ является самым полезным, если в следующих строках у вас есть групповые соответствия. Например, для создания сопоставления имени admin или administrator к UNIX имени root, создайте такую строку:
root = admin administrator
 
Или создайте соответствие любой пользователь группы system UNIX к UNIX имени sys:
sys = @system
 
     Вы можете создать множество соответствий имен в файле соответствий. Если Ваша система поддерживает опцию NIS NETGROUP, тогда база данных netgroup проверяется перед базой данных /etc/group для поиска соответствий в группах. Вы можете создать соответствия для имен пользователей Windows, в именах которых есть пробелы, используя двойные кавычки вокруг имени. Например:
tridge = "Andrew Tridgell"
создаст соответствие “Andrew Tridgell” к имени пользователя unix “tridge”.
 
     Следующий пример создаст соответствие для mary и fred к unix пользователю sys, и для остальных создаст соответствие к пользователю guest. Заметьте использование ‘!’ укажет Самбе прекращать обработку файла, если соответствие найдено в текущей строке:
!sys = mary fred
guest = *
 
       Заметьте, что переназначение имен применяется ко всем найденным именам пользователей. Таким образом, если Вы соединитесь с \serverfred, и fred повторно переназначен в mary, тогда фактически вы будете соединяться с \servermary и должны будете предоставить пароль, подходящий для mary, а не fred.
    Единственное исключение — это имя пользователя, которое передается серверу пароля (если он у Вас один). Сервер пароля получит любое имя пользователя клиента без модификации. Также заметьте, что обратное переназначение имени не делается. Основная проблема в данном случае с печатью. У пользователей, которые были сопоставлены может возникнуть проблема при удалении заданий печати, поскольку PrintManager под WfWg будет думать, что очередь печати им не принадлежит. Версии Самбы до 3.0.8 поддерживали чтение только полного имени пользователя (например: DOMAINuser) из таблицы соответствий при выполнении kerberos логина от клиента. Однако, при поиске соответствия для пользователя использующего NTLM [SSP], использовалось только имя пользователя (без указания домена, прим. переводчика). Иногда это приводило к противоречивому поведению даже на том же самом сервере.
Следующие функциональные возможности появились в версии 3.0.8 и более поздних:
   — При локальной аутентификации, таблица соответствия применяется к имени пользователя прежде подтверждения подлинности соединения.
   — Полагаясь на внешний контроллер домена для подтверждения запроса аутентификации, smbd применит таблицу соответствия пользователя к полному имени пользователя (то есть. DOMAINuser), только после того, как пользователь был успешно аутентифицирован.
 
По умолчанию:
username map = # нет таблицы соответствия
 
Пример использования:
username map = /usr/local/samba/lib/users.map