ether_aton(3) | Library Functions Manual | ether_aton(3) |
NUME
ether_aton, ether_ntoa, ether_ntohost, ether_hostton, ether_line, ether_ntoa_r, ether_aton_r - rutine de manipulare a adreselor ethernet
BIBLIOTECA
Biblioteca C standard (libc, -lc)
SINOPSIS
#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);
/* Extensii 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);
DESCRIERE
ether_aton() convertește adresa gazdei Ethernet pe 48 de biți asc din notația standard digiți-hexazecimali și două puncte în date binare în ordinea octeților de rețea și returnează un indicator către aceasta într-o memorie tampon alocată static, pe care apelurile ulterioare o vor suprascrie. ether_aton() returnează NULL în cazul în care adresa nu este validă.
Funcția ether_ntoa() convertește adresa gazdei Ethernet addr dată în ordinea octeților de rețea într-un șir de caractere în notație standard hexazecimală cu cifre și două puncte, omițând zerourile din față. Șirul este returnat într-o memorie tampon alocată static, pe care apelurile ulterioare o vor suprascrie.
Funcția ether_ntohost() asociază o adresă Ethernet cu numele de gazdă corespunzător din /etc/ethers și returnează un număr diferit de zero dacă acesta nu poate fi găsit.
Funcția ether_hostton() asociază un nume de gazdă cu adresa Ethernet corespunzătoare din /etc/ethers și returnează un număr diferit de zero dacă aceasta nu poate fi găsită.
Funcția ether_line() analizează o linie în formatul /etc/ethers (adresa ethernet urmată de spații albe urmate de numele de gazdă; „#” introduce un comentariu) și returnează o pereche de adresă și nume de gazdă, sau un număr diferit de zero dacă nu poate fi analizată. Memoria tampon indicată de hostname trebuie să fie suficient de mare, de exemplu, să aibă aceeași dimensiune cu line.
Funcțiile ether_ntoa_r() și ether_aton_r() sunt versiuni reentrante și sigure pentru fire de execuție ale funcțiilor ether_ntoa() și, respectiv, ether_aton() și nu utilizează memorii tampon statice.
Structura ether_addr este definită în <net/ethernet.h> ca:
struct ether_addr { uint8_t ether_addr_octet[6]; }
ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).
Interfață | Atribut | Valoare |
ether_aton(), ether_ntoa() | Siguranța firelor | MT-Unsafe |
ether_ntohost(), ether_hostton(), ether_line(), ether_ntoa_r(), ether_aton_r() | Siguranța firelor | MT-Safe |
STANDARDE
Niciunul.
ISTORIC
4.3BSD, SunOS.
ERORI
În glibc 2.2.5 și versiunile anterioare, implementarea lui ether_line() este defectă.
CONSULTAȚI ȘI
TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>
Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.
Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.
2 mai 2024 | Pagini de manual de Linux 6.9.1 |