НАИМЕНОВАНИЕ¶

getipnodebyname, getipnodebyaddr, freehostent - возвращают сетевые имена и адреса машины

БИБЛИОТЕКА¶

Стандартная библиотека языка C (libc, -lc)

ОБЗОР¶

#include <sys/types.h>
#include <sys/socket.h>
#include <netdb.h>

[[deprecated]] struct hostent *getipnodebyname(const char *name, int af,
                                            int flags, int *error_num);
[[deprecated]] struct hostent *getipnodebyaddr(const void addr[.len],
                                            size_t len, int af,
                                            int *error_num);
[[deprecated]] void freehostent(struct hostent *ip);

ОПИСАНИЕ¶

Эти функции устарели (и недоступны в glibc). Используйте вместо них функции getaddrinfo(3) и getnameinfo(3).

Функции getipnodebyname() и getipnodebyaddr() возвращают имена и адреса машины в сети. Эти функции возвращают указатель на следующую структуру:

struct hostent {


    char  *h_name;


    char **h_aliases;


    int    h_addrtype;


    int    h_length;


    char **h_addr_list;
};

Эти функции заменяют функции gethostbyname(3) и gethostbyaddr(3), которые могут возвращать только сетевые адреса семейства IPv4. Функции getipnodebyname() и getipnodebyaddr() могут осуществлять доступ к нескольким семействам сетевых адресов.

В отличие от функций gethostby эти функции возвращают указатели на динамически выделяемую память. Функция freehostent() используется для освобождения динамически выделенной памяти после того, как надобность в структуре hostent отпадёт.

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

При ошибке возвращается NULL, а в error_num будет содержаться код ошибки из следующего списка:

HOST_NOT_FOUND

Имя узла или сетевой адрес не найдены.

NO_ADDRESS

Сервер доменных имён распознал сетевой адрес или имя, но не ответил. Это может произойти, если сетевой узел имеет только адреса IPv4, а запрашивалась информация об IPv6, или наоборот.

NO_RECOVERY

Сервер доменных имён возвратил сообщение о постоянной ошибке.

TRY_AGAIN

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

При выполненном запросе возвращается указатель на структуру hostent, содержащую следующие поля:

h_name

Официальное имя данного сетевого узла.

h_aliases

Массив указателей на неофициальные псевдонимы этого же узла. Массив оканчивается указателем null.

h_addrtype

Копия параметра af вызова getipnodebyname() или getipnodebyaddr(). Значение h_addrtype всегда равно AF_INET, если значение af равно AF_INET. Значение h_addrtype всегда равно AF_INET6, если значение af равно AF_INET6.

h_length

Это поле равно sizeof(struct in_addr), если h_addrtype равно AF_INET, и sizeof(struct in6_addr), если h_addrtype равно AF_INET6.

h_addr_list

Массив из одного или нескольких указателей на структуры сетевого адреса для сетевого узла. Массив оканчивается указателем null.

СТАНДАРТЫ¶

RFC 2553.

ПРИМЕЧАНИЯ¶

Эти функции существовали в glibc 2.1.91-95, но были удалены. Некоторые UNIX-подобные системы поддерживают их, но все эти вызовы устарели.

СМОТРИТЕ ТАКЖЕ¶

getaddrinfo(3), getnameinfo(3), inet_ntop(3), inet_pton(3)

ПЕРЕВОД¶

Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.