- bookworm 4.18.1-1
- bookworm-backports 4.23.0-1~bpo12+1
- testing 4.23.0-1
- unstable 4.23.0-1
getservent(3) | Library Functions Manual | getservent(3) |
ИМЯ¶
getservent, getservbyname, getservbyport, setservent, endservent - возвращают запись о службе
LIBRARY¶
Standard C library (libc, -lc)
СИНТАКСИС¶
#include <netdb.h>
struct servent *getservent(void);
struct servent *getservbyname(const char *name, const char *proto); struct servent *getservbyport(int port, const char *proto);
void setservent(int stayopen); void endservent(void);
ОПИСАНИЕ¶
Функция getservent() считывает следующую запись из файла, содержащего базу служб (смотрите services(5)), и возвращает структуру servent, содержащую поля из этой записи. При необходимости будет открыто подключение к базе.
Функция getservbyname() возвращает структуру servent элемента из базы данных, который совпадает со службой name и использующей протокол proto. Если значение proto равно NULL, то подойдёт любой протокол. При необходимости будет открыто подключение к базе.
Функция getservbyport() возвращает структуру servent элемента из базы данных, который совпадает с портом port (значение имеет сетевой порядок байт) и использующей протокол proto. Если значение proto равно NULL, то подойдёт любой протокол. При необходимости будет открыто подключение к базе.
Функция setservent() открывает соединение к базе и устанавливает следующую запись к первой записи. Если stayopen не равен нулю, то подключение к базе между вызовами нескольких функций getserv*() не будет закрыто.
Функция endservent() закрывает подключение к базе.
Структура servent определена в <netdb.h> таким образом:
struct servent {
char *s_name; /* официальное имя службы */
char **s_aliases; /* список псевдонимов */
int s_port; /* номер порта */
char *s_proto; /* используемый протокол */ }
Члены структуры servent:
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
The getservent(), getservbyname(), and getservbyport() functions return a pointer to a statically allocated servent structure, or NULL if an error occurs or the end of the file is reached.
ФАЙЛЫ¶
- /etc/services
- файл базы данных служб
АТРИБУТЫ¶
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
getservent() | Безвредность в нитях | MT-Unsafe race:servent race:serventbuf locale |
getservbyname() | Безвредность в нитях | MT-Unsafe race:servbyname locale |
getservbyport() | Безвредность в нитях | MT-Unsafe race:servbyport locale |
setservent(), endservent() | Безвредность в нитях | MT-Unsafe race:servent locale |
В приведённой выше таблице servent в race:servent означает, что если в нескольких нитях программы одновременно используются функции setservent(), getservent() или endservent(), то может возникнуть состязательность по данным.
СТАНДАРТЫ¶
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 6.8 |