Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   ether_aton - ether_line,

ether_aton(3) ether_line,


ОБЗОР

#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() некорректна.