il(4) [bsd man page]

IL(4)							     Kernel Interfaces Manual							     IL(4)

NAME

       il - Interlan NI1010 10 Mb/s Ethernet interface

SYNOPSIS

       /sys/conf/SYSTEM:
	    NIL  il_controllers # Interlan Ethernet

DESCRIPTION

       The il interface provides access to a 10 Mb/s Ethernet network through an Interlan 1010 or 1010A controller.

       Each  of the host's network addresses is specified at boot time with an SIOCSIFADDR ioctl.  The il interface employs the address resolution
       protocol described in arp(4P) to dynamically map between Internet and Ethernet addresses on the local network.

       The interface normally tries to use a ``trailer'' encapsulation to minimize copying data on input and output.  The use of trailers is nego-
       tiated  with  ARP.   This  negotiation  may  be disabled, on a per-interface basis, by setting the IFF_NOTRAILERS flag with an SIOCSIFFLAGS
       ioctl.

DIAGNOSTICS

       il%d: input error.  The hardware indicated an error in reading a packet off the cable or an illegally sized packet.

       il%d: can't handle af%d.  The interface was handed a message with addresses formatted in an  unsuitable	address  family;  the  packet  was
       dropped.

       il%d: setaddr didn't work.  The interface was unable to reprogram its physical ethernet address.  This may happen with very early models of
       the interface.  This facility is used only when the controller is not the first network interface configured for XNS.  The oldest interface
       tested (2.7.1.0.1.45) has never failed in this way.

       The  following  messages  indicate a probable hardware error performing the indicated operation during autoconfiguration or initialization.
       The status field in the control and status register (the low-order four bits) should indicate the nature of the failure.  See the  hardware
       manual for details.

       il%d: reset failed, csr=%b.

       il%d: status failed, csr=%b.

       il%d: hardware diag failed, csr=%b.

       il%d: verifying setaddr, csr=%b.

       il%d: stray xmit interrupt, csr=%b.

       il%d: can't initialize.

SEE ALSO

       intro(4N), inet(4F), arp(4P)

3rd Berkeley Distribution					  August 20, 1987							     IL(4)

te(7)							 Miscellaneous Information Manual						     te(7)

NAME

       te - TGEC Ethernet interface

SYNOPSIS

       config_driver te

DESCRIPTION

       The te interface provides access to a 10 Mb/s Ethernet network through the TGEC controller.

       The  host's Internet address is specified at boot time with an SIOCSIFADDR ioctl.  The te interface employs the address resolution protocol
       described in arp(7) to map dynamically between Internet and Ethernet addresses on the local network.

       The SIOCSPHYSADDR ioctl can be used to change the physical address of the TGEC.	The SIOCRPHYSADDR ioctl can be used to read  the  physical
       address of the TGEC.

       The  SIOCADDMULTI  and SIOCDELMULTI ioctls can be used to add or delete multicast addresses.  The TGEC recognizes a maximum of 12 multicast
       addresses.

       The SIOCRDCTRS and SIOCRDZCTRS ioctls can be used to read or ``read and clear'' the Ethernet driver counters.  The argument  to	these  two
       ioctls is a pointer to a counter structure, ctrreq, found in <net/if.h>.

       The SIOCENABLBACK and SIOCDISABLBACK ioctls can be used to enable and disable the interface loopback mode respectively.

EXAMPLES

       To  obtain  the	physical  address  of  the  adapter,  use  the SIOCRPHYSADDR ioctl as in the following program example: #include <stdio.h>
       /* standard I/O */ #include <errno.h>		  /* error numbers */ #include <sys/socket.h>	      /* socket  definitions  */  #include
       <sys/ioctl.h>	      /* ioctls */ #include <net/if.h>		   /* generic interface structures */

       main() {
	 int s,i;
	 struct  ifdevea  devea;
	 /* Get a socket */
	 s = socket(AF_INET,SOCK_DGRAM,0);
	 if (s < 0) {
	    perror("socket");
	    exit(1);
	 }
	 strcpy(devea.ifr_name,"te0");
	 if (ioctl(s,SIOCRPHYSADDR,&devea) < 0) {
	    perror(&devea.ifr_name[0]);
	    exit(1);
	 }
	 printf("Address is ");
	 for (i = 0; i < 6; i++)
	    printf("%X ", devea.default_pa[i] & 0xff);
	 printf("
");
	 close(s); }

       To  enable external loopback, use the SIOCENABLEBACK ioctl as in the following program example: #include <stdio.h>	       /* standard
       I/O */ #include <errno.h>	      /* error numbers */ #include <sys/socket.h>	  /* socket definitions */ #include  <sys/ioctl.h>
       /* ioctls */ #include <net/if.h> 	    /* generic interface structures */

       main() {
	 int s;
	 struct  ifreq	data;
	 /* Get a socket */
	 s = socket(AF_INET,SOCK_DGRAM,0);
	 if (s < 0) {
	    perror("socket");
	    exit(1);
	 }
	 strcpy(data.ifr,"te0");
	 if (ioctl(s,SIOCENABLEBACK,&data) < 0) {
	    perror("SIOCENABLEBACK:");
	    exit(1);
	 }
	 close(s); }

ERRORS

       The diagnostic error messages contain relevant information provided by the TGEC.  The interface was handed a message with addresses format-
       ted in an unsuitable address family, and the packet was dropped.  The TGEC hardware failed to reset itself properly.  The driver's  attempt
       to  allocate  a	buffer failed.	The driver's attempt to allocate a buffer failed.  Too many multicast requests have been made.	The shared
       memory block for the TGEC's local RAM buffer is missing from the CMOS configuration data.

RELATED INFORMATION

       arp(7), inet(7), netintro(7) delim off

																	     te(7)