.\" -*- 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 <joey@linux.de>
.\" Modified Thu Dec 13 21:10:55 2001 by Martin Schulze <joey@infodrom.org>
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getpwent 3 "20 lipca 2023 r." "Linux man\-pages 6.05.01" 
.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 <sys/types.h>\fP
\fB#include <pwd.h>\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<pwd.h>\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).
.TS
allbox;
lb lb lbx
l l l.
Interfejs	Atrybut	Wartość
T{
.na
.nh
\fBgetpwent\fP()
T}	Bezpieczeństwo wątkowe	T{
.na
.nh
MT\-Unsafe race:pwent
race:pwentbuf locale
T}
T{
.na
.nh
\fBsetpwent\fP(),
\fBendpwent\fP()
T}	Bezpieczeństwo wątkowe	T{
.na
.nh
MT\-niebezpieczne race:pwent locale
T}
.TE
.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 WERSJE
The \fIpw_gecos\fP field is not specified in POSIX, but is present on most
implementations.
.SH STANDARDY
POSIX.1\-2008.
.SH HISTORIA
POSIX.1\-2001, SVr4, 4.3BSD.
.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 <pborys@dione.ids.pl>,
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>
i
Robert Luberda <robert@debian.org>
.
.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 .
