ETHER_ATON(3)

ИМЯ
ether_aton, ether_ntoa, ether_ntohost, ether_hostton, ether_line, ether_ntoa_r, ether_aton_r - процедуры для работы с адресами ethernet

ОБЗОР
#include <netinet/ether.h>

char *ether_ntoa(const struct ether_addr *addr);

struct ether_addr *ether_aton(const char *asc);

int ether_ntohost(char *hostname, const struct ether_addr *addr);

int ether_hostton(const char *hostname, struct ether_addr *addr);

int ether_line(const char *line, struct ether_addr *addr,
               char *hostname);

/* расширения GNU */
char *ether_ntoa_r(const struct ether_addr *addr, char *buf);

struct ether_addr *ether_aton_r(const char *asc,
                                struct ether_addr *addr);

ОПИСАНИЕ
Функция ether_aton() преобразует 48-битный адрес узла Ethernet asc из стандартной записи в виде шестнадцатеричных-символов-и-двоеточий в двоичный код с сетевым порядком расположения байтов и возвращает указатель на него в статически выделенном буфере, который могут изменить любые последующие вызовы. Функция ether_aton() возвращает NULL, если адрес некорректен.

Функция ether_ntoa() преобразует адрес узла Ethernet addr, заданный значением с сетевым порядком байтов, в строку в стандартной форме записи в виде шестнадцатеричных-символов-и-двоеточий. Строка возвращается в статически выделяемом буфере, который перезаписывается при последующих вызовах.

Функция ether_ntohost() для заданного адреса Ethernet ищет соответствующее имя узла в файле /etc/ethers и возвращает ненулевое значение, если оно не может быть найдено.

Функция ether_hostton() для заданного имени узла ищет соответствующий адрес Ethernet в файле /etc/ethers и возвращает ненулевое значение, если он не может быть найден.

Функция ether_line() обрабатывает строку в формате файла /etc/ethers (адрес Ethernet, пробельный символ, имя узла; комментарий начинается с '#') и возвращает пару адрес/имя узла, или ненулевое значение, если строка не может быть обработана. Буфер, на который указывает hostname, должен быть достаточно большим, чтобы вместить, например, строку line.

Функции ether_ntoa_r() и ether_aton_r() являются безопасными для использования в нитях аналогами ether_ntoa() и ether_aton() соответственно, и не используют статических буферов.

Структура ether_addr определена в <net/ethernet.h>:

struct ether_addr {
    uint8_t ether_addr_octet[6];
}

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
ether_aton(), ether_ntoa() | безвредность в нитях | небезопасно (MT-Unsafe)
ether_ntohost(), ether_hostton(), ether_line(), ether_ntoa_r(), ether_aton_r() | безвредность в нитях | безвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ
4.3BSD, SunOS.

ДЕФЕКТЫ
В glibc 2.2.5 и старее реализация ether_line() некорректна.

СМОТРИТЕ ТАКЖЕ
ethers(5)