113 lines
4.7 KiB
Groff
113 lines
4.7 KiB
Groff
.\" Title: groupadd
|
||
.\" Author:
|
||
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
|
||
.\" Date: 06/24/2006
|
||
.\" Manual: Команды управления системой
|
||
.\" Source: Команды управления системой
|
||
.\"
|
||
.TH "groupadd" "8" "06/24/2006" "Команды управления системой" "Команды управления системой"
|
||
.\" disable hyphenation
|
||
.nh
|
||
.\" disable justification (adjust text to left margin only)
|
||
.ad l
|
||
.SH "НАЗВАНИЕ"
|
||
groupadd \- создаёт новую группу
|
||
.SH "СИНТАКСИС"
|
||
.HP 9
|
||
\fBgroupadd\fR [\-g\ \fIGID\fR\ [\-o]] [\-f] [\-K\ \fIКЛЮЧ\fR=\fIЗНАЧЕНИЕ\fR] \fIгруппа\fR
|
||
.SH "ОПИСАНИЕ"
|
||
.PP
|
||
Программа
|
||
\fBgroupadd\fR
|
||
создаёт новую группу, согласно указанным значениям командной строки и системным значениям по умолчанию. Новая группа будет добавлена в системные файлы.
|
||
.SH "ПАРАМЕТРЫ"
|
||
.PP
|
||
Параметры команды
|
||
\fBgroupadd\fR:
|
||
.TP 3n
|
||
\fB\-f\fR
|
||
Вернуть статус успешного выполнения, если группа уже существует. Если используется вместе с параметром
|
||
\fB\-g\fR
|
||
и указанный GID уже существует, то выбирается другой (уникальный) GID (то есть параметр
|
||
\fB\-g\fR
|
||
игнорируется).
|
||
.TP 3n
|
||
\fB\-g\fR \fIGID\fR
|
||
Числовое значение идентификатора группы. Значение должно быть уникальным, если не задан параметр
|
||
\fB\-o\fR. Значение должно быть не отрицательным.По умолчанию, берётся значение больше 999 и больше идентификатора любой другой группы. Значения от 0 и до 999 обычно зарезервированы под системные группы.
|
||
.TP 3n
|
||
\fB\-h\fR, \fB\-\-help\fR
|
||
Показать краткую справку и закончить работу.
|
||
.TP 3n
|
||
\fB\-K \fR\fB\fIКЛЮЧ\fR\fR\fB=\fR\fB\fIЗНАЧЕНИЕ\fR\fR
|
||
Изменить значения по умолчанию (GID_MIN, GID_MAX и другие), которые хранятся в файле
|
||
\fI/etc/login.defs\fR. Можно указать несколько параметров
|
||
\fB\-K\fR.
|
||
.sp
|
||
Пример:
|
||
\fB\-K \fR\fIGID_MIN\fR=\fI100\fR\fB \-K \fR\fIGID_MAX\fR=\fI499\fR
|
||
.sp
|
||
Замечание: запись вида
|
||
\fB\-K \fR\fIGID_MIN\fR=\fI10\fR,\fIGID_MAX\fR=\fI499\fR
|
||
пока не работает.
|
||
.TP 3n
|
||
\fB\-o\fR
|
||
Разрешить добавление группы с не уникальным GID.
|
||
.SH "ФАЙЛЫ"
|
||
.TP 3n
|
||
\fI/etc/group\fR
|
||
содержит информацию о группах
|
||
.TP 3n
|
||
\fI/etc/gshadow\fR
|
||
содержит защищаемую информацию о группах
|
||
.TP 3n
|
||
\fI/etc/login.defs\fR
|
||
содержит конфигурацию подсистемы теневых паролей
|
||
.SH "ПРЕДОСТЕРЕЖЕНИЯ"
|
||
.PP
|
||
Имена групп должны начинаться со строчной буквы или символа подчёркивания. Они могут содержать только строчные буквы, символ подчёркивания, тире и знак доллара. Это можно описать регулярным выражением: [a\-z_][a\-z0\-9_\-]*[$]
|
||
.PP
|
||
Имена групп могут быть длиной не более 16 знаков.
|
||
.PP
|
||
Если имя группы уже существует во внешней базе данных групп, например в NIS, то
|
||
\fBgroupadd\fR
|
||
не станет создавать группу.
|
||
.PP
|
||
Имена групп могут быть длиной не более 16 знаков.
|
||
.SH "ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ"
|
||
.PP
|
||
Программа
|
||
\fBgroupadd\fR
|
||
завершая работу, возвращает следующие значения:
|
||
.TP 3n
|
||
\fI0\fR
|
||
успешное выполнение
|
||
.TP 3n
|
||
\fI2\fR
|
||
ошибка в параметрах команды
|
||
.TP 3n
|
||
\fI3\fR
|
||
недопустимое значение параметра
|
||
.TP 3n
|
||
\fI4\fR
|
||
не уникальный gid (если не задан параметр
|
||
\fB\-o\fR)
|
||
.TP 3n
|
||
\fI9\fR
|
||
не уникальное имя группы
|
||
.TP 3n
|
||
\fI10\fR
|
||
не удалось изменить файл групп
|
||
.SH "СМОТРИТЕ ТАКЖЕ"
|
||
.PP
|
||
\fBchfn\fR(1),
|
||
\fBchsh\fR(1),
|
||
\fBpasswd\fR(1),
|
||
\fBgpasswd\fR(8),
|
||
\fBgroupdel\fR(8),
|
||
\fBgroupmod\fR(8),
|
||
\fBlogin.defs\fR(5),
|
||
\fBuseradd\fR(8),
|
||
\fBuserdel\fR(8),
|
||
\fBusermod\fR(8).
|