NAME

e1x7cntl − MVME1X7 LAN interface control utility

SYNOPSIS

e1x7cntl [-?] [{-c cntlr_num | -d dev_name}] [-l level]
command ... 

where command is one of:

{ clrstats | fru | reset | dump | rev }

DESCRIPTION

The e1x7cntl command is a central control utility for the MVME1X7 on-board Local Area Network interface (or e1x7).  The user level command interacts with the e1x7(7) STREAMS driver via defined ioctl(2) commands.  The miscellaneous controls available usually get or set information in the e1x7 driver.  These actions, and their results, are provided to aide system administration and analysis. 

OPTIONS

The user may issue the following options on the e1x7cntl command line:

-? Help flag. 
This flag will display a brief usage message to the user, yet offering enough information for the advanced user to run the command properly.

-c cntlr_num
Specify the controller number of the e1x7 device on which the commands are to be run. 
(default: 0)

-d dev_name
Specify the device name (path) of the e1x7 device on which the commands are to be run. 
(default: /dev/e1x7_c0) NOTE: The -c and -d options are mutually exclusive; more specifically they provide the same information using a slightly different syntax. 

-l level
Specify the log level of the e1x7 device.  When this option is provided to e1x7cntl there is an implicit command that is going to be executed that will send this value as a parameter down to the driver.  (This is the only method of accessing this particular command, as it does require a parameter.) 
(range: 0-3)

Command Keywords

An indication of the success or failure of a given command will always be displayed on stdout. 
The command keywords and definitions are as follows:

clrstats The clrstats command will issue an MACIOC_CLEARSTATS ioctl to the e1x7 driver.  The driver will then zero-out all of the hardware and software statistics for the interface.  The results are easily seen by requesting the statistics with the ifstat(1M) command. 

fru The fru command will gather the FRU status for the e1x7 driver.  In this case, the command does not use an ioctl method of accessing this information.  Instead, it uses the standard sysm88k(2) system call.  The data returned by the driver is formatted nicely for display. 

reset The reset command will issue an E1X7IOC_RESET ioctl to the e1x7 driver.  The driver will then reset itself by reinitializing data structures and the hardware, and restart from a clean state. 

dump The dump command will issue an E1X7IOC_DUMP ioctl to the e1x7 driver.  The driver will then issue a similar command to the LANC chip (see NOTES), which will fill a provided buffer with its registers and other context.  The data returned by the driver is output in its raw form for display. 

rev The rev command will issue an E1X7IOC_DUMP ioctl to the e1x7 driver as well.  The driver will provide the same data as in the dump command described above.  However, in this case the data returned by the driver is first parsed to extract the revision of the LANC chip.  The revision is then formatted nicely for display. 

EXAMPLES

The e1x7cntl utility is simple and straight forward to use.  To illustrate this fact, the following few examples are provided:

e1x7cntl -d /dev/e1x7_c0 clrstats

The above command invokes the e1x7cntl utility using the provided device on which to run the command and it requests that the clrstats command be executed. 

m376cntl -c0 -l2 fru

The above command invokes the m376cntl utility to run commands on controller 0 (zero, which happens to be the default).  In this case, there will be two commands run in sequence.  First the log level command, because the -l option was given.  The level to set will be 2.  This implicit command is followed by the fru command.  The result of both commands will be displayed individually. 

e1x7cntl reset

The above command invokes the e1x7cntl utility using the default device and it requests that the reset command be executed. 

e1x7cntl dump rev

The above command invokes the e1x7cntl utility to run commands on default device.  In this case, there will be two commands run in sequence.  First the dump command, followed by the rev command. 

SEE ALSO

e1x7diag(1M), frustat(1M), ifstat(1M),
sysm88k(2),
e1x7(7)

DIAGNOSTICS

If e1x7cntl terminates normally, it displays a message that indicates whether the requested command(s) passed or failed, and then exits with a 0 status.  If e1x7cntl does not terminate normally, it displays a message to stderr and returns a non-zero exit status to indicate an error. 

NOTES

The Intel 82596 LAN Controller (or "LANC") is a chip used on the MVME1X7 single board computer.  The LANC chip provides the networking interface for IEEE 802.3 and ethernet type networks.  The e1x7 STREAMS driver supports more than one interface, but at the moment, it is only possible to have one hardware device per system.  Because this is the case, the -c and -d options are not required, as the default controller number and the default device name are the only possible choice.  These options are merely present now to support the full capabilities of the driver, should they ever be realized by hardware. 
 

  —  ENET1X7 Control Utility