227 lines
13 KiB
Groff
227 lines
13 KiB
Groff
.\" Title: useradd
|
||
.\" Author:
|
||
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
|
||
.\" Date: 07/19/2006
|
||
.\" Manual: Команды управления системой
|
||
.\" Source: Команды управления системой
|
||
.\"
|
||
.TH "useradd" "8" "07/19/2006" "Команды управления системой" "Команды управления системой"
|
||
.\" disable hyphenation
|
||
.nh
|
||
.\" disable justification (adjust text to left margin only)
|
||
.ad l
|
||
.SH "НАЗВАНИЕ"
|
||
useradd \- регистрирует нового пользователя или изменяет информацию по умолчанию о новых пользователях
|
||
.SH "СИНТАКСИС"
|
||
.HP 8
|
||
\fBuseradd\fR [\fIпараметры\fR] \fILOGIN\fR
|
||
.HP 8
|
||
\fBuseradd\fR \-D
|
||
.HP 8
|
||
\fBuseradd\fR \-D [\fIпараметры\fR]
|
||
.SH "ОПИСАНИЕ"
|
||
.PP
|
||
При запуске без параметра
|
||
\fB\-D\fR, команда
|
||
\fBuseradd\fR
|
||
создаёт новую учётную запись пользователя, используя значения из командной строки и системные значения по умолчанию. В зависимости от параметров командной строки, команда useradd обновляет системные файлы, а также может создать домашний каталог нового пользователя и скопировать файлы настроек.
|
||
.SH "ПАРАМЕТРЫ"
|
||
.PP
|
||
Параметры команды
|
||
\fBuseradd\fR:
|
||
.TP 3n
|
||
\fB\-c\fR, \fB\-\-comment\fR\fIКОММЕНТАРИЙ\fR
|
||
Любая текстовая строка. Обычно, здесь коротко описывается учётная запись, и в настоящее время используется как поле для имени и фамилии пользователя.
|
||
.TP 3n
|
||
\fB\-b\fR, \fB\-\-base\-dir\fR\fIБАЗОВЫЙ_КАТАЛОГ\fR
|
||
Базовый системный каталог по умолчанию, если другой каталог не указан с помощью параметра
|
||
\fB\-d\fR.
|
||
\fIБАЗОВЫЙ_КАТАЛОГ\fR
|
||
объединяется с именем учётной записи для определения домашнего каталога. Если не используется параметр
|
||
\fB\-m\fR, то
|
||
\fIБАЗОВЫЙ_КАТАЛОГ\fR
|
||
должен существовать.
|
||
.TP 3n
|
||
\fB\-d\fR, \fB\-\-home\fR\fIДОМАШНИЙ_КАТАЛОГ\fR
|
||
Для создаваемого пользователя будет использован каталог
|
||
\fIБАЗОВЫЙ_КАТАЛОГ\fR
|
||
в качестве начального каталога. По умолчанию, это значение получается объединением
|
||
\fIИМЕНИ\fR
|
||
пользователя с
|
||
\fIБАЗОВЫМ_КАТАЛОГОМ\fR
|
||
и используется как имя домашнего каталога. Каталог
|
||
\fIБАЗОВЫЙ_КАТАЛОГ\fR
|
||
необязательно должен существовать и не будет создан, если его нет.
|
||
.TP 3n
|
||
\fB\-e\fR, \fB\-\-expiredate\fR\fIДАТА_УСТАРЕВАНИЯ\fR
|
||
Дата, когда учётная запись пользователя будет заблокирована. Дата задаётся в формате
|
||
\fIГГГГ\-ММ\-ДД\fR.
|
||
.TP 3n
|
||
\fB\-f\fR, \fB\-\-inactive\fR\fIДНЕЙ\fR
|
||
Число дней, которые должны пройти после устаревания пароля, чтобы учётная запись заблокировалась навсегда. Если указано значение 0, то учётная запись блокируется сразу после устаревания пароля, а при значении \-1 данная возможность не используется. По умолчанию используется значение \-1.
|
||
.TP 3n
|
||
\fB\-g\fR, \fB\-\-gid\fR\fIГРУППА\fR
|
||
Имя или числовой идентификатор новой начальной группы пользователя. Группа с таким именем должна существовать. Идентификатор группы должен указывать на уже существующую группу. Идентификатор группы по умолчанию равен 1 или значению указанному в файле
|
||
\fI/etc/default/useradd\fR.
|
||
.TP 3n
|
||
\fB\-G\fR, \fB\-\-groups\fR\fIГРУППА1\fR[\fI,ГРУППА2,...\fR[\fI,ГРУППАN\fR]]]
|
||
Список дополнительных групп, в которых числится пользователь. Перечисление групп осуществляется через запятую, без промежуточных пробелов. На указанные группы действуют те же ограничения, что и для группы указанной в параметре
|
||
\fB\-g\fR. По умолчанию пользователь входит только в начальную группу.
|
||
.TP 3n
|
||
\fB\-h\fR, \fB\-\-help\fR
|
||
Показать краткую справку и закончить работу.
|
||
.TP 3n
|
||
\fB\-m\fR, \fB\-\-create\-home\fR
|
||
Если домашнего каталога пользователя не существует, то он будет создан. Файлы из каталога
|
||
\fIКАТАЛОГ_ШАБЛОН\fR
|
||
будут скопированы в домашний каталог, если он указан параметр
|
||
\fB\-k\fR, иначе будут использованы файлы из каталога
|
||
\fI/etc/skel\fR. Все подкаталоги каталога
|
||
\fIКАТАЛОГ_ШАБЛОН\fR
|
||
или
|
||
\fI/etc/skel\fR
|
||
будут также созданы в домашнем каталоге пользователя. Параметр
|
||
\fB\-k\fR
|
||
можно использовать только вместе с параметром
|
||
\fB\-m\fR. По умолчанию, домашний каталог не создаётся и файлы не копируются.
|
||
.TP 3n
|
||
\fB\-K\fR, \fB\-\-key\fR\fIКЛЮЧ\fR=\fIЗНАЧЕНИЕ\fR
|
||
Используется для изменения значений по умолчанию, хранимых в файле /etc/login.defs (UID_MIN, UID_MAX, UMASK, PASS_MAX_DAYS и других).
|
||
|
||
Пример:
|
||
\fB\-K \fR\fIPASS_MAX_DAYS\fR=\fI\-1\fR
|
||
можно использовать при создании системной учётной записи, чтобы выключить устаревание пароля, даже если системная учётная запись вообще не имеет пароля. Можно указывать параметр
|
||
\fB\-K\fR
|
||
несколько раз, например:
|
||
\fB\-K \fR\fIUID_MIN\fR=\fI100\fR\fB \-K \fR\fIUID_MAX\fR=\fI499\fR
|
||
.sp
|
||
Замечание: запись вида
|
||
\fB\-K \fR\fIUID_MIN\fR=\fI10\fR,\fIUID_MAX\fR=\fI499\fR
|
||
пока не работает.
|
||
.TP 3n
|
||
\fB\-o\fR, \fB\-\-non\-unique\fR
|
||
Позволяет создать учётную запись с уже имеющимся (не уникальным) UID.
|
||
.TP 3n
|
||
\fB\-p\fR, \fB\-\-password\fR\fIПАРОЛЬ\fR
|
||
Шифрованное значение пароля, которое возвращает функция
|
||
\fBcrypt\fR(3). По умолчанию учётная запись заблокирована.
|
||
.TP 3n
|
||
\fB\-s\fR, \fB\-\-shell\fR\fIОБОЛОЧКА\fR
|
||
Имя регистрационной оболочки пользователя. Если задать пустое значение, то будет использована регистрационная оболочка по умолчанию.
|
||
.TP 3n
|
||
\fB\-u\fR, \fB\-\-uid\fR\fIUID\fR
|
||
Числовое значение идентификатора пользователя (ID). Оно должно быть уникальным, если не используется параметр
|
||
\fB\-o\fR. Значение должно быть неотрицательным. По умолчанию используется наименьшее значение ID большее 999 и большее любого другого значения пользователя. Значения от 0 до 999 обычно зарезервированы для системных учётных записей.
|
||
.SS "Изменение значений по умолчанию"
|
||
.PP
|
||
При запуске программы с параметром
|
||
\fB\-D\fR
|
||
команда
|
||
\fBuseradd\fR
|
||
показывает текущие значения по умолчанию или изменяет их, если указаны дополнительные параметры в командной строке. Допустимые параметры:
|
||
.TP 3n
|
||
\fB\-b\fR, \fB\-\-base\-dir\fR\fIБАЗОВЫЙ_КАТАЛОГ\fR
|
||
Начальная часть пути нового домашнего каталога пользователя. Имя пользователя будет добавлено в конец
|
||
\fIДОМАШНЕГО_КАТАЛОГА\fR
|
||
для создания имени нового каталога, если не задан параметр
|
||
\fB\-d\fR
|
||
при создании новой учётной записи.
|
||
.TP 3n
|
||
\fB\-e\fR, \fB\-\-expiredate\fR\fIДАТА_УСТАРЕВАНИЯ\fR
|
||
Дата, когда учётная запись пользователя заблокирована.
|
||
.TP 3n
|
||
\fB\-f\fR, \fB\-\-inactive\fR\fIДНЕЙ\fR
|
||
Число дней, которые должны пройти после устаревания пароля, перед тем как учётная запись будет заблокирована.
|
||
.TP 3n
|
||
\fB\-g\fR, \fB\-\-gid\fR\fIГРУППА\fR
|
||
Имя или числовой идентификатор новой начальной группы пользователя. Группа с таким именем должна существовать и для числового идентификатора должна быть запись.
|
||
.TP 3n
|
||
\fB\-s\fR, \fB\-\-shell\fR\fIОБОЛОЧКА\fR
|
||
Имя новой регистрационной оболочки пользователя. Данная программа будет использована для всех новых пользовательских учётных записей.
|
||
.PP
|
||
Если программа запущена без параметров,
|
||
\fBuseradd\fR
|
||
покажет текущие значения по умолчанию.
|
||
.\" end of SS subsection "Изменение значений по умолчанию"
|
||
.SH "ЗАМЕЧАНИЯ"
|
||
.PP
|
||
Системный администратор сам решает, какие файлы нужно положить в каталог
|
||
\fI/etc/skel/\fR.
|
||
.SH "ПРЕДОСТЕРЕЖЕНИЯ"
|
||
.PP
|
||
Нельзя добавить пользователя в NIS группу. Это необходимо делать на NIS сервере.
|
||
.PP
|
||
Также, если имя пользователя уже существует во внешней базе данных такой как NIS, то
|
||
\fBuseradd\fR
|
||
не станет создавать учётную запись пользователя.
|
||
.PP
|
||
Имена пользователей должны начинаться со строчной буквы или символа подчёркивания, и должны состоять только из строчных букв, символов подчёркивания, тире и знака доллара. Это можно описать регулярным выражением: [a\-z_][a\-z0\-9_\-]*[$]
|
||
.SH "ФАЙЛЫ"
|
||
.TP 3n
|
||
\fI/etc/passwd\fR
|
||
содержит информацию о пользователях
|
||
.TP 3n
|
||
\fI/etc/shadow\fR
|
||
содержит защищаемую информацию о пользователях
|
||
.TP 3n
|
||
\fI/etc/group\fR
|
||
содержит информацию о группах
|
||
.TP 3n
|
||
\fI/etc/default/useradd\fR
|
||
содержит защищаемую информацию о пользователях
|
||
.TP 3n
|
||
\fI/etc/skel/\fR
|
||
каталог, содержащий пользовательские файлы по умолчанию
|
||
.TP 3n
|
||
\fI/etc/login.defs\fR
|
||
содержит конфигурацию подсистемы теневых паролей
|
||
.SH "ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ"
|
||
.PP
|
||
Команда
|
||
\fBuseradd\fR
|
||
завершая работу, возвращает следующие значения:
|
||
.TP 3n
|
||
\fI0\fR
|
||
успешное выполнение
|
||
.TP 3n
|
||
\fI1\fR
|
||
не удалось изменить файл паролей
|
||
.TP 3n
|
||
\fI2\fR
|
||
ошибка в параметрах команды
|
||
.TP 3n
|
||
\fI3\fR
|
||
недопустимое значение параметра
|
||
.TP 3n
|
||
\fI4\fR
|
||
такой UID уже существует (и не задан параметр
|
||
\fB\-o\fR)
|
||
.TP 3n
|
||
\fI6\fR
|
||
указанная группа не существует
|
||
.TP 3n
|
||
\fI9\fR
|
||
имя пользователя уже существует
|
||
.TP 3n
|
||
\fI10\fR
|
||
не удалось изменить файл групп
|
||
.TP 3n
|
||
\fI12\fR
|
||
не удалось создать домашний каталог
|
||
.TP 3n
|
||
\fI13\fR
|
||
не удалось создать почтовый ящик
|
||
.SH "СМОТРИТЕ ТАКЖЕ"
|
||
.PP
|
||
\fBchfn\fR(1),
|
||
\fBchsh\fR(1),
|
||
\fBpasswd\fR(1),
|
||
\fBcrypt\fR(3),
|
||
\fBgroupadd\fR(8),
|
||
\fBgroupdel\fR(8),
|
||
\fBgroupmod\fR(8),
|
||
\fBlogin.defs\fR(5),
|
||
\fBnewusers\fR(8),
|
||
\fBuserdel\fR(8),
|
||
\fBusermod\fR(8).
|