useradd(8)

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

СИНТАКСИС

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

useradd -D

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

ОПИСАНИЕ

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

ПАРАМЕТРЫ

Возможные параметры команды useradd :

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

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

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

-e, --expiredate EXPIRE_DATE
    Дата, когда учётная запись пользователя будет заблокирована. Дата задаётся в формате ГГГГ-ММ-ДД.

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

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

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

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

-m, --create-home
    Если домашнего каталога пользователя не существует, то он будет создан. Файлы из каталога SKEL_DIR будут скопированы в домашний каталог, если он указан в параметре -k , иначе будут использованы файлы из каталога /etc/skel. Все каталоги, находящиеся в SKEL_DIR или /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, --uid UID
    Числовое значение идентификатора пользователя (ID). Оно должно быть уникальным, если не используется параметр -o. Значение должно быть неотрицательным. По умолчанию используется наименьшее значение ID большее 999 и большее любого другого пользовательского значения. Значения от 0 до 999 обычно зарезервированы для системных учётных записей.

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

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

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

-e EXPIRE_DATE
    Дата, когда учётная запись пользователя заблокирована.

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

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

-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).