man linux — заметки админа

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, --uid

UID
Числовое значение идентификатора пользователя (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).

Примечание:
Добавить существующего пользователя user в группу www-data:

usermod -a -G www-data user

Изменить пользователю user основную группу на www-data:

usermod -g www-data user