---

   gethostbyname - h_errno,

---

herror(), hstrerror():

h_errno:

---

ОПИСАНИЕ

Функция gethostbyname() возвращает структуру типа hostent для узла name. Значением name может быть или имя узла, или адрес IPv4 в стандартной точечной записи (как в inet_addr(3)). Если name — адрес IPv4, то поиск не выполняется и gethostbyname() просто копирует name в поле h_name, а его эквивалент struct in_addr — в поле h_addr_list[0] возвращаемой структуры hostent Если name не оканчивается точкой и установлена переменная окружения HOSTALIASES, то name сначала ищется в файле псевдонимов, указанном в HOSTALIASES (формат файла описан в hostname(7)). Если name не оканчивается точкой, то поиск производится с текущем доменом и его предками.

Функция gethostbyaddr() возвращает структуру типа hostent для адреса узла addr длинной len и типом адреса type. Допустимые типы адресов — AF_INET и AF_INET6. Аргумент адреса узла — указатель на структуру с типом, зависящим от типа адреса, например для типа адреса AF_INET используется struct in_addr * (возможно, полученная из вызова inet_addr(3)).

Функция sethostent() задаёт (при stayopen равным истине (1)), что для опроса сервера имён должен использоваться подключённый сокет TCP и что соединение должно остаться открытым для последующих запросов. В противном случае для опроса сервера имён будут использоваться дейтаграммы UDP.

Функция endhostent() закрывает использованное для опросов сервера имён соединение TCP.

Функция herror() (устарела) печатает в stderr сообщение об ошибке в соответствии с текущим значением h_errno.

Функция hstrerror() (устарела) принимает номер ошибки (обычно, h_errno) и возвращает соответствующую строку с сообщением об ошибке.

Запросы доменного имени, выполняемые gethostbyname() и gethostbyaddr(), полагаются на настроенные источники диспетчера службы имён (nsswitch.conf(5)) или локальный сервер имён (named(8)). Действием по умолчанию является запрос к настроенным источникам диспетчера службы имён (nsswitch.conf(5)), при ошибке — к локальному серверу имён (named(8)).

Историческая справка

В glibc 2.4 и старее, ключевое слово order использовалось для управления порядком поиска узла в /etc/host.conf (host.conf(5)).

Структура hostent определена в <netdb.h> таким образом:

struct hostent {
    char  *h_name;            /* официальное имя узла */
    char **h_aliases;         /* список псевдонимов */
    int    h_addrtype;        /* тип адреса узла */
    int    h_length;          /* длина адреса */
    char **h_addr_list;       /* список адресов */
}
#define h_addr h_addr_list[0] /* для обратной совместимости */

Члены структуры hostent:

---

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

---

ОШИБКИ

HOST_NOT_FOUND Заданный узел неизвестен.

NO_DATA Запрашиваемое имя корректно, но не имеет IP-адреса. При другом типе запроса для этого домена сервер имён может вернуть ответ. Синонимом NO_DATA является константа NO_ADDRESS.

NO_RECOVERY Произошла неисправимая ошибка сервера имён.

TRY_AGAIN Произошла временная ошибка у авторитативного сервера имён. Попробуйте позже.

ФАЙЛЫ

---

АТРИБУТЫ

Интерфейс Атрибут Значение
gethostbyname() безвредность в потоках: MT-Unsafe race:hostbyname env
locale
gethostbyaddr() безвредность в потоках: MT-Unsafe race:hostbyaddr env
locale
sethostent(),
endhostent(),
gethostent_r() безвредность в потоках: MT-Unsafe race:hostent env
locale
herror(),
hstrerror() безвредность в потоках: безвредно (MT-Safe)
gethostent() безвредность в потоках: MT-Unsafe race:hostent
race:hostentbuf env locale
gethostbyname2() безвредность в потоках: MT-Unsafe race:hostbyname2
env locale
gethostbyaddr_r(), gethostbyname_r(), gethostbyname2_r() безвредность в потоках: безвредно (MT-Safe env locale)

В приведённой выше таблице hostent в race:hostent означает, что если в нескольких нитях программы одновременно используются функции sethostent(3), gethostent(3), gethostent_r(3) или endhostent(3), то может возникнуть состязательность по данным.

---

СООТВЕТСТВИЕ СТАНДАРТАМ

---

ЗАМЕЧАНИЯ

В первой реализации BSD аргумент len у gethostbyname() имел тип int. Стандарт SUSv2 содержит ошибку и объявляет аргумент len у gethostbyaddr() с типом size_t (это неправильно, так как он должен быть int, а не size_t. В POSIX.1-2001 указанный тип — socklen_t, который подходит). Смотрите также accept(2).

У прототипа BSD gethostbyaddr() первый аргумент имеет тип const char *.

Расширение System V/POSIX

Расширения GNU

В glibc2 также имеются реентерабельные версии gethostent_r(), gethostbyaddr_r(), gethostbyname_r() и gethostbyname2_r(). Вызывающий передаёт структуру hostent ret, которая будет заполнена, и временный рабочий буфер buf размера buflen. После вызова result будет указывать на результат. В случае ошибки или при отсутствии записи result будет NULL. При успешном выполнении функция возвращает 0 и ненулевой номер ошибки при сбое. Если buf слишком мал, то кроме ошибок, возвращаемых нереентерабельными версиями этих функций, возвращается ERANGE, и вызов нужно повторить с большим буфером. Глобальная переменная h_errno не изменяется, но адрес переменной, в которой хранятся номера ошибок, передаётся в h_errnop.

ДЕФЕКТЫ