НАЗВА

       useradd - створення запису користувача або оновлення відомостей щодо типового нового
       користувача

КОРОТКИЙ ОГЛЯД

       useradd [параметри] ЗАПИС

       useradd -D

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

ОПИС

       useradd is a low level utility for adding users. On Debian, administrators should usually
       use adduser(8) instead.

       Якщо програму викликано без параметра -D, команда useradd створити обліковий запис
       користувача з використанням значень, які вказано у рядку команди, і значень, які є
       типовими для системи. Залежно від параметрів рядка команди, команда useradd оновить файли
       системи і також може створити домашній каталог нового користувача і скопіювати туди
       початкові файли.

       Типово, для нового користувача також буде створено його власну групу (див.  -g, -N, -U і
       USERGROUPS_ENAB).

ПАРАМЕТРИ

       Параметри, які застосовують до команди useradd, є такими:

       --badname
           Дозволити назви, які не відповідають стандартам.

       -b, --base-dir БАЗОВИЙ_КАТАЛОГ
           Типовий базовий каталог для системи, якщо не вказано -d ДОМАШНІЙ_КАТАЛОГ. Для
           визначення домашнього каталогу БАЗОВИЙ_КАТАЛОГ буде поєднано із назвою облікового
           запису.

           Якщо цей параметр не вказано, useradd використає базовий каталог, який вказано змінною
           HOME у /etc/default/useradd, або типовий каталог /home.

       -c, --comment КОМЕНТАР
           Будь-який рядок тексту. Зазвичай, це короткий опис облікового запису. У поточній
           версії використано як поле для повного імені користувача.

       -d, --home-dir ДОМАШНІЙ_КАТАЛОГ
           Новий запис користувача буде створено з використанням ДОМАШНІЙ_КАТАЛОГ, як значення
           для каталогу входу до системи користувача. Типовим значенням є дописування імені ЗАПИС
           до БАЗОВИЙ_КАТАЛОГ і використання результату як назви каталогу облікового запису. Якщо
           каталогу ДОМАШНІЙ_КАТАЛОГ не існує, його буде створено, якщо не вказано параметр -M.

       -D, --defaults
           Див. нижче, підрозділ «Зміна типових значень».

       -e, --expiredate ДАТА_ЗАВЕРШЕННЯ_СТРОКУ_ДІЇ
           Дата, у яку буде вимкнено обліковий запис користувача. Дату вказують у форматі
           РРРР-ММ-ДД.

           Якщо не вказано, useradd використає типову дату строку дії, який вказано змінною
           EXPIRE у /etc/default/useradd, або типовий порожній рядок (необмежений строк дії).

       -f, --inactive НЕАКТИВНИЙ
           Визначає кількість днів після перевищення паролем максимального віку, протягом яких
           система очікуватиме на заміну пароля користувачем. Значення зберігається у файлі
           паролів shadow. Вхідне значення 0 вимкне пароль, строк дії якого вичерпано, без
           затримки. Вхідне значення -1 призведе до вилучення відповідного поля у файлі паролів
           shadow. Див.  shadow(5), щоб дізнатися більше.

           Якщо не вказано, useradd використає типовий період неактивності, який вказано змінною
           НЕАКТИВНИЙ у /etc/default/useradd, або типове значення -1.

       -F, --add-subids-for-system
           Update /etc/subuid and /etc/subgid even when creating a system account with -r option.

       -g, --gid GROUP
           Назва або номер основної групи користувача. Відповідна група має існувати. Номер групи
           має вказувати на вже наявну групу.

           If not specified, the behavior of useradd will depend on the USERGROUPS_ENAB variable
           in /etc/login.defs. If this variable is set to yes (or -U/--user-group is specified on
           the command line), a group will be created for the user, with the same name as her
           loginname. If the variable is set to no (or -N/--no-user-group is specified on the
           command line), useradd will set the primary group of the new user to the value
           specified by the GROUP variable in /etc/default/useradd, or 100 by default.

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

       -h, --help
           Показати довідкове повідомлення і завершити роботу.

       -k, --skel SKEL_DIR
           Каркасний каталог, який містить файли і каталоги, які буде скопійовано до домашнього
           каталогу користувача, коли такий домашній каталог створюється командою useradd.

           Цей параметр є чинним, лише якщо вказано параметр -m (або --create-home).

           Якщо не вказано цей параметр, каталог каркасних даних буде визначено змінною SKEL у
           /etc/default/useradd або, типово, /etc/skel.

           Якщо можна, буде скопійовано ACL і розширені атрибути.

       -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

           For the compatibility with previous Debian's useradd, the -O option is also supported.

       -l, --no-log-init
           Не додавати користувача до баз даних lastlog і faillog.

           Типово, записи користувачів у базах даних lastlog і faillog буде скинуто до початкових
           даних, щоб уникнути повторного використання записів, які лишилися від раніше вилучених
           користувачів.

           Якщо не вказано цей параметр, useradd також врахує значення змінної LOG_INIT у
           /etc/default/useradd, якщо для неї встановлено значення no, запис користувача не буде
           додано до баз даних lastlog і faillog.

       -m, --create-home
           Створити домашній каталог користувача, якщо такого ще не існує. До такого домашнього
           каталогу буде скопійовано файли і каталоги з каркасного каталогу (який можна визначити
           за допомогою параметра -k).

           Типово, якщо цей параметр не вказано і не увімкнено CREATE_HOME, програма не
           створюватиме домашніх каталогів.

           Каталог, де буде створено домашній каталог користувача, має існувати і мати належний
           контекст SELinux і права доступу. Якщо ці умови не буде виконано, програма не зможе
           створити домашній каталог користувача або створений каталог буде недоступним.

       -M, --no-create-home
           Do not create the user's home directory, even if the system wide setting from
           /etc/login.defs (CREATE_HOME) is set to yes.

       -N, --no-user-group
           Не створювати групи, назва якої збігається із назвою облікового запису користувача, а
           додати користувача до групи, яку вказано параметром -g або змінною GROUP у
           /etc/default/useradd.

           Типову поведінку (якщо не вказано параметрів -g, -N і -U) буде визначено змінною
           USERGROUPS_ENAB у /etc/login.defs.

       -o, --non-unique
           Дозволяє створення облікового запису із наявним UID.

           Цей параметр можна використовувати лише у поєднанні із параметром -u. Оскільки профіль
           користувача слугує ключем для прив'язки користувачів до прав доступу, прав власності
           на файли та інших аспектів загальносистемної поведінки, доступ до облікового запису із
           заданим UID матимуть декілька облікових записів для входу до системи.

       -p, --password ПАРОЛЬ
           визначає початковий пароль до облікового запису. ПАРОЛЬ має бути зашифровано у
           форматі, який повертає crypt(3). У скрипті оболонки цей параметр надає змогу ефективно
           створювати записи користувачів у пакетному режимі.

           Без цього параметра новий обліковий запис буде заблоковано; для нього також не буде
           визначено пароля, тобто у відповідному полі файла /etc/shadow. Це стан, у якому
           користувач не зможе отримати доступ до облікового запису або визначити пароль
           власноруч.

           Зауваження: не рекомендуємо користуватися цим параметром у командному рядку, оскільки
           пароль (або шифрований пароль) буде видимим для користувачів, які мають доступ до
           списку процесів.

           Вам слід переконатися, що пароль відповідає правилам складання паролів системи.

       -r, --system
           Створити загальносистемний обліковий запис.

           Записи загальносистемних користувачів буде створено без даних щодо застарівання у
           /etc/shadow, а їхні числові ідентифікатори буде вибрано у діапазоні
           SYS_UID_MIN-SYS_UID_MAX, який визначено у /etc/login.defs, а не у UID_MIN-UID_MAX (та
           їхніх відповідників GID для створення груп).

           Зауважте, що useradd не створюватиме домашнього каталогу для такого користувача,
           незалежно від того, яким є типове значення параметра у /etc/login.defs (CREATE_HOME).
           вам слід вказати параметри -m, якщо ви хочете, щоб для загальносистемного облікового
           запису було створено домашній каталог.

           Note that this option will not update /etc/subuid and /etc/subgid. You have to specify
           the -F options if you want to update the files for a system account to be created.

       -R, --root КАТАЛОГ_CHROOT
           Apply changes in the CHROOT_DIR directory and use the configuration files from the
           CHROOT_DIR directory. Only absolute paths are supported.

       -P, --prefix КАТАЛОГ_ПРЕФІКСА
           Застосувати зміни до файлів налаштувань у кореневій файловій системі з каталогу
           КАТАЛОГ_ПРЕФІКСА. Використання цього параметра не змінює кореневої теки. Параметр
           призначено лише для приготування цілі для компіляції коду для іншої операційної
           системи. Обмеження: не буде виконано перевірку користувачів/груп NIS і LDAP. При
           розпізнаванні у PAM буде використано файли основної системи. Підтримки SELINUX не
           передбачено.

       -s, --shell ОБОЛОНКА
           sets the path to the user's login shell. Without this option, the system will use the
           SHELL variable specified in /etc/default/useradd, or, if that is as well not set, the
           field for the login shell in /etc/passwd remains empty.

       -u, --uid UID
           Числове значення ідентифікатора користувача. Це значення має бути унікальним, якщо не
           використано параметр -o. Значення має бути невід'ємним. Типово, буде використано
           найменше значення ідентифікатора, яке перевищує або дорівнює значенню UID_MIN і є
           більшим за значення для будь-якого іншого користувача.

           Див. також описи параметрів -r і UID_MAX.

       -U, --user-group
           Створити групу, назва якої збігається із назвою облікового запису користувача, додати
           користувача до цієї групи.

           Типову поведінку (якщо не вказано параметрів -g, -N і -U) буде визначено змінною
           USERGROUPS_ENAB у /etc/login.defs.

       -Z, --selinux-user SEКОРИСТУВАЧ
           Визначає користувача SELinux для нового облікового запису. Без цього параметра,
           SELinux використає типового користувача. Зауважте, що система shadow не зберігає
           користувача selinux — для цього вона використовує semanage(8).

   Зміна типових значень
       Якщо програму викликано лише з параметром -D, useradd виведе поточні типові значення. Якщо
       виклик відбувся з параметром -D та іншими параметрами, useradd оновить типові значення для
       вказаних параметрів. Коректними параметрами для зміни типових значень є такі:

       -b, --base-dir БАЗОВИЙ_КАТАЛОГ
           Встановлює префікс шляху для домашнього каталогу нового користувача. Назву облікового
           запису користувача буде дописано наприкінці БАЗОВИЙ_КАТАЛОГ для створення назви
           домашнього каталогу нового користувача, якщо під час створення облікового запису не
           було використано параметр -d.

           Цей параметр встановлює значення змінної HOME у /etc/default/useradd.

       -e, --expiredate ДАТА_ЗАВЕРШЕННЯ_СТРОКУ_ДІЇ
           Встановлює дату вимикання новостворених облікових записів користувачів.

           Цей параметр встановлює значення змінної EXPIRE у /etc/default/useradd.

       -f, --inactive НЕАКТИВНИЙ
           Визначає кількість днів після перевищення паролем максимального віку, протягом яких
           система очікуватиме на заміну пароля користувачем. Див.  shadow(5), щоб дізнатися
           більше.

           Цей параметр встановлює значення змінної НЕАКТИВНИЙ у /etc/default/useradd.

       -g, --gid GROUP
           Встановлює типову основну групу для новостворених записів користувачів. Можна вказати
           назву групи або числовий ідентифікатор групи. Вказана за назвою група має існувати, а
           GID має бути наявним записом.

           Цей параметр встановлює значення змінної GROUP у /etc/default/useradd.

       -s, --shell ОБОЛОНКА
           Визначає типову оболонку входу для нових користувачів.

           Цей параметр встановлює значення змінної ОБОЛОНКА у /etc/default/useradd.

