vscload(1M) — DG/UX 5.4.2A



vscload(1M)                      DG/UX 5.4.2                     vscload(1M)


NAME
       vscload - download board resident software onto VSC synchronous
       controller

SYNOPSIS
       vscload [-v] [-r] [-e] [-m] -f image -p task_priority -t task_id
       device|-a

   where:
       task_priority  Task priority, an integer in the range 5 to 255.
       task_id        Task identifier, an integer in the range 5 to 255.
       device         The direct ssid access device for the VSC controller
                      to be loaded.  This option is mutually exclusive with
                      the -a option.

DESCRIPTION
       Vscload downloads the board resident software onto the VSC
       synchronous controller.  Only super user is allowed to use this
       command.

       Options are:

       -v     Specify verbose mode.  If verbose is specified, extra
              information about the load (such as the starting address) is
              displayed on the console.

       -r     Force a software reset of the synchronous card prior to the
              load.  This option must be specified only for the first image
              to be downloaded.  In other words, the first image to be
              downloaded must have this option and this option must not
              appear for any subsequent loads.

       -e     Inform the ssid driver that this is the last image to download
              to the VSC synchronous controller. When ssid receives this
              command it will assume that the VSC controller is completely
              loaded and communications can begin.

       -m     Specify that the download image is the board  manager.  All
              messages sent to on board user tasks will be sent directly to
              the board manager task for on board message routing.  It is
              the responsibility of the board manager to see that all
              messages are posted to the correct destination task.

       -f image
              Specify the name of the image that is to be downloaded.  The
              image is a binary representation of a hexadecimal file.  The
              image parameter must immediately follow the -f option.

       -p task_priority
              Set the task priority on the synchronous controller card for
              the image to be loaded.  The lower the number, the higher the
              priority.





Licensed material--property of copyright holder(s)                         1



vscload(1M)                      DG/UX 5.4.2                     vscload(1M)


       -t task_id
              Set the id of the downloaded task on the VSC.  These task ids
              are used for on board intertask communications.

       -a     Make vscload search for all VSC controllers configured for
              ssid, then send the image and related commands to each board
              automatically.

EXAMPLES
       In the following example we will download three images into the first
       VSC controller configured:

       vscload -r -v -f vscinit.bin -t 5 -p 5 /dev/ssid01
       vscload -v -f vscd.bin -t 6 -p 6 /dev/ssid01
       vscload -e -v -m -f vscmgr.bin -t 7 -p 7 /dev/ssid01

       Note that we reset the VSC prior to loading the first image by using
       the -r option on the first vscload command line.  We also identified
       vscmgr.bin as being the VSC board manager by specifying the -m option
       on the command line used to load the vscmgr image.  We specified the
       end of the load sequence by the -e option on the command line of the
       last image downloaded.

SEE ALSO
       vsccheck(1M), ssid(7).

NOTES
       If you invoke vscload manually, you must reset the VSC controller on
       the first image downloaded with the -r option.  On the last image,
       the -e option must be specified in order to put the ssid driver into
       the proper state.


























Licensed material--property of copyright holder(s)                         2

Museum

Related Articles