Самая основная функция, выполняющая поиск имени узла, — это функция

. При успешном выполнении она возвращает указатель на структуру , содержащую все адреса IPv4 для узла. Однако она может возвращать только адреса IPv4. В разделе 11.6 рассматривается функция, возвращающая адреса IPv4 и IPv6. Стандарт POSIX предупреждает, что функция может быть исключена из будущей его версии.

ПРИМЕЧАНИЕ

Маловероятно, что реализации gethostbyname исчезнут раньше, чем весь Интернет перейдет на протокол IPv6, а произойдет это еще очень не скоро. Однако удаление функции из стандарта POSIX гарантирует, что она не будет использоваться в новых программах. Вместо нее мы рекомендуем использовать getaddrinfo (раздел 11.6).

Непустой указатель, возвращаемый этой функцией, указывает на следующую структуру

:

В терминах DNS функция

выполняет запрос на запись типа А. Функция возвращает только адреса IPv4.

На рис. 11.2 представлено устройство структуры

и содержащаяся в ней информация, в предположении, что искомое имя узла имеет два альтернативных имени и три адреса IPv4. Все имена узла представляют собой строки языка С.

Рис. 11.2. Структура hostent и ее одержимое

Возвращаемое имя

называется каноническим именем узла. Например, с показанными в предыдущем разделе записями CNAME каноническое имя узла будет иметь вид . Также если мы вызываем функцию с узла с неполным именем, например , то в качестве канонического имени возвращается полное доменное имя (FQDN) .

ПРИМЕЧАНИЕ

Некоторые версии функции gethostbyname допускают, что аргумент hostname может быть записан в виде строки десятичных чисел, разделенных точками. То есть вызов в форме hptr = gethostbyname("206.62.226.33"); будет работать. Этот код был добавлен, поскольку клиент Rlogin принимает только имя узла, вызывая функцию gethostbyname, и не принимает точечно-десятичную запись [127]. Стандарт POSIX допускает это, но не устанавливает такое поведение в качестве обязательного, поэтому переносимое приложение не может использовать указанную особенность.

Функция

отличается от других функций сокетов, описанных нами, тем, что она не задает значение переменной , когда происходит ошибка. Вместо этого она присваивает глобальной целочисленной переменной одну из следующих констант, определяемых в заголовке :

;

;

;

(идентично ).

Ошибка

означает, что заданное имя действительно, но у него нет записи типа А. Примером может служить имя узла, имеющего только запись типа MX.

Самые современные распознаватели предоставляют функцию

, которая в качестве единственного аргумента получает значение и возвращает указатель типа на описание ошибки. Некоторые примеры строк, возвращаемых этой функцией, мы увидим в следующем примере.

В листинге 11.1 [1] показана простая программа, вызывающая функцию

для любого числа аргументов командной строки и выводящая всю возвращаемую информацию.

Листинг 11.1. Вызов функции и вывод возвращаемой информации