syncadm(1M)                    DG/UX 5.4R3.00                    syncadm(1M)


NAME
       syncadm - synchronous controller administration

SYNOPSIS
       syncadm [-v] [-c] [-i] [-r] [-l image] [-d dumpfile] device

DESCRIPTION
       Syncadm provides a user interface for directly managing an
       intelligent synchronous controller.  This command is used to download
       the controller, dump the contents of the controller memory to a disk
       file, and retrieve revision information from a controller.  Only
       superuser is allowed to use this command.

       Options are:

       -v     Specify verbose mode.  If verbose is specified, extra
              information about the operation is displayed to standard
              output.

       -c     Retrieve revision level information from the controller such
              as controller id, firmware revision, and hardware revision.

       -i     Issue a NMI (non-maskable interrupt) to the controller.  This
              option should be used when dumping a hung board.  This option
              should not be used when dumping a board that has panicked.
              The NMI will cause the on-board code to dump its registers to
              a specific memory location that will be captured by the dump.
              If the board has panicked, the registers at the time of the
              panic have already been dumped in memory.  An NMI in this case
              would destroy the panic trace information.

       -r     Force a reset of the controller.  The reset gives control of
              execution back to the on-board firmware.  Therefore, this
              option must be used prior to or in conjunction with a load or
              dump command.

       -l image
              Load the controller with the data found in the image file.
              The image file must be a binary file in .bin format.

       -d dumpfile
              Dump the memory contents of the controller.  The dump will
              write a formatted image (.bin format) to dumpfile.  If
              dumpfile does not exist, it will be created.  If dumpfile
              does exist, it will be overwritten.

       device The direct access device for the sync driver that supports the
              controller.

EXAMPLES
       The following is an example of a typical syncadm command used to
       download a controller supported by device /dev/vsxb01 with the image
       /usr/lib/sync/vsxbc/vsxbc.bin.




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

syncadm(1M)                    DG/UX 5.4R3.00                    syncadm(1M)


       syncadm -v -r -l /usr/lib/sync/vsxbc/vsxbc.bin /dev/vsxb01

       The following is an example of a syncadm command used to dump the
       memory contents of the controller supported by device /dev/vsxb01 to
       dump file /usr/dump/sync/vsxbc/vsxbc.dump.

       syncadm -v -r -d /usr/dump/sync/vsxbc/vsxbc.dump /dev/vsxb01

SEE ALSO
       vsxb(7).

NOTES
       You must use the -r (reset) option prior to or in conjunction with
       the -l (load) or -d (dump) options.











































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