getrpcent(3) | Library Functions Manual | getrpcent(3) |
ИМЯ
getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent - возвращают запись RPC
LIBRARY
Standard C library (libc, -lc)
СИНТАКСИС
#include <netdb.h>
struct rpcent *getrpcent(void);
struct rpcent *getrpcbyname(const char *name); struct rpcent *getrpcbynumber(int number);
void setrpcent(int stayopen); void endrpcent(void);
ОПИСАНИЕ
Функции getrpcent(), getrpcbyname() и getrpcbynumber() возвращают указатель на объект с описанной ниже структурой, содержащую разделённую на поля запись из базы данных номеров программы RPC.
struct rpcent { char *r_name; /* имя сервера для этой программы RPC */ char **r_aliases; /* список псевдонимов */ long r_number; /* номер программы RPC */ };
Члены структуры:
- r_name
- Имя сервера для этой программы RPC.
- r_aliases
- Список альтернативных имён программы RPC, завершающийся NULL.
- r_number
- Номер программы RPC для этой службы.
Функция getrpcent() считывает следующую запись из базы данных. При необходимости будет открыто подключение к базе.
Функция setrpcent() открывает соединение к базе и устанавливает следующую запись к первой записи. Если stayopen не равен нулю, то подключение к базе между вызовами нескольких функций getrpc*() не будет закрыто.
Функция endrpcent() закрывает подключение к базе.
Функции getrpcbyname() и getrpcbynumber() выполняют последовательный поиск от начала файла до нахождения имени программы RPC, её номера или конца файла.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении getrpcent(), getrpcbyname() и getrpcbynumber() возвращают указатель на статически выделенную структуру rpcent. При ошибке или EOF возвращается NULL.
ФАЙЛЫ
- /etc/rpc
- база данных программных номеров RPC
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
getrpcent(), getrpcbyname(), getrpcbynumber() | Безвредность в нитях | MT-Unsafe |
setrpcent(), endrpcent() | Безвредность в нитях | MT-Safe locale |
СТАНДАРТЫ
Нет в POSIX.1. Присутствует в BSD, Solaris и многих других системах.
ДЕФЕКТЫ
Вся информация располагается в статической области, поэтому для сохранения должна быть скопирована.
СМ. ТАКЖЕ
getrpcent_r(3), rpc(5), rpcinfo(8), ypserv(8)
ПЕРЕВОД
Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
15 декабря 2022 г. | Linux man-pages 6.03 |