.\" -*- 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 "2 maja 2024 r." "Linux man\-pages 6.8" 
.SH NAZWA
getpw \- rekonstruuje wpis z pliku haseł
.SH BIBLIOTEKA
Standardowa biblioteka C (\fIlibc\fP, \fI\-lc\fP)
.SH SKŁADNIA
.nf
\fB#define _GNU_SOURCE\fP             /* Zob. feature_test_macros(7) */
\fB#include <sys/types.h>\fP
\fB#include <pwd.h>\fP
.P
\fB[[przestarzałe]] int getpw(uid_t \fP\fIuid\fP\fB, char *\fP\fIbuf\fP\fB);\fP
.fi
.SH OPIS
Funkcja \fBgetpw\fP() rekonstruuje linię wpisu w pliku passwd dla użytkownika
określonego przez \fIuid\fP. Wynik jest zapisywany do bufora \fIbuf\fP. Zwrócony
bufor zawiera linię postaci:
.P
.in +4n
.EX
\fBname:passwd:uid:gid:gecos:dir:shell\fP
.EE
.in
.P
Struktura \fIpasswd\fP jest następująco zdefiniowana w pliku
\fI<pwd.h>\fP:
.P
.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
.P
Więcej informacji o polach w tej strukturze można znaleźć w podręczniku
\fBpasswd\fP(5).
.SH "WARTOŚĆ ZWRACANA"
Po pomyślnym zakończeniu \fBgetpw\fP() zwraca zero, po błędzie zwraca \-1 i
odpowiednio ustawia \fIerrno\fP, wskazując na rodzaj błędu.
.P
Jeśli w bazie danych haseł nie znaleziono identyfikatora \fIuid\fP, to
\fBgetpw\fP() zwraca \-1, ustawia \fIerrno\fP na 0 i pozostawia \fIbuf\fP w stanie
niezmienionym.
.SH BŁĘDY
.TP 
\fB0\fP lub \fBENOENT\fP
Brak użytkownika odpowiadającego identyfikatorowi \fIuid\fP.
.TP 
\fBEINVAL\fP
\fIbuf\fP ma wartość NULL.
.TP 
\fBENOMEM\fP
Zabrakło pamięci na przydzielenie struktury \fIpasswd\fP.
.SH PLIKI
.TP 
\fI/etc/passwd\fP
baza danych o hasłach
.SH ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfejs	Atrybut	Wartość
T{
.na
.nh
\fBgetpw\fP()
T}	Bezpieczeństwo wątkowe	MT\-bezpieczne locale
.TE
.SH STANDARDY
Brak.
.SH HISTORIA
SVr2.
.SH USTERKI
Funkcja \fBgetpw\fP() jest niebezpieczna, gdyż może przepełnić udostępniony
bufor \fIbuf\fP. Została zastąpiona przez \fBgetpwuid\fP(3).
.SH "ZOBACZ TAKŻE"
\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 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 .
