getrpcent(3)

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

BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)

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(), getrpcbynumber() | Bezpieczeństwo wątkowe | MT-Unsafe
setrpcent(), endrpcent() | Bezpieczeństwo wątkowe | MT-Safe locale

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

BŁĘDY
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)

TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 (https://www.gnu.org/licenses/gpl-3.0.html) lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.