NAME

netload − download TCP/IP protocol module to EXOS board

SYNOPSIS

netload [ −d ] [ −h host ] [ −E ENET_addr ] [ −t n ] [ −m ] [ −r n ]
[ −x n ] [ −p n ] [ i ] [ net_file ]

DESCRIPTION

netload loads net_file onto the EXOS Ethernet front-end processor board.  net_file is the EXOS 8010 TCP/IP protocol module, which is supplied by Excelan in executable object format. 

If no options are specified, netload configures TCP/IP with the following defaults:

•Debug messages are not printed. 

•The /etc/hosts is checked for a host with the name or alias localhost; this name is used for the host’s Internet address. 

•The Ethernet address supplied by the board’s is used. 

•The on-board TELNET/rlogin server is enabled and supports eight connections. 

•ARP is enabled. 

•The maximum number of simultaneous blocking host requests supported is 66. 

•A minimum of 10 (more on boards with 256 or 512 Kbytes of RAM) extended memory buffers are allocated. 

•The protocol module found at /etc/net/net is loaded. 

OPTIONS

−d Prints debugging messages. 

−h host
Supplies an explicit host name or Internet address.  If host begins with a digit, netload attempts to convert it to an Internet address in standard “dot” format.  Otherwise, it tries to look up a host by this name in the /etc/hosts file and uses the Internet address therein. 

−E ENET_addr
Supplies an Ethernet address, which is used instead of the board’s default address (supplied by Excelan). This should be specified in the customary Ethernet format, as six hexadecimal numbers separated hyphens (-). For example, 08-00-14-E0-2A-56.

−t n Specifies how many TELNET/rlogin connections to support via the on-board telnet/rlogin server.  n must be a number between 0 and 8.  If 0, then the server is disabled and these protocol servers may be implemented on the host system. 

−m Disables ARP and enables mapping of Ethernet to Internet addresses as was done in 4.1BSD (lower three bytes of Ethernet address become the host part of the Internet address).  The -E option can be used to emulate another Ethernet vendor’s address block, and the -h option can be used to specify a network number other than the default (89 decimal). 

−r “ n”
Specifies how many simultaneously blocking host requests will be supported. This number cannot exceed 127, and should usually be at least as great as the maximum expected number of connections.

−x “ n”
Specifies how many extended memory buffers will be allocated. A minimum of 10 are always allocated, regardless of the requested number.  For 128 Kbyte EXOS boards, specifying a larger number can improve bulk transfer performance, but may affect operation when a great many (more than 32) connections are required.

−p n Sets the level of diagnostic messages from the board that the host displays.  The level is determined by the value of n, as follows:

LevelTypes of Messages
   1All
  2Errors that are benign (such as retransmissions)
or more severe (default)
  3Errors that are nonfatal (such as bad host-requests)
or more severe
  4Fatal errors, such as NX call failures

−i Disables the timeout feature of netload.  Normally, netload times out one minute after the board is reset and the diagnostics are unsuccessful or if an initialization message to the board is unsuccessful.  The −i  option is useful for debugging the board’s processor or when using an emulator. 

FILES

/etc/net/netTCP/IP protocol module
/dev/EXOS/xmemdevice driver for downloading
/etc/hostshost name/Internet address database

SEE ALSO

xmem(7), net(7P), hosts(4)

Version 2.4  —  May 08, 1986