hps_cload(1M) — mips UMIPS RISC/os 5.01



hpscload(1M)       RISC/os Reference Manual        hpscload(1M)



NAME
     hps_cload - download files to devices on the HPS network

SYNOPSIS
     hpscload [ fdc ] [ config_file ] [ device_name ]

DESCRIPTION
     Hpscload downloads executable files to various devices on
     the HPS network.  It reads the configuration file to deter-
     mine the devices and the files to download.  If the devices
     given in the configuration file are waiting to be down-
     loaded, hpscload 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: (1) in the network node ID range specified (in hexa-
     decimal) by start_id through stop_id, inclusive, and (2) of
     the same type as device_type. The fields are separated by
     one or more tabs or spaces.  The valid device types are
     listed in the $HPS_DIR/include/hps.dev_types.h header file.
     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 quali fies.
     Empty lines or lines beginning with a hash mark (#) 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 host
          adapter board.  The default device is /dev/rhp0.

     c    Run continuously.  hpscload 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 net
          work.

EXAMPLE
     The following command:

          rBhpscload fc /etc/hpsconfig

     executed during system boot (e.g., in the /etc/rc or
     /etc/inittab file) can be used as a HPS download daemon.



                        Printed 11/19/92                   Page 1



hpscload(1M)       RISC/os Reference Manual        hpscload(1M)



     The following hps_config file will download all HPS-7082-020
     devices between 1 and  FF, with file1.dnl; all HPS-7080-030
     devices between 1 and FF, with file2.dnl; all devices
     between 1 and 0F that did not qualify for any of the previ-
     ous specifications with file3.dnl.

          # start   stop     devicetype    downloadfile
          # ----     ----   ------------   -------------
           01       FF      HPS-7082-020   file1.dnl
           01       FF      HPS-7080-030   file2.dnl
           01       0F      ALL            file3.dnl

SEE ALSO
            hps_netc(1M)

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. The download
     file must be in Systech's .dnl format as described in the
     $HPS_DIR/include/hps.dnl.h header file.

DIAGNOSTICS
     If hpscload encounters a fatal error, the exit status is
     set to non-zero and an appropriate message is sent to stan
     dard error.

FILES
            hps_config /dev/rhp0

WARNINGS
     hpscload 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.

     To compile, type the following:

            cd $HPSDIR/host

            cc -O -I../include -o hpscload hpscload.c
     chpslib.o

     If compilation is done on a system that requires IOCB struc-
     ture alignment on 32-bit boundaries, use the following com-
     pile command instead:

            cc -O -I../include -DHPSALIGN -o hpscload
     hpscload.c chpslib.o

     HPS_DIR is an environment variable set to the HPS root
     directory.




 Page 2                 Printed 11/19/92

Museum

Related Articles