getrpcent

Autres langues

Langue: pl

Autres versions - même langue

Version: 1987-12-14 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

NAZWA

getrpcent, getrpcbyname, getrpcbynumber - odcztanie wpisu dotycz±cego RPC

SK£ADNIA


#include <netdb.h>



struct rpcent *getrpcent()



struct rpcent *getrpcbyname(name)

char *name;



struct rpcent *getrpcbynumber(number)

int number;



setrpcent (stayopen)

int stayopen;



endrpcent ()


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 linii bazy danych programów RPC /etc/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 zerem lista alternatywnych nazw tego programu RPC.
r_number
Numer programu RPC dla danej us³ugi.

getrpcent() odczytuje nastêpn± liniê pliku, otwieraj±c go, je¶li jest to potrzebne.

setrpcent() otwiera i przewija plik. Je¶li flaga stayopen ma warto¶æ niezerow±, to plik sieciowej bazy danych nie bêdzie zamykany po ka¿dym wywo³aniu getrpcent() (ani bezpo¶rednim, ani po¶rednim - poprzez wywo³anie jednej z pozosta³ych funkcji ``getrpc'' ).

endrpcent zamyka plik.

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.

PLIKI

/etc/rpc

ZOBACZ TAK¯E

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

DIAGNOSTYKA

W przypadku b³êdu lub napotkania koñca pliku, zwracany jest wska¼nik NULL.

B£ÊDY

Wszystkie informacje s± umieszczane w statycznym obszarze pamiêci, zatem musz± zostaæ skopiowane, je¶li maj± byæ zachowane.