ПРИМІТКИ

       За розташування типових файлів користувача у каталозі /etc/skel/ (або будь-якому іншому
       каркасному каталозі, який вказано у /etc/default/useradd або рядку команди) відповідає
       адміністратор системи.

ЗАСТЕРЕЖЕННЯ

       Не можна додавати користувача до групи NIS або LDAP. Для таких груп цю дію має бути
       виконано на відповідному сервері.

       Так само, якщо ім'я користувача вже існує у зовнішній базі даних користувачів, зокрема NIS
       або LDAP, useradd відмовить у запиті щодо створення облікового запису користувача.

       Usernames may contain only lower and upper case letters, digits, underscores, or dashes.
       They can end with a dollar sign. Dashes are not allowed at the beginning of the username.
       Fully numeric usernames and usernames . or .. are also disallowed. It is not recommended
       to use usernames beginning with . character as their home directories will be hidden in
       the ls output.

       On Debian, the only constraints are that usernames must neither start with a dash ('-')
       nor plus ('+') nor tilde ('~') nor contain a colon (':'), a comma (','), or a whitespace
       (space: ' ', end of line: '\n', tabulation: '\t', etc.). Note that using a slash ('/') may
       break the default algorithm for the definition of the user's home directory.

       On Ubuntu, the same constraints as Debian are in place, with the additional constraint
       that the username cannot be fully numeric. This includes octal and hexadecimal syntax.

       Довжина імен користувачів не може перевищувати 32 символи.

