summaryrefslogtreecommitdiff
path: root/man/ru/man3/shadow.3
diff options
context:
space:
mode:
Diffstat (limited to 'man/ru/man3/shadow.3')
-rw-r--r--man/ru/man3/shadow.377
1 files changed, 40 insertions, 37 deletions
diff --git a/man/ru/man3/shadow.3 b/man/ru/man3/shadow.3
index 6b720266..15598cb6 100644
--- a/man/ru/man3/shadow.3
+++ b/man/ru/man3/shadow.3
@@ -2,12 +2,12 @@
.\" Title: shadow
.\" Author: Julianne Frances Haugh
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\" Date: 06/13/2019
+.\" Date: 12/01/2019
.\" Manual: Библиотечные функции
-.\" Source: shadow-utils 4.7
+.\" Source: shadow-utils 4.8
.\" Language: Russian
.\"
-.TH "shadow" "3" "06/13/2019" "shadow\-utils 4\&.7" "Библиотечные функции"
+.TH "shadow" "3" "12/01/2019" "shadow\-utils 4\&.8" "Библиотечные функции"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -59,25 +59,27 @@ shadow, getspnam \- процедуры для работы с файлом ши
.SH "ОПИСАНИЕ"
.PP
\fIshadow\fR
-управляет содержимым файла теневых паролей,
-/etc/shadow\&. Структура в файле
-\fI#include\fR:
+manipulates the contents of the shadow password file,
+/etc/shadow\&. The structure in the
+\fI#include\fR
+file is:
.sp
.if n \{\
.RS 4
.\}
.nf
struct spwd {
- char *sp_namp; /* имя пользователя */
- char *sp_pwdp; /* шифрованный пароль */
- long int sp_lstchg; /* дата последней смены пароля */
- long int sp_min; /* дней должно пройти между сменами пароля\&. */
- long int sp_max; /* дней перед необходимостью смены пароля */
- long int sp_warn; /* дней вывода предупреждения об устаревании */
- long int sp_inact; /* дней перед тем как учётная запись заблокируется */
- long int sp_expire; /* дата устаревания учётной записи */
- unsigned long int sp_flag; /* зарезервировано */
+ char *sp_namp; /* user login name */
+ char *sp_pwdp; /* encrypted password */
+ long int sp_lstchg; /* last password change */
+ long int sp_min; /* days until change allowed\&. */
+ long int sp_max; /* days before change required */
+ long int sp_warn; /* days warning for expiration */
+ long int sp_inact; /* days before account inactive */
+ long int sp_expire; /* date when account expires */
+ unsigned long int sp_flag; /* reserved for future use */
}
+
.fi
.if n \{\
.RE
@@ -185,48 +187,49 @@ sp_flag \- зарезервировано
.RE
.SH "ОПИСАНИЕ"
.PP
-Функции
\fIgetspent\fR,
\fIgetspname\fR,
-\fIfgetspent\fR
+\fIfgetspent\fR, and
\fIsgetspent\fR
-возвращают указатель на структуру
+each return a pointer to a
\fIstruct spwd\fR\&.
\fIgetspent\fR
-возвращает следующую запись из файла, а
+returns the next entry from the file, and
\fIfgetspent\fR
-возвращает следующую запись из заданного канала, предполагая, что это файл правильного формата\&.\fIsgetspent\fR
-возвращает указатель на
-\fIstruct spwd\fR, используя предоставленную строку в качестве входящих данных\&.
+returns the next entry from the given stream, which is assumed to be a file of the proper format\&.
+\fIsgetspent\fR
+returns a pointer to a
+\fIstruct spwd\fR
+using the provided string as input\&.
\fIgetspnam\fR
-ищет начиная с текущей позиции в файле запись по имени
+searches from the current position in the file for an entry matching
\fIname\fR\&.
.PP
-Функции
\fIsetspent\fR
+and
\fIendspent\fR
-можно использовать для перемещения в начало и конец файла теневых паролей соответственно\&.
+may be used to begin and end, respectively, access to the shadow password file\&.
.PP
-Функции
+The
\fIlckpwdf\fR
+and
\fIulckpwdf\fR
-используются для получения монопольного доступа к файлу
-/etc/shadow\&.
+routines should be used to insure exclusive access to the
+/etc/shadow
+file\&.
\fIlckpwdf\fR
-пытается выполнить блокировку с помощью
+attempts to acquire a lock using
\fIpw_lock\fR
-в течении 15 секунд\&. Далее выполняется попытка получить вторую блокировку с помощью
+for up to 15 seconds\&. It continues by attempting to acquire a second lock using
\fIspw_lock\fR
-в течении времени оставшегося от первоначальных 15 секунд\&. При неудаче в любой из блокировок в течении 15 секунд, функция
+for the remainder of the initial 15 seconds\&. Should either attempt fail after a total of 15 seconds,
\fIlckpwdf\fR
-возвращает \-1\&. Если обе блокировки прошли успешно возвращается 0\&.
+returns \-1\&. When both locks are acquired 0 is returned\&.
.SH "ДИАГНОСТИКА"
.PP
-Функции возвращают NULL, если все записи кончились или произошла ошибка во время работы\&. Функции, возвращающие
-\fIint\fR, возвращают 0 при успешном выполнении и \-1 в случае неудачи\&.
+Routines return NULL if no more entries are available or if an error occurs during processing\&. Routines which have
+\fIint\fR
+as the return value return 0 for success and \-1 for failure\&.
.SH "ПРЕДОСТЕРЕЖЕНИЯ"
.PP
Данные функции могут использоваться только суперпользователем, так как доступ к файлу теневых паролей ограничен\&.