nwdiscover(1Mipx)

nwdiscover -- display and set IPX network attributes

Synopsis

nwdiscover [-a] [-f frame_type] [-r retry_count] [-t timeout] [-d pathname] [-v] [-u] [-e frame_type]

Description

Use nwdiscover on the UnixWare command line to:

discover IPX network characteristics
set the IPX network configuration

Options

-a

Check all frame types and device types, even if there is a response from a NetWare server.

If set with the -u option, any existing configuration is erased, all networks discovered are configured, and the ipx_auto_discovery flag is turned off.

-f frame_type

Query the network to see if a NetWare server is responding to messages of the specified frame type.

Default: Try all frame types.

If -u is set, this frame type is configured even if no network information is discovered.

-r retry_count

Specify the retry count when there is no response from the network.

Default: 2.

-t timeout

Specify the number of seconds for a timeout.

Default: 3.

A value of zero indicates 0.5 second.

-d pathname

Specify a pathname to the network device driver.

Default: the value of the first network returned by the nwinfo command (see nwinfo(1Mnws)).

-v

View in verbose mode. Information is sent to stdout.

-u

Update the NetWare configuration file (/etc/netware/nwconfig).

If this option is on, the configuration file is updated with the frame type, the device name, and the network address.

-e frame_type

Exclude searching the specified frame type. This option can be used multiple times.

Usage

You must be the root user to use nwdiscover.

The nwdiscover command discovers the network number, the frame type, and the device of connected IPX networks. It does this by generating two Service Access Protocol (SAP) Get Nearest Server (GNS) requests to the network, and evaluating the results.

The first message is a service request message for NetWare servers; the second is a service request message for UnixWare servers.

If there is no response to the server request messages, an IPX Router Information Protocol (RIP) message is sent requesting information on all networks.

If a response is received to any of the messages, nwdiscover extracts the network and frame type from the reply. If the -u option is set, the NetWare configuration file information is updated.

The network information is sent to stdout.

If an IPX network is already configured via nwcm, it is discovered first by nwdiscover.

If no reply is received to any of the request messages, nwdiscover uses the information already configured, or if nothing is configured, it invents a network number, configures the specified frame type, and configures the specified device.

References

nwcm(1Mipx)

Examples

To check all frame types, update configuration files, and turn off boot-up auto-discovery, enter:

nwdiscover -au

To try discovery using the specified device /dev/NE2000_0, enter:

nwdiscover -d /dev/NE2000_0

To configure an Ethernet II network, even if it is not used on your network, enter:

nwdiscover -f ETHERNET_II -u

To determine what networks are connected to your platform, enter:

nwdiscover -av