Return to ethernet.4 CVS log

Up to [Research Unix] / researchv10dc / man / man4

Annotation of researchv10dc/man/man4/ethernet.4, revision 1.1.1.1

1.1       root        1: .TH ETHERNET 4
                      2: .CT 2 comm_mach
                      3: .SH NAME
                      4: ethernet \(mi Ethernet interface
                      5: .SH SYNOPSIS
                      6: .B #include <sys/enio.h>
                      7: .br
                      8: .B #include <sys/ethernet.h>
                      9: .SH DESCRIPTION
                     10: There are drivers for several hardware interfaces to Ethernet.
                     11: All have the same programming interface.
                     12: .PP
                     13: There are eight software channels for each hardware device.
                     14: A channel sends and receives packets
                     15: for a single Ethernet interface;
                     16: hence eight protocols
                     17: may be used independently on the same device.
                     18: If a channel is open,
                     19: it may not be opened again.
                     20: .PP
                     21: .I Read
                     22: and
                     23: .I write
                     24: deal in Ethernet packets,
                     25: consisting of a header
                     26: followed by no less than 46
                     27: but no more than 1500 bytes of data.
                     28: The header,
                     29: defined in
                     30: .BR <sys/ethernet.h> ,
                     31: is as follows:
                     32: .LP
                     33: .EX
                     34: #define        ETHERALEN       6       /* bytes in an ethernet address */
                     35: 
                     36: struct etherpup {
                     37:        unsigned char dhost[ETHERALEN]; /* destination address */
                     38:        unsigned char shost[ETHERALEN]; /* source address */
                     39:        unsigned short type;    /* protocol type */
                     40: };
                     41: .EE
                     42: .LP
                     43: The protocol type is in the network's byte order,
                     44: most significant byte first.
                     45: .PP
                     46: .I Read
                     47: on a channel returns at most one complete packet.
                     48: If only part of a packet fits in the
                     49: .I read
                     50: buffer,
                     51: successive reads return the remainder.
                     52: .I Write
                     53: should be given a single complete packet;
                     54: .B dhost
                     55: and
                     56: .B type
                     57: must be filled in.
                     58: The system supplies
                     59: .BR shost .
                     60: .PP
                     61: There are a few
                     62: .I ioctl
                     63: calls,
                     64: defined in
                     65: .BR <sys/enio.h> :
                     66: .TP "\w'ENIOTYPE 'u"
                     67: .B ENIOTYPE
                     68: The third argument
                     69: points to a short integer;
                     70: use that as the protocol type for this channel.
                     71: .TP
                     72: .B ENIOADDR
                     73: The third argument
                     74: points to a six-character buffer;
                     75: copy the hardware address of this interface there.
                     76: .PP
                     77: Minor device numbers
                     78: 0-7
                     79: are the eight channels of the first hardware device
                     80: of a given type;
                     81: 8-15 are the second device,
                     82: and so on.
                     83: File names usually end in two digits,
                     84: like
                     85: .B /dev/il13
                     86: for the fourth channel of the second Interlan device.
                     87: .SH FILES
                     88: .TF /dev/bna??
                     89: .TP
                     90: .F /dev/il??
                     91: Interlan NI1010A devices
                     92: .TP
                     93: .F /dev/qe??
                     94: DEQNA devices
                     95: .TP
                     96: .F /dev/bna??
                     97: DEBNA devices
                     98: .SH SEE ALSO
                     99: .IR internet (3),
                    100: .IR ipconfig (8)
                    101: .SH BUGS
                    102: The DEQNA driver
                    103: fills in the protocol type field
                    104: in transmitted packets;
                    105: other drivers don't.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.