.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk .\" .\" .\" 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 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 1996-05-27 by Martin Schulze (joey@linux.de) .\" Modified 2003-11-15 by aeb .\" 2008-11-07, mtk, Added an example program for getpwnam_r(). .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getpwnam 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ getpwnam, getpwnam_r, getpwuid, getpwuid_r \- получает записи из файла паролей .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP \fB#include \fP .PP \fBstruct passwd *getpwnam(const char *\fP\fIname\fP\fB);\fP \fBstruct passwd *getpwuid(uid_t \fP\fIuid\fP\fB);\fP .PP \fBint getpwnam_r(const char *restrict \fP\fIname\fP\fB, struct passwd *restrict \fP\fIpwd\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict .\fP\fIbuflen\fP\fB], size_t \fP\fIbuflen\fP\fB,\fP \fB struct passwd **restrict \fP\fIresult\fP\fB);\fP \fBint getpwuid_r(uid_t \fP\fIuid\fP\fB, struct passwd *restrict \fP\fIpwd\fP\fB,\fP \fB char \fP\fIbuf\fP\fB[restrict .\fP\fIbuflen\fP\fB], size_t \fP\fIbuflen\fP\fB,\fP \fB struct passwd **restrict \fP\fIresult\fP\fB);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \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. .PP Функция \fBgetpwuid\fP() возвращает указатель на структуру, содержащую разделённую на поля запись из базы данных паролей, которая соответствует идентификатору пользователя \fIuid\fP. .PP Структура \fIpasswd\fP определена в \fI\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). .PP Функции \fBgetpwnam_r\fP() и \fBgetpwuid_r\fP() принимают ту же информацию что и \fBgetpwnam\fP() и \fBgetpwuid\fP(), но сохраняют полученную структуру \fIpasswd\fP в пространство, указанное \fIpwd\fP. Строковые поля членов структуры \fIpasswd\fP сохраняются в буфере \fIbuf\fP размера \fIbuflen\fP. Указатель на результат (при успешном выполнении) или NULL (если записи отсутствуют или произошла ошибка) сохраняется в \fI*result\fP. .PP Вызов .PP .in +4n .EX sysconf(_SC_GETPW_R_SIZE_MAX) .EE .in .PP возвращает или \-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. .PP Возвращаемое значение может указывать на статическую область и может быть перезаписано при последующих вызовах \fBgetpwent\fP(3), \fBgetpwnam\fP() или \fBgetpwuid\fP() (не передавайте полученный указатель \fBfree\fP(3)). .PP При успешном выполнении \fBgetpwnam_r\fP() и \fBgetpwuid_r\fP() возвращают ноль, и устанавливают \fI*result\fP в \fIpwd\fP. Если совпадений не найдено, то эти функции возвращают 0 и сохраняют NULL в \fI*result\fP. При ошибке возвращается её номер и в \fI*result\fP сохраняется NULL. .SH ОШИБКИ .TP \fB0\fP or \fBENOENT\fP or \fBESRCH\fP or \fBEBADF\fP or \fBEPERM\fP or ... Указанное значение \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 NOTE The user password database mostly refers to \fI/etc/passwd\fP. However, with recent systems it also refers to network wide databases using NIS, LDAP and other local files as configured in \fI/etc/nsswitch.conf\fP. .SH ФАЙЛЫ .TP \fI/etc/passwd\fP файл, содержащий локальную базу паролей .TP \fI/etc/nsswitch.conf\fP System Databases and Name Service Switch configuration file .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 .sp 1 .SH ВЕРСИИ The \fIpw_gecos\fP field is not specified in POSIX, but is present on most implementations. .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 и, возможно, другие. .PP В поле \fIpw_dir\fP содержится имя первого рабочего каталога пользователя. Программы входа используют это значение для инициализации переменной окружения \fBHOME\fP для регистрационной оболочки. Приложение, которое хочет определить имя домашнего каталога пользователя должно проверять значение \fBHOME\fP (а не значение \fIgetpwuid(getuid())\->pw_dir\fP), так как это позволяет пользователю изменять их понятие о «домашнем каталоге» в течении сеанса. Для определения (начального) домашнего каталога другого пользователя необходимо использовать \fIgetpwnam("имя пользователя")\->pw_dir\fP или похожий вызов. .SH ПРИМЕРЫ Представленная ниже программа использует \fBgetpwnam_r\fP() при поиске полного имени пользователя и его ID согласно указанному имени в аргументе командной строки. .PP .\" 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\en", 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\en"); else { errno = s; perror("getpwnam_r"); } exit(EXIT_FAILURE); } \& printf("Name: %s; UID: %jd\en", 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), \fBnsswitch.conf\fP(5), \fBpasswd\fP(5) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Azamat Hackimov , Dmitry Bolkhovskikh , Vladislav , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .