gai_strerror()

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

Прототип:

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

Аргументы:

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

Библиотека:

libsocket

Описание:

Функция 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_*, то возвращается указатель на строку, содержимое которой указывает на неизвестную ошибку.


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

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

POSIX 1003.1

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

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

struct addrinfo, freeaddrinfo(), getaddrinfo()




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