GETRPCENT(3)
GETRPCENT(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-программы */ };
ЭЛЕМЕНТЫ СТРУКТУРЫ
| Имя сервера для данной RPC-программы. |
| Список альтернативных имен RPC-программы, оканчивающийся нулем. |
| Номер RPC-программы для данной функции. |
Команды работают следующим образом:
Getrpcent считывает следующую строку из файла, открывая файл в случае необходимости.
Функция setrpcent открывает файл и возвращается к его началу. Если флаг stayopen установлен (non-zero), сетевая БД не будет закрываться после каждого обращения к getrpcent. Endrpcent закрывает файл. Getrpcbyname и getrpcbynumber последовательно просматривают файл с самого начала в поисках имени или номера RPC-программы.
ФАЙЛЫ
/etc/rpc имя_домена/rpc.bynumber
СМ. ТАКЖЕ
,
ДИАГНОСТИКА
В случае достижения конца файла или возникновения ошибки возвращаемый указатель имеет нулевое значение.
ЗАМЕЧАНИЯ
Вся информация сохраняется в статической области, поэтому в целях сохранения ее необходимо скопировать.
