NAZWA

       getrpcent,   getrpcbyname,   getrpcbynumber,   setrpcent,  endrpcent  -  odczytanie  wpisu
       dotyczącego RPC

SKŁADNIA

       #include <netdb.h>

       struct rpcent *getrpcent(void);

       struct rpcent *getrpcbyname(const char *name);

       struct rpcent *getrpcbynumber(int number);

       void setrpcent(int stayopen);

       void endrpcent(void);

OPIS

       Funkcje getrpcent(), getrpcbyname() i getrpcbynumber()  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.

           struct rpcent {
               char  *r_name;     /* nazwa serwera dla programu RPC */
               char **r_aliases;  /* lista aliasów */
               long   r_number;   /* numer programu RPC */
           };

       Polami tej struktury są:

           r_name      Nazwa serwera dla danego programu RPC.

           r_aliases   Zakończona NULL-em lista alternatywnych nazw tego programu RPC.

           r_number    Numer programu RPC dla danej usługi.

       Funkcja getrpcent() odczytuje następny wpis z bazy danych. Połączenie do bazy danych  jest
       otwierane, jeśli jest to potrzebne.

       Funkcja  setrpcent() otwiera połączenie do bazy danych i ustawia wskaźnik następnego wpisu
       na pierwszy wpis. Jeśli stayopen jest niezerowe, to połączenie do bazy danych  nie  będzie
       zamykane pomiędzy wywołaniami funkcji getrpc*().

       Funkcja endrpcent() zamyka połączenie do bazy danych.

       getrpcbyname()  i  getrpcbynumber()  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.

WARTOŚĆ ZWRACANA

       Jeśli  zakończą  się  pomyślnie,  funkcje  getrpcent(),  getrpcbyname() i getrpcbynumber()
       zwracają  wskaźnik  do  statycznie  alokowanego  obiektu  o  strukturze  rpcent.  W  razie
       napotkania końca pliku lub wystąpienia błędu zwracane jest NULL.

PLIKI

       /etc/rpc
              Baza numerów programów RPC.

ATRYBUTY

       Informacje   o   pojęciach   używanych   w  tym  rozdziale  można  znaleźć  w  podręczniku
       attributes(7).

       ┌─────────────────────────────┬────────────────────────┬────────────────┐
       │Interfejs                    │ Atrybut                │ Wartość        │
       ├─────────────────────────────┼────────────────────────┼────────────────┤
       │getrpcent(), getrpcbyname(), │ Bezpieczeństwo wątkowe │ MT-Unsafe      │
       │getrpcbynumber()             │                        │                │
       ├─────────────────────────────┼────────────────────────┼────────────────┤
       │setrpcent(), endrpcent()     │ Bezpieczeństwo wątkowe │ MT-Safe locale │
       └─────────────────────────────┴────────────────────────┴────────────────┘

ZGODNE Z

       Nie występuje w POSIX.1. Obecna w systemach BSD, Solaris i wielu innych.

BŁĘDY IMPLEMENTACJI

       Wszystkie informacje są umieszczane w statycznym  obszarze  pamięci,  zatem  muszą  zostać
       skopiowane, jeśli mają być zachowane.

ZOBACZ TAKŻE

       getrpcent_r(3), rpc(5), rpcinfo(8), ypserv(8)

O STRONIE

       Angielska  wersja  tej  strony  pochodzi  z  wydania  4.07  projektu Linux man-pages. Opis
       projektu, informacje dotyczące zgłaszania błędów oraz  najnowszą  wersję  oryginału  można
       znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

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>.

       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ą    4.07
       oryginału.

                                            2015-07-23                               GETRPCENT(3)