gai_strerror()

Вернуть строку, связанную с кодом ошибки getaddrinfo()

Прототип:

#include <sys/types.h>
#include <sys/socket.h>
#include <netdb.h>
                                       
const char * gai_strerror( int ecode );

Аргументы:

ecode: Код ошибки из функции getaddrinfo().

Описание:

Функция gai_strerror() возвращает строку, описывающую код ошибки из функции getaddrinfo(). Коды ошибки, отличные от нуля описаны в <netdb.h>:

EAI_ADDRFAMILY: Семейство адресов для nodename не поддерживается.
EAI_AGAIN: Произошел временный сбой при разрешении имен.
EAI_BADFLAGS: Некорректное значение ai_flags.
EAI_FAIL: Неустранимый сбой в разрешении имен.
EAI_FAMILY: ai_family не поддерживается.
EAI_MEMORY: Ошибка выделения памяти.
EAI_NODATA: Отсутствует адрес, связанный с именем узла.
EAI_NONAME: Неизвестен или не предоставлен либо nodename либо servname.
EAI_SERVICE: Аргумент servname не поддерживается для ai_socktype.
EAI_SOCKTYPE: ai_socktype не поддерживается.
EAI_SYSTEM: Системная ошибка возвращена в errno.

При вызове с корректным аргументом ecode, возвращается указатель на строку, описывающую данный код ошибки. Если аргумент не является одним из значений EAI_*, то возвращается указатель на строку, содержимое которой указывает на неизвестную ошибку.

Не изменяйте содержимое строк, возвращаемых данной функцией.

Классификация:

POSIX 1003.1

Безопасность использования
Точка остановки потока: Нет
Обработчик прерываний: Да
Обработчик сигналов: Да
В потоке: Да

Тематические ссылки:

struct addrinfo, freeaddrinfo(), getaddrinfo()

Предыдущий раздел: Описание API сетевой библиотеки