forsyth20121205-174063a80cc13 years agoHistory
77 lines · 1.6 KB · Text
RawDownload
.TH ETHER 2.SH NAMEether \- Ethernet address manipulation.SH SYNOPSIS.EXinclude "ether.m";ether := load Ether Ether->PATH; Eaddrlen:	con 6; init:   fn();parse:  fn(s: string): array of byte;text:   fn(a: array of byte): string;addressof:  fn(dev: string): array of byte;eqaddr: fn(a, b: array of byte): int;.SH DESCRIPTION.B Etherprovides a small set of functions that manipulate Ethernet MAC addresses,for the use of the few applications such as.IR bootpd (8)that must work with them..PP.B Initmust be called before using any other function in the module..PP.B Parsetakes a textual representation of a MAC address in.I sand returns its internal representation as an array of bytes of length.BR Eaddrlen ,the form used in packets read and written via.IR ether (3)..I Sis a string of twelve hexadecimal digits, corresponding to the six bytes of a MAC address.Each pair of digits can optionally be separated by a colon.If.I sis invalid,.B parsereturns nil..PP.B Texttakes an array of bytes of length.B Eaddrlenand returns its textual representation (a string of twelve hexadecimal digits).It returns.LR <invalid>if the array is less than.BR Eaddrlen ,but it ignores any bytes beyond that..PP.B Addressofreturns the MAC address of the given Ether device.I dev(eg,.LR /net/ether0 ),which it reads from.IB dev /addr .It returns nil and sets the error string if that file does not exist or is invalid..PP.B Eqaddrreturns true iff.I aand.I bare the same address..SH FILES.TF /net/etherN/addr.TP.IB net /ether N /addrhardware address of Ether.I N.SH SOURCE.B /appl/lib/ether.b.SH SEE ALSO.IR ip (2),.IR ether (3)