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

СМ. ТАКЖЕ

ДИАГНОСТИКА

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

ЗАМЕЧАНИЯ

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

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