.\" -*- 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:22:14 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze .\" Modified Thu Dec 13 21:10:55 2001 by Martin Schulze .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getpwent 3 "5 lutego 2023 r." "Linux man\-pages 6.03" .SH NAZWA getpwent, setpwent, endpwent \- pobranie wpisu z pliku haseł .SH BIBLIOTEKA Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP) .SH SKŁADNIA .nf \fB#include \fP \fB#include \fP .PP \fBstruct passwd *getpwent(void);\fP \fBvoid setpwent(void);\fP \fBvoid endpwent(void);\fP .fi .PP .RS -4 Wymagane ustawienia makr biblioteki glibc (patrz \fBfeature_test_macros\fP(7)): .RE .PP \fBgetpwent\fP(), \fBsetpwent\fP(), \fBendpwent\fP(): .nf .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED _XOPEN_SOURCE >= 500 || /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH OPIS Funkcja \fBgetpwent\fP() zwraca wskaźnik do struktury, zawierającej poszczególne rekordy bazy danych haseł (na przykład z lokalnego pliku haseł \fI/etc/passwd\fP, NIS\-a lub LDAP\-a). Podczas pierwszego wywołania \fBgetpwent\fP() zwracany jest pierwszy wpis; później zwracane są kolejne. .PP Funkcja \fBsetpwent\fP() ustawia wskaźnik pliku na początek pliku bazy danych haseł. .PP Funkcja \fBendpwent\fP() jest używana do zamknięcia bazy danych haseł użytkowników po zakończeniu jej przetwarzania. .PP Struktura \fIpasswd\fP jest następująco zdefiniowana w pliku \fI\fP: .PP .in +4n .EX struct passwd { char *pw_name; /* nazwa użytkownika */ char *pw_passwd; /* hasło użytkownika */ uid_t pw_uid; /* identyfikator użytkownika */ gid_t pw_gid; /* identyfikator grupy */ char *pw_gecos; /* informacje o użytkowniku */ char *pw_dir; /* katalog domowy */ char *pw_shell; /* program powłoki */ }; .EE .in .\" Next paragraph rejected upstream .PP Jeśli włączone są zaciemniane (\fBshadow\fP(5)) hasła (a na wielu instalacjach GNU/Linux są domyślnie włączone) zawartość pola \fIpw_passwd\fP nie jest zbyt użyteczna. W takim przypadku większość haseł jest przechowywana w osobnym pliku. .PP Zmienna \fIpw_shell\fP może być pusta, co oznacza, że system uruchomi domyślną powłokę logowania użytkownika (\fB/bin/sh\fP). .PP Więcej informacji o polach w tej strukturze można znaleźć w podręczniku \fBpasswd\fP(5). .SH "WARTOŚĆ ZWRACANA" The \fBgetpwent\fP() function returns a pointer to a \fIpasswd\fP structure, or NULL if there are no more entries or an error occurred. 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 Zwrócona wartość może wskazywać na statyczny obszar, który może być nadpisany przez kolejne wywołania \fBgetpwent\fP(), \fBgetpwnam\fP(3) lub \fBgetpwuid\fP(3). (Zwróconego wskaźnika nie należy przekazywać do funkcji \fBfree\fP(3)). .SH BŁĘDY .TP \fBEINTR\fP Przechwycono sygnał, patrz \fBsignal\fP(7). .TP \fBEIO\fP Błąd wejścia/wyjścia. .TP \fBEMFILE\fP Zostało osiągnięte ograniczenie na liczbę otwartych deskryptorów plików dla procesu. .TP \fBENFILE\fP Zostało osiągnięte systemowe ograniczenie na całkowitą liczbę otwartych plików. .TP \fBENOMEM\fP .\" not in POSIX .\" to allocate the passwd structure, or to allocate buffers Zabrakło pamięci na przydzielenie struktury \fIpasswd\fP. .TP \fBERANGE\fP Przekazano niewystarczający bufor. .SH PLIKI .TP \fI/etc/passwd\fP lokalny plik bazy z hasłami .SH ATRYBUTY Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku \fBattributes\fP(7). .ad l .nh .TS allbox; lb lb lbx l l l. Interfejs Atrybut Wartość T{ \fBgetpwent\fP() T} Bezpieczeństwo wątkowe T{ MT\-Unsafe race:pwent race:pwentbuf locale T} T{ \fBsetpwent\fP(), \fBendpwent\fP() T} Bezpieczeństwo wątkowe T{ MT\-Unsafe race:pwent locale T} .TE .hy .ad .sp 1 W powyższej tabeli, \fIpwent\fP w \fIrace:pwent\fP oznacza, że jeśli któraś z funkcji \fBsetpwent\fP(), \fBgetpwent\fP() lub \fBendpwent\fP() jest używana równolegle w różnych wątkach programu, może nastąpić sytuacja wyścigu danych. .SH STANDARDY POSIX.1\-2001, POSIX.1\-2008, SVr4, 4.3BSD. Pole \fIpw_gecos\fP nie jest wymienione w standardzie POSIX, ale większość implementacji je zawiera. .SH "ZOBACZ TAKŻE" .\" Next line rejected upstream \fBfgetpwent\fP(3), \fBgetpw\fP(3), \fBgetpwent_r\fP(3), \fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBshadow\fP(5), \fBpasswd\fP(5) .PP .SH TŁUMACZENIE Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys , Andrzej Krzysztofowicz i Robert Luberda . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .