НАЗВА

groupadd - створення нової групи

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

groupadd [ ПАРАМЕТРИ] НОВА_ГРУПА

ОПИС

Команда groupadd створює обліковий запис групи з використанням значень, які вказано у командному рядку, і типових для системи значень. Запис нової групи буде додано до файлів системи, якщо у цьому буде потреба.
Groupnames 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 groupname. Fully numeric groupnames and groupnames . or .. are also disallowed.
On Debian, the only constraints are that groupnames 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.).
Довжина назв груп не може перевищувати 32 символи.

ПАРАМЕТРИ

Параметри, які застосовують до команди groupadd, є такими:
-f, --force
Використання цього параметра призведе до простого виходу з команди зі станом успіху, якщо вказана група вже існує. Якщо використано разом із -g, і вказаний GID вже існує, буде вибрано інший (унікальний) GID (тобто буде вимкнено -g).
-g, --gid GID
Числове значення ідентифікатора групи. GID має бути унікальним, якщо не використано параметр -o. Значення має бути невід'ємним. Типовим є використання найменшого значення ідентифікатора, яке дорівнює або перевищує МІНІМАЛЬНИЙ_GID і є більшим за значення ідентифікатора будь-якої іншої групи.
 
Див. також описи параметрів -r і МАКСИМАЛЬНИЙ_GID.
-h, --help
Показати довідкове повідомлення і завершити роботу.
-K, --key КЛЮЧ=ЗНАЧЕННЯ
Має пріоритет над типовими значенням у /etc/login.defs (GID_MIN, GID_MAX та іншими). Може бути вказано декілька параметрів -K.
 
Приклад: -K МІНІМАЛЬНИЙ_GID= 100 -K МАКСИМАЛЬНИЙ_GID= 499
 
Зауваження: -K МІНІМАЛЬНИЙ_GID= 10,МАКСИМАЛЬНИЙ_GID=499 ще не працює.
-o, --non-unique
уможливлює створення груп із вже використаним числовим ідентифікатором. У результаті для цього GID прив'язка до групи НОВА_ГРУПА може бути неунікальною.
-p, --password ПАРОЛЬ
визначає початковий пароль до облікового запису групи. ПАРОЛЬ має бути зашифровано у форматі, який повертає crypt(3).
 
Без цього параметра обліковий запис групи буде заблоковано; для нього також не буде визначено пароля, тобто у відповідному полі файла облікових записів системи /etc/group або /etc/gshadow буде вказано одинарний знак оклику.
 
Зауваження: не рекомендуємо користуватися цим параметром, оскільки пароль (або шифрований пароль) буде видимим для користувачів, які мають доступ до списку процесів.
 
Вам слід переконатися, що пароль відповідає правилам складання паролів системи.
-r, --system
Створити загальносистемну групу.
 
Числові ідентифікатори нових груп системи буде вибрано у діапазоні SYS_GID_MIN- SYS_GID_MAX range, defined in login.defs, замість діапазону МІНІМАЛЬНИЙ_GID- МАКСИМАЛЬНИЙ_GID.
-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 не передбачено.
-U, --users
Список імен користувачів, яких слід додати як учасників групи.
 
Типову поведінку (якщо не вказано параметрів -g, -N і -U) буде визначено змінною USERGROUPS_ENAB у /etc/login.defs.

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

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

ФАЙЛИ

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

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

Не можна додавати групи NIS або LDAP. Для таких груп цю дію має бути виконано на відповідному сервері.
Якщо назва групи вже існує у зовнішній базі даних груп, зокрема NIS або LDAP, groupadd відмовить у запиті щодо створення групи.

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

Команда groupadd завершує роботу із такими значеннями:
0
успіх
2
некоректний синтаксис команди
3
некоректний аргумент параметра
4
GID вже використано (якщо викликано без -o)
9
назву групи вже використано
10
не вдалося оновити файл груп

ДИВ. ТАКОЖ

chfn(1), chsh(1), passwd(1), gpasswd(8), groupdel(8), groupmod(8), login.defs(5), useradd(8), userdel(8), usermod(8).

Recommended readings

Pages related to groupadd you should read also: