HPS_CLOAD(1) — USER COMMANDS
NAME
hps_cload − download files to devices on the MVME338 network
SYNOPSIS
hps_cload [ −c ] [ -f config_file ] [−d device_name ]
DESCRIPTION
Hps_cload downloads executable files to various devices on the MVME338 network. It reads the configuration file to determine the devices and the files to download. If the devices given in the configuration file are waiting to be downloaded, hps_cload will attempt to download the specified file(s).
The config_file contains lines in the following format:
start_id stop_id device_type download_file
Each line specifies the file to download for devices which are in the network node ID range specified (in hexadecimal) by start_id through stop_id , inclusive, and which are of the same type as device_type . The fields are separated by one or more tabs or spaces. ALL may be used as a device_type to download all devices in the network node ID range. A device will be included in only the first download specification for which it qualifies. Empty lines or lines beginning with # are ignored.
OPTIONS
The following options are available:
−f Use the file config_file instead of the default file (found in the local directory), hps_config .
−d Specify the device file device_name for the MVME338 board.
−c Run continuously. Hps_cload will not exit after one pass, but will "sleep" until it receives a network status change notification. The download process is then repeated if it is required by any device on the network. When run in the background with this option, hps_cload may be used as a download daemon for the MVME338 network.
EXAMPLES
The following command:
hps_cload -c -f /etc/hps_config
executed during system startup (e.g., in the /etc/rc , or /etc/inittab file) can be used as a MVME338 download daemon.
Normally this utility is only executed during system startup and need not be executed manually.
The following hps_config file:
# start stop device type download file
# ----- ---- ------------ -------------
01 FF HPS-7082-030 file1.dnl
01 FF HPS-7080-030 file2.dnl
01 0F ALL file3.dnl
will download all HPS-7082-030 devices between 01 and FF hexadecimal, with file1.dnl ; all HPS-7080-030 devices between 01 and FF hexadecimal, with file2.dnl ; all devices between 01 and 0F hexadecimal which did not qualify for any of the previous specifications with file3.dnl .
SEE ALSO
NOTE
The network device must be waiting for download commands before it can be downloaded. A device will normally be in this state after being powered on or reset (see hpsremres (1)).
DIAGNOSTICS
If hps_cload encounters a fatal error, the exit status is set to non-zero and an appropriate message is sent to standard error.
FILES
hps_config /dev/xedt/mvme338_c∗
WARNINGS
hps_cload should not be killed with a signal which cannot be caught (e.g., signal 9). Doing so will prevent any cleaning up which may be required.