nwdiscover(1M) nwdiscover(1M)
NAME
nwdiscover - discover and set IPX network configuration
SYNOPSIS
nwdiscover [-auv] [-d pathname] [-e frame_type] [-f
frame_type] [-r retry_count] [-t timeout]
DESCRIPTION
The nwdiscover command "discovers" the network number, frame
type, and 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 network information is sent to stdout.
You must be a privileged user to use nwdiscover.
If an IPX network is already configured via nwcm(1M), it is
"discovered" first by nwdiscover.
If the -d option is not given to the command, nwdiscover calls
the netinfo(1M) command to determine the network device(s)
configured. If the -d option is given, it specifies the
device to use for discovery.
Auto-Discovery with No Specified Frame Type
If no -f option is specified, nwdiscover next sends a Get
Nearest Server (GNS) request for the two server types (NetWare
and UnixWare) using frame types Ethernet 802.2, Ethernet II,
Ethernet SNAP, and Ethernet 802.3, respectively. For token
ring networks, frame types Token Ring, and Token Ring SNAP are
used.
If no response is received for any frame type on a device,
nwdiscover tries the next device.
The search for a frame type concludes when the first response
is returned from a server on the network, or no more devices
exist. If no response is received, the nwdiscover command
uses the information already configured; if nothing is
configured, it invents a network number, sets the frame type
to Ethernet 802.2, and configures the first device returned by
the netinfo command.
Auto-Discovery with Specified Frame Type
The -f option specifies the frame type to use for discovery.
If given, auto discovery of the network is done using the
Copyright 1994 Novell, Inc. Page 1
nwdiscover(1M) nwdiscover(1M)
specified parameters. The following describes that scenario.
The first message is a service request message for NetWare
file servers; the second is a service request message for
UnixWare file servers. If there is no response to the file
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.
If no reply is received to any of the request messages, the
nwdiscover command uses the information already configured, or
if nothing is configured, it invents a network number,
configures the specified frame type, and configures the
device.
Options
The options for nwdiscover are:
-a Check all frame types and device types, even if there is
a response from a server. If used with the -u option,
any existing configuration is erased, all networks
discovered are configured, and the ipx_auto_discovery
parameter is set to inactive [see nwcm(1M)].
-d pathname
Use only the specified pathname as the network device
driver. The default is the first device returned by the
netinfo command.
-e frame_type
Exclude searching the specified frame type. This option
can be used multiple times.
-f frame_type
Query the network to see if there is a server responding
to messages of the specified frame type (default is to
try all frame types). If the -u option is set, this
frame type is configured even if no network information
is discovered.
Copyright 1994 Novell, Inc. Page 2
nwdiscover(1M) nwdiscover(1M)
-r retry_count
When there is no response from the network, retry the
specified number of times. The default is 2.
-t timeout
Timeout after the specified number of seconds. The
default is 3 seconds. A value of zero indicates 1/2
second.
-u Update the NetWare configuration file
(/etc/netware/nwconfig). If this option is on, the
configuration file is updated with the frame type,
device name, and network address.
-v Verbose mode. When turned on, debugging information is
sent to stdout.
EXAMPLES
To check all frame types, update configuration files, and turn
off boot-up auto-discovery:
nwdiscover -au
To try discovery using the specified device /dev/NE2000_0:
nwdiscover -d /dev/NE2000_0
To configure an Ethernet II network, even if Ethernet II is
not used on your network:
nwdiscover -f ETHERNET_II -u
To determine what networks are connected to your platform:
nwdiscover -av
FILES
/etc/netware/nwconfig NetWare configuration file
SEE ALSO
nwcm(1M), netinfo(1M).
Copyright 1994 Novell, Inc. Page 3