NAME

m376cntl − MVME376 LAN interface control utility

SYNOPSIS

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

where command is one of:

{ clrstats | fru | reset }

DESCRIPTION

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

OPTIONS

The user may issue the following options on the m376cntl 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 m376 device on which the commands are to be run. 
(default: 0)

-d dev_name
Specify the device name (path) of the m376 device on which the commands are to be run. 
(default: /dev/m376_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 m376 device.  When this option is provided to m376cntl there is an implicit command that is going to be executed that will send this value as a parameter down to the driver. 
(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 m376 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 m376 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 M376IOC_RESET ioctl to the m376 driver.  The driver will then reset itself by reinitializing data structures and the hardware, and restart from a clean state. 

EXAMPLES

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

m376cntl -d /dev/m376_c1 clrstats

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

m376cntl -c2 -l2 fru

The above command invokes the m376cntl utility to run commands on controller two.  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. 

m376cntl reset

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

SEE ALSO

m376diag(1M), frustat(1M), ifstat(1M),
sysm88k(2),
m376(7)

DIAGNOSTICS

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

  —  MVME376 Control Utility