useradd(8)

НАЗВАНИЕ
useradd - регистрирует нового пользователя или изменяет информацию по умолчанию о новых пользователях

СИНТАКСИС

useradd [параметры] LOGIN

useradd -D

useradd -D [параметры]

ОПИСАНИЕ

При запуске без параметра -D, команда useradd создаёт новую учётную запись пользователя, используя значения из командной строки и системные значения по умолчанию. В зависимости от параметров командной строки, команда useradd обновляет системные файлы, а также может создать домашний каталог нового пользователя и скопировать файлы настроек.

ПАРАМЕТРЫ

Параметры команды useradd:

-c, --commentКОММЕНТАРИЙ
    Любая текстовая строка. Обычно, здесь коротко описывается учётная запись, и в настоящее время используется как поле для имени и фамилии пользователя.

-b, --base-dirБАЗОВЫЙ_КАТАЛОГ
    Базовый системный каталог по умолчанию, если другой каталог не указан с помощью параметра -d. БАЗОВЫЙ_КАТАЛОГ объединяется с именем учётной записи для определения домашнего каталога. Если не используется параметр -m, то БАЗОВЫЙ_КАТАЛОГ должен существовать.

-d, --homeДОМАШНИЙ_КАТАЛОГ
    Для создаваемого пользователя будет использован каталог БАЗОВЫЙ_КАТАЛОГ в качестве начального каталога. По умолчанию, это значение получается объединением ИМЕНИ пользователя с БАЗОВЫМ_КАТАЛОГОМ и используется как имя домашнего каталога. Каталог БАЗОВЫЙ_КАТАЛОГ необязательно должен существовать и не будет создан, если его нет.

-e, --expiredateДАТА_УСТАРЕВАНИЯ
    Дата, когда учётная запись пользователя будет заблокирована. Дата задаётся в формате ГГГГ-ММ-ДД.

-f, --inactiveДНЕЙ
    Число дней, которые должны пройти после устаревания пароля, чтобы учётная запись заблокировалась навсегда. Если указано значение 0, то учётная запись блокируется сразу после устаревания пароля, а при значении -1 данная возможность не используется. По умолчанию используется значение -1.

-g, --gidГРУППА
    Имя или числовой идентификатор новой начальной группы пользователя. Группа с таким именем должна существовать. Идентификатор группы должен указывать на уже существующую группу. Идентификатор группы по умолчанию равен 1 или значению указанному в файле /etc/default/useradd.

-G, --groupsГРУППА1[,ГРУППА2,...[,ГРУППАN]]]
    Список дополнительных групп, в которых числится пользователь. Перечисление групп осуществляется через запятую, без промежуточных пробелов. На указанные группы действуют те же ограничения, что и для группы указанной в параметре -g. По умолчанию пользователь входит только в начальную группу.

-h, --help
    Показать краткую справку и закончить работу.

-m, --create-home
    Если домашнего каталога пользователя не существует, то он будет создан. Файлы из каталога КАТАЛОГ_ШАБЛОН будут скопированы в домашний каталог, если он указан параметр -k, иначе будут использованы файлы из каталога /etc/skel. Все подкаталогикаталога КАТАЛОГ_ШАБЛОН или /etc/skel будут также созданы в домашнем каталоге пользователя. Параметр -k можно использовать только вместе с параметром -m. По умолчанию, домашний каталог не создаётся и файлы не копируются.

-K, --keyКЛЮЧ=ЗНАЧЕНИЕ
    Используется для изменения значений по умолчанию, хранимых в файле /etc/login.defs (UID_MIN, UID_MAX, UMASK, PASS_MAX_DAYS и других). Пример: -K PASS_MAX_DAYS=-1 можно использовать при создании системной учётной записи, чтобы выключить устаревание пароля, даже если системная учётная запись вообще не имеет пароля. Можно указывать параметр -K несколько раз, например: -K UID_MIN=100 -K UID_MAX=499

    Замечание: запись вида -K UID_MIN=10,UID_MAX=499 пока не работает.

-o, --non-unique
    Позволяет создать учётную запись с уже имеющимся (не уникальным) UID.

-p, --passwordПАРОЛЬ
    Шифрованное значение пароля, которое возвращает функция crypt(3). По умолчанию учётная запись заблокирована.

-s, --shellОБОЛОЧКА
    Имя регистрационной оболочки пользователя. Если задать пустое значение, то будет использована регистрационная оболочка по умолчанию.

-u, --uidUID
    Числовое значение идентификатора пользователя (ID). Оно должно быть уникальным, если не используется параметр -o. Значение должно быть неотрицательным. По умолчанию используется наименьшее значение ID большее 999 и большее любого другого значения пользователя. Значения от 0 до 999 обычно зарезервированы для системных учётных записей.

  Изменение значений по умолчанию

При запуске программы с параметром -D команда useradd показывает текущие значения по умолчанию или изменяет их, если указаны дополнительные параметры в командной строке. Допустимые параметры:

-b ДОМАШНИЙ_КАТАЛОГ
    Начальная часть пути нового домашнего каталога пользователя. Имя пользователя будет добавлено в конец ДОМАШНЕГО_КАТАЛОГА для создания имени нового каталога, если не задан параметр -d при создании новой учётной записи.

-e ДАТА_УСТАРЕВАНИЯ
    Дата, когда учётная запись пользователя заблокирована.

-f ДНЕЙ
    Число дней, которые должны пройти после устаревания пароля, перед тем как учётная запись будет заблокирована.

-g, --gidГРУППА
    Имя или числовой идентификатор новой начальной группы пользователя. Группа с таким именем должна существовать и для числового идентификатора должна быть запись.

-s, --shellОБОЛОЧКА
    Имя новой регистрационной оболочки пользователя. Данная программа будет использована для всех новых пользовательских учётных записей.

Если программа запущена без параметров, useradd покажет текущие значения по умолчанию.

ЗАМЕЧАНИЯ

Системный администратор сам решает, какие файлы нужно положить в каталог /etc/skel/.

ПРЕДОСТЕРЕЖЕНИЯ

Нельзя добавить пользователя в NIS группу. Это необходимо делать на NIS сервере.

Также, если имя пользователя уже существует во внешней базе данных такой как NIS, то useradd не станет создавать учётную запись пользователя.

Имена пользователей должны начинаться со строчной буквы или символа подчёркивания, и должны состоять только из строчных букв, символов подчёркивания, тире и знака доллара. Это можно описать регулярным выражением: [a-z_][a-z0-9_-]*[$]

ФАЙЛЫ

/etc/passwd
    содержит информацию о пользователях

/etc/shadow
    содержит защищаемую информацию о пользователях

/etc/group
    содержит информацию о группах

/etc/default/useradd
    содержит защищаемую информацию о пользователях

/etc/skel/
    каталог, содержащий пользовательские файлы по умолчанию

/etc/login.defs
    содержит конфигурацию подсистемы теневых паролей

ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ

Команда useradd завершая работу, возвращает следующие значения:

0   успешное выполнение

1   не удалось изменить файл паролей

2   ошибка в параметрах команды

3   недопустимое значение параметра

4   такой UID уже существует (и не задан параметр -o)

6   указанная группа не существует

9   имя пользователя уже существует

10  не удалось изменить файл групп

12  не удалось создать домашний каталог

13  не удалось создать почтовый ящик

СМОТРИТЕ ТАКЖЕ

chfn(1), chsh(1), passwd(1), crypt(3), groupadd(8), groupdel(8), groupmod(8), login.defs(5), userdel(8), usermod(8).