man/ru/shadow.3

   1 '\" t
   2 .\"     Title: shadow
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
   5 .\"      Date: 02/16/2011
   6 .\"    Manual: Библиотечные функции
   7 .\"    Source: Библиотечные функции
   8 .\"  Language: Russian
   9 .\"
  10 .TH "shadow" "3" "02/16/2011" "Библиотечные функции" "Библиотечные функции"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "НАЗВАНИЕ"
  31 shadow, getspnam \- процедуры для работы с файлом шифрованных паролей
  32 .SH "СИНТАКСИС"
  33 .PP
  34
  35 \fI#include <shadow\&.h>\fR
  36 .PP
  37
  38 \fIstruct spwd *getspent();\fR
  39 .PP
  40
  41 \fIstruct spwd *getspnam(char\fR
  42 \fI*name\fR\fI);\fR
  43 .PP
  44
  45 \fIvoid setspent();\fR
  46 .PP
  47
  48 \fIvoid endspent();\fR
  49 .PP
  50
  51 \fIstruct spwd *fgetspent(FILE\fR
  52 \fI*fp\fR\fI);\fR
  53 .PP
  54
  55 \fIstruct spwd *sgetspent(char\fR
  56 \fI*cp\fR\fI);\fR
  57 .PP
  58
  59 \fIint putspent(struct spwd\fR
  60 \fI*p,\fR
  61 \fIФАЙЛ\fR
  62 \fI*fp\fR\fI);\fR
  63 .PP
  64
  65 \fIint lckpwdf();\fR
  66 .PP
  67
  68 \fIint ulckpwdf();\fR
  69 .SH "ОПИСАНИЕ"
  70 .PP
  71 \fIshadow\fR
  72 управляет содержимым файла теневых паролей,
  73 /etc/shadow\&. Структура в файле
  74 \fI#include\fR:
  75 .sp
  76 .if n \{\
  77 .RS 4
  78 .\}
  79 .nf
  80 struct spwd {
  81       char                      *sp_namp;  /* имя пользователя */
  82       char                      *sp_pwdp;  /* шифрованный пароль */
  83       long int                  sp_lstchg; /* дата последней смены пароля */
  84       long int                  sp_min;    /* дней должно пройти между сменами пароля\&. */
  85       long int                  sp_max;    /* дней перед необходимостью смены пароля */
  86       long int                  sp_warn;   /* дней вывода предупреждения об устаревании */
  87       long int                  sp_inact;  /* дней перед тем как учётная запись заблокируется */
  88       long int                  sp_expire; /* дата устаревания учётной записи */
  89       unsigned long int sp_flag;   /* зарезервировано */
  90 }
  91 .fi
  92 .if n \{\
  93 .RE
  94 .\}
  95 .PP
  96 Значение каждого поля:
  97 .sp
  98 .RS 4
  99 .ie n \{\
 100 \h'-04'\(bu\h'+03'\c
 101 .\}
 102 .el \{\
 103 .sp -1
 104 .IP \(bu 2.3
 105 .\}
 106 sp_namp \- указатель на строку с именем пользователя, завершающуюся нулевым символом
 107 .RE
 108 .sp
 109 .RS 4
 110 .ie n \{\
 111 \h'-04'\(bu\h'+03'\c
 112 .\}
 113 .el \{\
 114 .sp -1
 115 .IP \(bu 2.3
 116 .\}
 117 sp_pwdp \- указатель на строку с паролем, завершающуюся нулевым символом
 118 .RE
 119 .sp
 120 .RS 4
 121 .ie n \{\
 122 \h'-04'\(bu\h'+03'\c
 123 .\}
 124 .el \{\
 125 .sp -1
 126 .IP \(bu 2.3
 127 .\}
 128 sp_lstchg \- количество дней, когда был изменён пароль последний раз, начиная с 1 января 1970 года
 129 .RE
 130 .sp
 131 .RS 4
 132 .ie n \{\
 133 \h'-04'\(bu\h'+03'\c
 134 .\}
 135 .el \{\
 136 .sp -1
 137 .IP \(bu 2.3
 138 .\}
 139 sp_min \- количество дней, когда можно не менять пароль
 140 .RE
 141 .sp
 142 .RS 4
 143 .ie n \{\
 144 \h'-04'\(bu\h'+03'\c
 145 .\}
 146 .el \{\
 147 .sp -1
 148 .IP \(bu 2.3
 149 .\}
 150 sp_max \- количество дней, которое должно пройти, чтобы нужно было поменять пароль
 151 .RE
 152 .sp
 153 .RS 4
 154 .ie n \{\
 155 \h'-04'\(bu\h'+03'\c
 156 .\}
 157 .el \{\
 158 .sp -1
 159 .IP \(bu 2.3
 160 .\}
 161 sp_warn \- количество дней, когда будет выдаваться предупреждение о скором устаревании пароля перед тем как пароль устареет
 162 .RE
 163 .sp
 164 .RS 4
 165 .ie n \{\
 166 \h'-04'\(bu\h'+03'\c
 167 .\}
 168 .el \{\
 169 .sp -1
 170 .IP \(bu 2.3
 171 .\}
 172 sp_inact \- количество дней, которые должны пройти после устаревания пароля, когда начинать считать, что учётная запись неактивна и заблокирована
 173 .RE
 174 .sp
 175 .RS 4
 176 .ie n \{\
 177 \h'-04'\(bu\h'+03'\c
 178 .\}
 179 .el \{\
 180 .sp -1
 181 .IP \(bu 2.3
 182 .\}
 183 sp_expire \- дней, после которых учётная запись будет заблокирована, начиная с 1 января 1970 года
 184 .RE
 185 .sp
 186 .RS 4
 187 .ie n \{\
 188 \h'-04'\(bu\h'+03'\c
 189 .\}
 190 .el \{\
 191 .sp -1
 192 .IP \(bu 2.3
 193 .\}
 194 sp_flag \- зарезервировано
 195 .RE
 196 .SH "ОПИСАНИЕ"
 197 .PP
 198 Функции
 199 \fIgetspent\fR,
 200 \fIgetspname\fR,
 201 \fIfgetspent\fR
 202 и
 203 \fIsgetspent\fR
 204 возвращают указатель на структуру
 205 \fIstruct spwd\fR\&.
 206 \fIgetspent\fR
 207 возвращает следующую запись из файла, а
 208 \fIfgetspent\fR
 209 возвращает следующую запись из заданного канала, предполагая, что это файл правильного формата\&.\fIsgetspent\fR
 210 возвращает указатель на
 211 \fIstruct spwd\fR, используя предоставленную строку в качестве входящих данных\&.
 212 \fIgetspnam\fR
 213 ищет начиная с текущей позиции в файле запись по имени
 214 \fIname\fR\&.
 215 .PP
 216 Функции
 217 \fIsetspent\fR
 218 и
 219 \fIendspent\fR
 220 можно использовать для перемещения в начало и конец файла теневых паролей соответственно\&.
 221 .PP
 222 Функции
 223 \fIlckpwdf\fR
 224 и
 225 \fIulckpwdf\fR
 226 используются для получения монопольного доступа к файлу
 227 /etc/shadow\&.
 228 \fIlckpwdf\fR
 229 пытается выполнить блокировку с помощью
 230 \fIpw_lock\fR
 231 в течении 15 секунд\&. Далее выполняется попытка получить вторую блокировку с помощью
 232 \fIspw_lock\fR
 233 в течении времени оставшегося от первоначальных 15 секунд\&. При неудаче в любой из блокировок в течении 15 секунд, функция
 234 \fIlckpwdf\fR
 235 возвращает \-1\&. Если обе блокировки прошли успешно возвращается 0\&.
 236 .SH "ДИАГНОСТИКА"
 237 .PP
 238 Функции возвращают NULL, если все записи кончились или произошла ошибка во время работы\&. Функции, возвращающие
 239 \fIint\fR, возвращают 0 при успешном выполнении и \-1 в случае неудачи\&.
 240 .SH "ПРЕДОСТЕРЕЖЕНИЯ"
 241 .PP
 242 Данные функции могут использоваться только суперпользователем, так как доступ к файлу теневых паролей ограничен\&.
 243 .SH "ФАЙЛЫ"
 244 .PP
 245 /etc/shadow
 246 .RS 4
 247 содержит защищаемую информацию о пользователях
 248 .RE
 249 .SH "СМОТРИТЕ ТАКЖЕ"
 250 .PP
 251 \fBgetpwent\fR(3),
 252 \fBshadow\fR(5)\&.