Unix Man (Справочное руководство)

         

GETRPCBYNUMBER(3)


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

Команды работают следующим образом:

Getrpcent считывает следующую строку из файла, открывая файл в случае необходимости.

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

ФАЙЛЫ

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

СМ. ТАКЖЕ


,

ДИАГНОСТИКА


В случае достижения конца файла или возникновения ошибки возвращаемый указатель имеет нулевое значение.

ЗАМЕЧАНИЯ


Вся информация сохраняется в статической области, поэтому в целях сохранения ее необходимо скопировать.



Содержание раздела