.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, David Metcalfe .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getpwnam 3 "8 февраля 2026 г." "Linux man\-pages 6.18" .SH НАИМЕНОВАНИЕ getpwnam, getpwnam_r, getpwuid, getpwuid_r \- получает записи из файла паролей .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP \fB#include \fP .P \fBstruct passwd *getpwnam(const char *\fP\fIname\fP\fB);\fP \fBstruct passwd *getpwuid(uid_t \fP\fIuid\fP\fB);\fP .P \fBint getpwnam_r(\fPsize_t size; \fB const char *restrict \fP\fIname\fP\fB,\fP \fB struct passwd *restrict \fP\fIpwd\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP \fB struct passwd **restrict \fP\fIresult\fP\fB);\fP \fBint getpwuid_r(\fPsize_t size; \fB uid_t \fP\fIuid\fP\fB,\fP \fB struct passwd *restrict \fP\fIpwd\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP \fB struct passwd **restrict \fP\fIresult\fP\fB);\fP .fi .P .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .P \fBgetpwnam_r\fP(), \fBgetpwuid_r\fP(): .nf _POSIX_C_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH ОПИСАНИЕ Функция \fBgetpwnam\fP() возвращает указатель на структуру, содержащую разделённую на поля запись из базы данных паролей (например, из локального файла паролей \fI/etc/passwd\fP, NIS и LDAP), которая соответствует имени пользователя \fIname\fP. .P Функция \fBgetpwuid\fP() возвращает указатель на структуру, содержащую разделённую на поля запись из базы данных паролей, которая соответствует идентификатору пользователя \fIuid\fP. .P Структура \fIpasswd\fP определена в \fI\fP таким образом: .P .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 .P Подробней об этих полях смотрите в \fBpasswd\fP(5). .P The \fBgetpwnam_r\fP() and \fBgetpwuid_r\fP() functions obtain the same information as \fBgetpwnam\fP() and \fBgetpwuid\fP(), but store the retrieved \fIpasswd\fP structure in the space pointed to by \fIpwd\fP. The string fields pointed to by the members of the \fIpasswd\fP structure are stored in the buffer \fIbuf\fP of size \fIsize\fP. A pointer to the result (in case of success) or NULL (in case no entry was found or an error occurred) is stored in \fI*result\fP. .P Вызов .P .in +4n .EX sysconf(_SC_GETPW_R_SIZE_MAX) .EE .in .P возвращает или \-1 без изменения \fIerrno\fP или начальный предполагаемый размер \fIbuf\fP (если этот размер мал, то вызов завершается \fBERANGE\fP; в этом случае вызывающий может повторить вызов с большим буфером). .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" The \fBgetpwnam\fP() and \fBgetpwuid\fP() functions return a pointer to a \fIpasswd\fP structure, or NULL if the matching entry is not found or an error occurs. If an error occurs, \fIerrno\fP is set to indicate the error. If one wants to check \fIerrno\fP after the call, it should be set to zero before the call. .P Возвращаемое значение может указывать на статическую область и может быть перезаписано при последующих вызовах \fBgetpwent\fP(3), \fBgetpwnam\fP() или \fBgetpwuid\fP() (не передавайте полученный указатель \fBfree\fP(3)). .P При успешном выполнении \fBgetpwnam_r\fP() и \fBgetpwuid_r\fP() возвращают ноль, и устанавливают \fI*result\fP в \fIpwd\fP. Если совпадений не найдено, то эти функции возвращают 0 и сохраняют NULL в \fI*result\fP. При ошибке возвращается её номер и в \fI*result\fP сохраняется NULL. .SH ОШИБКИ .TP \fB0\fP или \fBENOENT\fP или \fBESRCH\fP или \fBEBADF\fP или \fBEPERM\fP или ... Указанное значение \fIname\fP или \fIuid\fP не найдено. .TP \fBEINTR\fP При выполнении поступил сигнал; см. \fBsignal\fP(7). .TP \fBEIO\fP Ошибка ввода\-вывода. .TP \fBEMFILE\fP Было достигнуто ограничение по количеству открытых файловых дескрипторов на процесс. .TP \fBENFILE\fP Достигнуто максимальное количество открытых файлов в системе. .TP \fBENOMEM\fP .\" not in POSIX .\" This structure is static, allocated 0 or 1 times. No memory leak. (libc45) Недостаточно памяти для структуры \fIpasswd\fP. .TP \fBERANGE\fP Недостаточно места в буфере. .SH ФАЙЛЫ .TP \fI/etc/passwd\fP файл, содержащий локальную базу паролей .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lb lb lbx l l l. Интерфейс Атрибут Значение T{ .na .nh \fBgetpwnam\fP() T} Безвредность в нитях T{ .na .nh MT\-Unsafe race:pwnam locale T} T{ .na .nh \fBgetpwuid\fP() T} Безвредность в нитях T{ .na .nh MT\-Unsafe race:pwuid locale T} T{ .na .nh \fBgetpwnam_r\fP(), \fBgetpwuid_r\fP() T} Безвредность в нитях T{ .na .nh MT\-Safe locale T} .TE .SH ВЕРСИИ Поле \fIpw_gecos\fP не указано в POSIX, но присутствует в большинстве реализаций. .SH СТАНДАРТЫ POSIX.1\-2008. .SH ИСТОРИЯ POSIX.1\-2001, SVr4, 4.3BSD. .SH ПРИМЕЧАНИЯ .\" more precisely: .\" AIX 5.1 - gives ESRCH .\" OSF1 4.0g - gives EWOULDBLOCK .\" libc, glibc up to glibc 2.6, Irix 6.5 - give ENOENT .\" since glibc 2.7 - give 0 .\" FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 - give EPERM .\" SunOS 5.8 - gives EBADF .\" Tru64 5.1b, HP-UX-11i, SunOS 5.7 - give 0 Описание «ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ», приведённого выше, взято из POSIX.1\-2001. В нём «не найдено» не считается ошибкой и поэтому не указано, каким может быть значение \fIerrno\fP в этом случае. Но это делает невозможным определить тип ошибки. Из описание POSIX можно посчитать, что \fIerrno\fP не должно измениться, если запись не найдена. Эксперименты в различных UNIX\-подобных системах показывают, что в этой ситуации возвращается много разных значений: 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM и, возможно, другие. .P В поле \fIpw_dir\fP содержится имя первого рабочего каталога пользователя. Программы входа используют это значение для инициализации переменной окружения \fBHOME\fP для регистрационной оболочки. Приложение, которое хочет определить имя домашнего каталога пользователя должно проверять значение \fBHOME\fP (а не значение \fIgetpwuid(getuid())\->pw_dir\fP), так как это позволяет пользователю изменять их понятие о «домашнем каталоге» в течении сеанса. Для определения (начального) домашнего каталога другого пользователя необходимо использовать \fIgetpwnam("имя пользователя")\->pw_dir\fP или похожий вызов. .SH ПРИМЕРЫ Представленная ниже программа использует \fBgetpwnam_r\fP() при поиске полного имени пользователя и его ID согласно указанному имени в аргументе командной строки. .P .\" SRC BEGIN (getpwnam.c) .EX #include #include #include #include #include #include \& int main(int argc, char *argv[]) { struct passwd pwd; struct passwd *result; char *buf; long bufsize; int s; \& if (argc != 2) { fprintf(stderr, "Usage: %s username\[rs]n", argv[0]); exit(EXIT_FAILURE); } \& bufsize = sysconf(_SC_GETPW_R_SIZE_MAX); if (bufsize == \-1) /* Value was indeterminate */ bufsize = 16384; /* Should be more than enough */ \& buf = malloc(bufsize); if (buf == NULL) { perror("malloc"); exit(EXIT_FAILURE); } \& s = getpwnam_r(argv[1], &pwd, buf, bufsize, &result); if (result == NULL) { if (s == 0) printf("Not found\[rs]n"); else { errno = s; perror("getpwnam_r"); } exit(EXIT_FAILURE); } \& printf("Name: %s; UID: %jd\[rs]n", pwd.pw_gecos, (intmax_t) pwd.pw_uid); exit(EXIT_SUCCESS); } .EE .\" SRC END .SH "СМОТРИТЕ ТАКЖЕ" \fBendpwent\fP(3), \fBfgetpwent\fP(3), \fBgetgrnam\fP(3), \fBgetpw\fP(3), \fBgetpwent\fP(3), \fBgetspnam\fP(3), \fBputpwent\fP(3), \fBsetpwent\fP(3), \fBpasswd\fP(5) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Azamat Hackimov , Dmitry Bolkhovskikh , Vladislav , Yuri Kozlov и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT debian-l10n-russian@lists.debian.org списка рассылки русских переводчиков .ME .