.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 19:23:25 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getpw 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
getpw \- восстанавливает строку пароля
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#define _GNU_SOURCE\fP             /* смотрите feature_test_macros(7) */
\fB#include <sys/types.h>\fP
\fB#include <pwd.h>\fP
.PP
\fB[[deprecated]] int getpw(uid_t \fP\fIuid\fP\fB, char *\fP\fIbuf\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Функция \fBgetpw\fP() заново создаёт в буфере строку пароля для пользователя с
ID \fIuid\fP в буфере \fIbuf\fP. Возвращаемый буфер содержит строку в формате
.PP
.in +4n
.EX
\fBname:passwd:uid:gid:gecos:dir:shell\fP
.EE
.in
.PP
Структура \fIpasswd\fP определена в \fI<pwd.h>\fP таким образом:
.PP
.in +4n
.EX
struct passwd {
    char   *pw_name;       /* имя пользователя */
    char   *pw_passwd;     /* пароль пользователя */
    uid_t   pw_uid;        /* идентификатор пользователя */
    gid_t   pw_gid;        /* идентификатор группы */
    char   *pw_gecos;      /* информация о пользователе */
    char   *pw_dir;        /* домашний каталог */
    char   *pw_shell;      /* программная оболочка */
};
.EE
.in
.PP
Подробней о полях этой структуры смотрите в \fBpasswd\fP(5).
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
При успешном выполнении \fBgetpw\fP() возвращается 0; при ошибке возвращается
\-1, а в \fIerrno\fP содержится код ошибки.
.PP
Если \fIuid\fP не найден в базе данных паролей, то \fBgetpw\fP() возвращает \-1,
присваивает \fIerrno\fP значение 0 и \fIbuf\fP не изменяется.
.SH ОШИБКИ
.TP 
\fB0\fP или \fBENOENT\fP
Отсутствует пользователь с соответствующим \fIuid\fP.
.TP 
\fBEINVAL\fP
Значение \fIbuf\fP равно NULL.
.TP 
\fBENOMEM\fP
Недостаточно памяти для структуры \fIpasswd\fP.
.SH ФАЙЛЫ
.TP 
\fI/etc/passwd\fP
файл, содержащий базу паролей
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBgetpw\fP()
T}	Безвредность в нитях	MT\-Safe locale
.TE
.sp 1
.SH СТАНДАРТЫ
None.
.SH ИСТОРИЯ
SVr2.
.SH ДЕФЕКТЫ
Функция \fBgetpw\fP() является в каком\-то смысле опасной, так как может
переполнить предоставляемый ей буфер \fIbuf\fP. Она заменена на \fBgetpwuid\fP(3).
.SH "СМ. ТАКЖЕ"
\fBendpwent\fP(3), \fBfgetpwent\fP(3), \fBgetpwent\fP(3), \fBgetpwnam\fP(3),
\fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBsetpwent\fP(3), \fBpasswd\fP(5)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Azamat Hackimov <azamat.hackimov@gmail.com>,
Dmitry Bolkhovskikh <d20052005@yandex.ru>,
Vladislav <ivladislavefimov@gmail.com>,
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .