NAME

newatch − Sun Network CoProcessor Watchdog and Uploader

SYNOPSIS

newatch [ −h ] [ −d directory name ] [ −r reload script ] device

AVAILABILITY

This command is available from the Sun Network CoProcessor (NC) software distribution. It is specific to this product.  For information about installing the NC software distribution, refer to the Network CoProcessor Installation Manual. 

DESCRIPTION

newatch monitors the “heartbeat” of the Network CoProcessor specified with the device argument. This argument may be expressed in one of the following two forms: /dev/ne0 or ne0.  Up to six Network CoProcessor interfaces may be installed depending on the configuration of the system. Device names range from ne0 to ne5. 

In case newatch detects a failure on the Network CoProcessor, it uploads the memory contents of the Network CoProcessor board into three files located by default in the directory /var/crash/SNC.  The three files containing the uploaded memory image can be created in a different location in the file system by using the −d option. The three created files are named prog.ne?.nn, buff.ne?.nn, and shio.ne?.nn, where ‘?’ is a unit number between 0 and 5.  They respectively hold the contents of the program memory, the buffer memory, and the VME shortio space memory of the Network CoProcessor.  The trailing .nn in the file names is replaced by a number which grows every time newatch uploads an image into the same directory. 

Upon completion of the Network CoProcessor image upload, newatch will attempt to execute a shell script to reload and reinitialize the Network CoProcessor interface for continued operation.  If a shell script is specified with the −r option, this script will be executed. Otherwise a the /etc/reload.ne?  default shell script for Network CoProcessor unit ‘?’ is executed.  newatch invokes /bin/sh to execute the reload script. An empty script will leave the Network CoProcessor in a non-operational state. Minimally, a reload script should contain a sequence of commands similar to the following:

/etc/ifconfig ne0 down
/usr/etc/neload −f /etc/ne.dwnld ne0
/etc/ifconfig ne0 ‘hostname‘ up
/etc/ifconfig ne0 netmask +
/usr/etc/sncnet −s onboardnfs 1 ne0
/usr/etc/newatch −d /var/crash/SNC −r /etc/reload.ne0 ne0

OPTIONS

−d Use the next argument as the directory name where the uploaded memory images will be created. 

−h Print a help display on the usage of the command. 

−r Use the next argument as the pathname to a shell script that can perform a reload and reinitialization of the Network CoProcessor in case of failure. 

FILES

/dev/ne[0-5] Network CoProcessor interfaces

/usr/etc/newatch

/var/crash/SNC/{prog,buff,shio}.ne[0-5].nn
uploaded memory images

/etc/reload.ne[0-5] default shell scripts to reload Network CoProcessor interfaces

SEE ALSO

ifconfig(8), ne(4), neload(8), nestop(8), sncnet(8)
Sun Network CoProcessor Installation Manual

Sun Release 4.1  —  Last change: 10/12/91