From 97c26c1924b076ef23ebe4381558e8aa025712b2 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 16:54:37 +0200 Subject: Adding upstream version 1:4.13+dfsg1. Signed-off-by: Daniel Baumann --- man/uk/man3/shadow.3 | 231 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 231 insertions(+) create mode 100644 man/uk/man3/shadow.3 (limited to 'man/uk/man3/shadow.3') diff --git a/man/uk/man3/shadow.3 b/man/uk/man3/shadow.3 new file mode 100644 index 0000000..3cb5513 --- /dev/null +++ b/man/uk/man3/shadow.3 @@ -0,0 +1,231 @@ +'\" t +.\" Title: shadow +.\" Author: Julianne Frances Haugh +.\" Generator: DocBook XSL Stylesheets vsnapshot +.\" Date: 08/11/2022 +.\" Manual: Виклики бібліотеки +.\" Source: shadow-utils 4.13 +.\" Language: Ukrainian +.\" +.TH "shadow" "3" "08/11/2022" "shadow\-utils 4\&.13" "Виклики бібліотеки" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "НАЗВА" +shadow, getspnam \- підпрограми для файла зашифрованих паролів +.SH "СИНТАКСИС" +.PP +\fI#include \fR +.PP +\fIstruct spwd *getspent();\fR +.PP +\fIstruct spwd *getspnam(char\fR +\fI*name\fR\fI);\fR +.PP +\fIvoid setspent();\fR +.PP +\fIvoid endspent();\fR +.PP +\fIstruct spwd *fgetspent(FILE\fR +\fI*fp\fR\fI);\fR +.PP +\fIstruct spwd *sgetspent(char\fR +\fI*cp\fR\fI);\fR +.PP +\fIint putspent(struct spwd\fR +\fI*p,\fR +\fIФАЙЛ\fR +\fI*fp\fR\fI);\fR +.PP +\fIint lckpwdf();\fR +.PP +\fIint ulckpwdf();\fR +.SH "ОПИС" +.PP +\fIshadow\fR +керує вмістом файла прихованих паролів, +/etc/shadow\&. Структура файла +\fI#include\fR: +.sp +.if n \{\ +.RS 4 +.\} +.nf +struct spwd { char *sp_namp; /* ім\*(Aqя користувача для входу */ 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; /* зарезервовано для використання у майбутньому */ } +.fi +.if n \{\ +.RE +.\} +.PP +Призначення кожного з полів: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_namp \- вказівник на ім\*(Aqя користувача із кінцевим нуль\-символом +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_pwdp \- вказівник на пароль із кінцевим нуль\-символом +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_lstchg \- час у днях з 1 січня 1970 року, коли пароль було востаннє змінено +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_min \- кількість днів з останньої зміни, коли пароль не може бути змінено +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_max \- кількість днів з останньої зміни, після яких пароль має бути змінено +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_warn \- дні від моменту, коли строк дії пароля буде вичерпано, коли користувач отримуватиме попередження щодо майбутнього завершення строку дії пароля +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_inact \- кількість днів між завершенням строку дії і вимиканням облікового запису +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_expire \- кількість днів з 1 січня 1970 року, яка визначає момент вимикання облікового запису +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +sp_flag \- зарезервовано для використання у майбутньому +.RE +.SH "ОПИС" +.PP +\fIgetspent\fR, +\fIgetspname\fR, +\fIfgetspent\fR +і +\fIsgetspent\fR +усі повертають вказівник на +\fIstruct spwd\fR\&. +\fIgetspent\fR +повертає наступний запис з файла, а +\fIfgetspent\fR +повертає наступний запис з заданого потоку даних, яким має бути файл у належному форматі\&. +\fIsgetspent\fR +повертає вказівник на +\fIstruct spwd\fR, використовуючи вхідні дані з наданого рядок\&. +\fIgetspnam\fR +шукає з поточної позиції у файлів запис, що відповідає рядку +\fIname\fR\&. +.PP +\fIsetspent\fR +і +\fIendspent\fR +можна скористатися для того, щоб відкрити або закрити, відповідно, доступ до файла прихованих паролів\&. +.PP +Підпрограмами +\fIlckpwdf\fR +і +\fIulckpwdf\fR +слід користуватися для забезпечення виключного доступу до файла +/etc/shadow\&. +\fIlckpwdf\fR +намагається отримати блокування за допомогою +\fIpw_lock\fR +протягом періоду до 15 секунд\&. Підпрограма продовжує спроби отримати друге блокування +\fIspw_lock\fR +за решту початкових 15 секунд\&. Якщо протягом загального періоду у 15 секунд спроби завершаться невдачею, +\fIlckpwdf\fR +повертає \-1\&. Якщо вдасться отримати обидва блокування, буде повернуто 0\&. +.SH "ДІАГНОСТИКА" +.PP +Підпрограми повертають NULL, якщо не залишилося доступних записів або якщо станеться помилка під час обробки даних\&. Підпрограми, які повертають значення типу +\fIint\fR, повертають 0, якщо підпрограму виконано успішно, і \-1, якщо виконання підпрограми завершилося помилкою\&. +.SH "ЗАСТЕРЕЖЕННЯ" +.PP +Цими підпрограмами може користуватися лише надкористувач, оскільки доступ до файла прихованих паролів обмежено\&. +.SH "ФАЙЛИ" +.PP +/etc/shadow +.RS 4 +Відомості щодо захищених облікових записів користувачів\&. +.RE +.SH "ДИВ\&. ТАКОЖ" +.PP +\fBgetpwent\fR(3), +\fBshadow\fR(5)\&. -- cgit v1.2.3