.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
.\"
.\" %%%LICENSE_START(BSD_ONELINE_CDROM)
.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
.\" %%%LICENSE_END
.\"
.\" @(#)getrpcent.3n	2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\" This file is distributed under the same license as original manpage
.\" Copyright of the original manpage:
.\" Copyright © (BSD)
.\" Copyright © of Polish translation:
.\" Andrzej Krzysztofowicz <ankry@mif.pg.gda.pl>, 2002.
.\" Robert Luberda <robert@debian.org>, 2014.
.\" Michał Kułach <michal.kulach@gmail.com>, 2014.
.TH GETRPCENT 3 2014\-05\-28 "" "Podręcznik programisty Linuksa"
.SH NAZWA
getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \- odczytanie
wpisu dotyczącego RPC
.SH SKŁADNIA
.nf
\fB#include <netdb.h>\fP

\fBstruct rpcent *getrpcent(void);\fP

\fBstruct rpcent *getrpcbyname(const char *\fP\fIname\fP\fB);\fP

\fBstruct rpcent *getrpcbynumber(int \fP\fInumber\fP\fB);\fP

\fBvoid setrpcent(int \fP\fIstayopen\fP\fB);\fP

\fBvoid endrpcent(void);\fP
.fi
.SH OPIS
.LP
Funkcje \fBgetrpcent\fP(), \fBgetrpcbyname\fP() i \fBgetrpcbynumber\fP() zwracają
wskaźnik do obiektu o podanej niżej strukturze, zawierającego pola otrzymane
w wyniku rozłożenia wpisu bazy danych programów RPC.
.in +4n
.nf

struct rpcent {
    char  *r_name;     /* nazwa serwera dla programu RPC */
    char **r_aliases;  /* lista aliasów */
    long   r_number;   /* numer programu RPC */
};
.fi
.in
.LP
Polami tej struktury są:
.RS 4
.TP  12
\fIr_name\fP
Nazwa serwera dla danego programu RPC.
.TP 
\fIr_aliases\fP
Zakończona NULL\-em lista alternatywnych nazw tego programu RPC.
.TP 
\fIr_number\fP
Numer programu RPC dla danej usługi.
.RE
.LP
Funkcja \fBgetrpcent\fP() odczytuje następny wpis z bazy danych. Połączenie do
bazy danych jest otwierane, jeśli jest to potrzebne.
.LP
Funkcja \fBsetrpcent\fP() otwiera połączenie do bazy danych i ustawia wskaźnik
następnego wpisu na pierwszy wpis. Jeśli \fIstayopen\fP jest niezerowe, to
połączenie do bazy danych nie będzie zamykane pomiędzy wywołaniami funkcji
\fBgetrpc*\fP().
.LP
Funkcja \fBendrpcent\fP() zamyka połączenie do bazy danych.
.LP
\fBgetrpcbyname\fP() i \fBgetrpcbynumber\fP() przeszukują sekwencyjnie plik,
zaczynając od jego początku, aż do napotkania pasującej nazwy lub numeru
programu RPC albo do napotkania końca pliku.
.SH "WARTOŚĆ ZWRACANA"
Jeśli zakończą się pomyślnie, funkcje \fBgetrpcent()\fP, \fBgetrpcbyname()\fP i
\fBgetrpcbynumber()\fP zwracają wskaźnik do statycznie alokowanego obiektu o
strukturze \fIrpcent\fP. W razie napotkania końca pliku lub wystąpienia błędu
zwracane jest NULL.
.SH PLIKI
.TP 
\fI/etc/rpc\fP
Baza numerów programów RPC.
.SH "ZGODNE Z"
Nie występuje w POSIX.1\-2001. Obecna w systemach BSD, Solaris i wielu
innych.
.SH "BŁĘDY IMPLEMENTACJI"
Wszystkie informacje są umieszczane w statycznym obszarze pamięci, zatem
muszą zostać skopiowane, jeśli mają być zachowane.
.SH "ZOBACZ TAKŻE"
\fBgetrpcent_r\fP(3), \fBrpc\fP(5), \fBrpcinfo\fP(8), \fBypserv\fP(8)
.SH "O STRONIE"
Angielska wersja tej strony pochodzi z wydania 3.71 projektu Linux
\fIman\-pages\fP. Opis projektu, informacje dotyczące zgłaszania błędów, oraz
najnowszą wersję oryginału można znaleźć pod adresem
\%http://www.kernel.org/doc/man\-pages/.
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika man są:
Andrzej Krzysztofowicz <ankry@mif.pg.gda.pl>,
Robert Luberda <robert@debian.org>
i
Michał Kułach <michal.kulach@gmail.com>.
.PP
Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją \fB 3.71 \fPoryginału.