GETRPCBYNUMBER(3)

НАЗВАНИЕ
getrpcent, getrpcbyname, getrpcbynumber - получить сведения об RPC

СИНТАКСИС


	#include <rpc/netdb.h>



	struct rpcent *getrpcent()



	struct rpcent *getrpcbyname(name)

	char *name;



	struct rpcent *getrpcbynumber(number)

	int number;



	setrpcent(stayopen)

	int stayopen



	endrpcent()

ОПИСАНИЕ
Функции getrpcent, getrpcbyname и getrpcbyaddr возвращают указатель на объект, имеющий следующую структуру и описывающий строку в БД номеров программ RPC /etc/rpc:


	struct rpcent {

	  char   *r_name;     /* имя сервера для rpc-программы */

	  char   **r_aliases; /* список псевдонимов */

	  long   r_number;    /* номер rpc-программы */

	};

ЭЛЕМЕНТЫ СТРУКТУРЫ

r_name	Имя сервера для данной RPC-программы.
r_aliases	Список альтернативных имен RPC-программы, оканчивающийся нулем.
r_number	Номер RPC-программы для данной функции.

Команды работают следующим образом:
Getrpcent считывает следующую строку из файла, открывая файл в случае необходимости. Функция setrpcent открывает файл и возвращается к его началу. Если флаг stayopen установлен (non-zero), сетевая БД не будет закрываться после каждого обращения к getrpcent. Endrpcent закрывает файл. Getrpcbyname и getrpcbynumber последовательно просматривают файл с самого начала в поисках имени или номера RPC-программы.

ФАЙЛЫ


	/etc/rpc

	имя_домена/rpc.bynumber

СМ. ТАКЖЕ
rpc(2), rpcinfo(8)

ДИАГНОСТИКА
В случае достижения конца файла или возникновения ошибки возвращаемый указатель имеет нулевое значение.

ЗАМЕЧАНИЯ
Вся информация сохраняется в статической области, поэтому в целях сохранения ее необходимо скопировать.