getprotoent(3) | Library Functions Manual | getprotoent(3) |
ИМЯ¶
getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - возвращают запись о протоколе
LIBRARY¶
Standard C library (libc, -lc)
СИНТАКСИС¶
#include <netdb.h>
struct protoent *getprotoent(void);
struct protoent *getprotobyname(const char *name); struct protoent *getprotobynumber(int proto);
void setprotoent(int stayopen); void endprotoent(void);
ОПИСАНИЕ¶
Функция getprotoent() считывает следующую запись из файла, содержащего базу протоколов (смотрите protocols(5)), и возвращает структуру protoent, содержащую поля из этой записи. При необходимости будет открыто подключение к базе.
Функция getprotobyname() возвращает структуру protoent элемента из базы данных, который совпадает с именем протокола name. При необходимости будет открыто подключение к базе.
Функция getprotobynumber() возвращает структуру protoent элемента из базы данных, который совпадает с номером протокола number. При необходимости будет открыто подключение к базе.
Функция setprotoent() открывает соединение к базе и устанавливает следующую запись к первой записи. Если stayopen не равен нулю, то подключение к базе между вызовами нескольких функций getproto*() не будет закрыто.
Функция endprotoent() закрывает подключение к базе.
Структура protoent определена в <netdb.h> таким образом:
struct protoent {
char *p_name; /* официальное имя протокола */
char **p_aliases; /* список псевдонимов */
int p_proto; /* номер протокола */ }
Члены структуры protoent:
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
The getprotoent(), getprotobyname(), and getprotobynumber() functions return a pointer to a statically allocated protoent structure, or a null pointer if an error occurs or the end of the file is reached.
ФАЙЛЫ¶
- /etc/protocols
- файл, содержащий базу протоколов
АТРИБУТЫ¶
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
getprotoent() | Безвредность в нитях | MT-Unsafe race:protoent race:protoentbuf locale |
getprotobyname() | Безвредность в нитях | MT-Unsafe race:protobyname locale |
getprotobynumber() | Безвредность в нитях | MT-Unsafe race:protobynumber locale |
setprotoent(), endprotoent() | Безвредность в нитях | MT-Unsafe race:protoent locale |
В приведённой выше таблице protoent в race:protoent означает, что если в нескольких нитях программы одновременно используются функции setprotoent(), getprotoent() или endprotoent(), то может возникнуть состязательность по данным.
СТАНДАРТЫ¶
POSIX.1-2008.
ИСТОРИЯ¶
POSIX.1-2001, 4.3BSD.
СМОТРИТЕ ТАКЖЕ¶
ПЕРЕВОД¶
Русский перевод этой страницы руководства разработал Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.
2 мая 2024 г. | Linux man-pages (unreleased) |