NAME

omninet − Interphase Network Coprocessor network query and administration

SYNOPSIS

/usr/etc/omninet [ −V ] [ −v ] [ −t target [ −c counter ] ] [ −e ] [ −s [ parameter [ value | default ] ] ]
[ device ]

AVAILABILITY

This command is available from the Interphase Network Coprocessor (NC) software distribution.  For information about installing the NC software distribution, refer to the Network Coprocessor Installation Manual. 

DESCRIPTION

omninet tests whether the Network Coprocessor  is present in the system.  Shell scripts use omninet when the Network Coprocessor availability needs to be tested. Without options, omninet does not display anything and only returns an exit status value.  Additionally, by using options, the command may interactively administer various Network Coprocessor configuration parameters. 

device is an optional parameter that identifies a Network Coprocessor device.  It may use one of the two following forms: /dev/ne0 or ne0.  Up to eight Network Coprocessor interfaces may be installed depending on the configuration of the system. Device names range from ne0 to ne7.  For information on how many Network Coprocessors are supported on a given machine type and configuration, refer to the READ_ME_FIRST or RMF document packaged with your product. 

With no options and no specified device, omninet returns a zero exit status value if the kernel has built-in Network Coprocessor support; otherwise an exit status value of one is returned.  When a device is specified, the returned exit status value similarly indicates the operational status of the device. 

Options are used to display or set device specific configuration parameters. A list of these parameters and their current values may be displayed using the −s option without a parameter name. 

OPTIONS

−V Returns Network Coprocessor version information. 

−v Prints a descriptive message in addition to setting the exit status. 

−t Specifies a target Ethernet address in target for transmit rate control.  When used with the −c option, this option  specifies a minimum delay between packets sent to the target Ethernet address. This option allows more reliable transmission to hosts which are slow or congested. 

−c Specifies the minimum delay counter for consecutive packets being sent by the Network Coprocessor to the address specified in the −t option.  counter specifies the amount of time to wait. A value of 1 is approximately equal to a delay of .08 milliseconds.  Valid values range between 0 and 100.  A value of 0 turns off the delay counter for subsequent back to back transmission by the Network Coprocessor.  The default value of 50 corresponds to a transmission rate of 250 packets per second.  This switch must be used with the the −t option. 

−e Prints the ethernet address of the specified device or the system default Network Coprocessor device if no device is specified. 

−s Returns the names and values of all configuration parameters or of the specified parameter when no value is provided; otherwise sets the specified parameter to the given value.  If “default” is specified, the parameter is set to its default value. 

FILES

/dev/ne[0-7] Network Coprocessor interfaces

EXIT STATUS

0 Success or Network Coprocessor support.  If a device name was specified, the zero exit status value indicates kernel support for this Network Coprocessor and that with this Network Coprocessor device is present, loaded and operational (see neload(8) ). 

1 Error or no Network Coprocessor support.  If a device name was specified, this exit status value indicates that the device has been recognized by the kernel but is not in an operational state. 

2 Error or no Network Coprocessor support.  This exit status value may appear only when a device name was specified on the command line; this exit status value indicates that the device does not exist or has not been recognized by the kernel. 

SEE ALSO

ne(4), neload(8), nestop(8), newatch(8)

Network Coprocessor Installation Manual

NOTES

Currently identified Network Coprocessor configuration parameters are: onboardnfs, nfsretryfilt, and cachesource. 

The following command is used to disable NFS processing on the ne0 Network Coprocessor device:

omninet −s onboardnfs 0 ne0

In this configuration, the Network Coprocessor board is only used as an Ethernet datalink controller. By default NFS processing is enabled on the Network Coprocessor. 

The following command is used to disable Network Coprocessor NFS retry filtering on the ne0 Network Coprocessor device:

omninet −s nfsretryfilt 0 ne0

NFS retry filtering avoids further overloading the server with duplicate NFS requests in the case of high load and slow server response. By default NFS retry filtering is enabled on the Network Coprocessor. 

The following command is used to enable full Network Coprocessor IP routing on the ne0 Network Coprocessor device:

omninet −s cachesource 0 ne0

By default, the Network Coprocessor caches the source Ethernet address of the machine (client or IP gateway) sending an NFS request and sends the NFS reply back to this address. This technique speeds up processing and is appropriate for most installations. Nonetheless, some installations with a complex internetwork may choose to configure their gateways in such a way that an NFS reply should not return to the gateway from which the NFS request arrived.  The above command is provided in that case to configure the Network Coprocessor to make full use of its IP routing table and ARP cache, to find the appropriate gateway where the NFS reply should be sent. 

Interphase Corp.  —  Last change: 21 January 1991