НАЛАШТУВАННЯ

       Вказані нижче змінні налаштувань у /etc/login.defs змінюють поведінку цього інструмента:

ФАЙЛИ

       /etc/passwd
           Відомості щодо облікових записів користувача.

       /etc/shadow
           Відомості щодо захищених облікових записів користувачів.

       /etc/group
           Відомості щодо груп облікових записів.

       /etc/gshadow
           Відомості щодо захищених груп облікових записів.

       /etc/default/useradd
           Типові значення для створення облікового запису.

       /etc/shadow-maint/useradd-pre.d/*, /etc/shadow-maint/useradd-post.d/*
           Файли, які буде виконано під час додавання запису користувача. Змінну середовища
           ACTION буде заповнено командою useradd, а змінну середовища SUBJECT — користувач.
           Перед додаванням запису користувача буде виконано useradd-pre.d. Після додавання
           запису користувача буде виконано useradd-post.d. Якщо станом виходу зі скрипту буде
           ненульове значення, виконання дій буде перервано.

       /etc/skel/
           Каталог, у якому містяться типові файли.

       /etc/subgid
           Окремі для користувачів ідентифікатори підлеглих груп.

       /etc/subuid
           Окремі для користувачів ідентифікатори підлеглих користувачів.

       /etc/login.defs
           Налаштування комплексу для роботи з прихованими паролями.

ЗНАЧЕННЯ ВИХОДУ

       Команда useradd завершує роботу із такими значеннями:

       0
           успіх

       1
           не вдалося оновити файл паролів

       2
           некоректний синтаксис команди

       3
           некоректний аргумент параметра

       4
           UID вже використано (і не вказано -o)

       6
           вказаної групи не існує

       9
           username or group name already in use

       10
           не вдалося оновити файл груп

       12
           не вдалося створити домашній каталог

       14
           не вдалося оновити прив'язку користувача SELinux

ДИВ. ТАКОЖ

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