НАЗВАНИЕ
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)
ДИАГНОСТИКА
В случае достижения конца файла или возникновения ошибки
возвращаемый указатель имеет нулевое значение.
ЗАМЕЧАНИЯ
Вся информация сохраняется в статической области, поэтому в
целях сохранения ее необходимо скопировать.