CETI(4,F)                   AIX Technical Reference                   CETI(4,F)



-------------------------------------------------------------------------------
ceti



PURPOSE

Supports the CETI network device driver.

SYNOPSIS

#include <sys/devinfo.h>
#include <sys/b370/ceti.h>

DESCRIPTION

The ceti device driver is used to drive to the 9370 Integrated Ethernet
Adapter, the Intel Fastpath Ethernet Adapter, and other ethernet adapters that
conform to the CETI interface specification.  This driver is unique to AIX/370.

Since the supported device is a LAN network interface, normal network traffic
is transmitted and received using the socket interface and not the device
interface.  The device interface is used only to monitor and control the
operation of the device, via ioctl commands.

The device used to perform this monitor and control is /dev/ceti#, where # is
the device minor number.

There is a small number of IOCTL operations available besides the standard
IOCTYPE and IOCINFO commands.  They are:

DIOCONLINE
        Bring the device on-line.

             ioctl(fd, DIOCONLINE, arg)
             char *arg

        The argument is ignored.

DIOCOFFLINE
        Take the device off-line.

             ioctl(fd, DIOCOFFLINE, arg)
             char *arg

        The argument is ignored.

CIOGETSTATS
        Return device statistics.

             ioctl(fd, CIOGETSTATS, arg)
             struct ceti_lstat *arg;



Processed November 7, 1990         CETI(4,F)                                  1

CETI(4,F)                   AIX Technical Reference                   CETI(4,F)




        where struct ceti_lstat is declared as:

            struct ceti_lstat {
                ulong received;          /* # of frames received */
                ulong transmitted;       /* # of frames transmitted */
                ulong lost;              /* # of frames lost */
                ulong runts;             /* # of runt frames */
                ulong crcerrs;           /* # of frames with crc errors */
                ulong collisions;        /* # of frames in collision */
                ulong multicast;         /* # of multicast frames */
                ulong broadcast;         /* # of broadcast frames */
                ulong not_ours;          /* # of frames not for us */
                ulong multi_not_ours;    /* # of multicast frames not for us */
                ulong excess_collisions; /* # of excessive collisions */
                ulong out_of_window;     /* # of out-of-window collisions */
                ulong alignment;         /* # of alignment errors */
                ulong shorted;           /* # of times a short was detected */
                ulong reflectometer;     /* # of reflectometer packets */
                ulong too_long;          /* # of frames that were too long */
             };

CEREPCTL
        Control the VM EREP logging.

             ioctl(fd, CEREPCTL, arg)
             struct ceti_erep_ctl *arg;

        where struct ceti_erep_ctl is declared as:

            struct ceti_erep_ctl {
                unsigned char obr_thresh;
                unsigned char mdr_thresh;
                unsigned char obr_cnt;
                  /* current log control count returned here */
                unsigned char mdr_cnt;
                  /* current log control count returned here */
            };

        If a threshold is 0, no EREP logging is done.  If set to 0xff, no
        change to the current state is made.  Otherwise, logging set to occur
        every nth occurrence, where n is the number specified.

RELATED INFORMATION

In this book: "ioctlx, ioctl, gtty, stty" and "open, openx, creat."









Processed November 7, 1990         CETI(4,F)                                  2