syncadm(1M)                    DG/UX R4.11MU05                   syncadm(1M)


NAME
       syncadm - synchronous controller administration

SYNOPSIS
       syncadm [-v] [-c] [-i] [-r] [-l image] [-d dump_file] 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 a
       user with appropriate privilege is allowed to use this command.  On a
       generic DG/UX system, appropriate privilege is granted by having an
       effective UID of 0 (root).  See the appropriate_privilege(5) man page
       for more information.

       On a system with DG/UX information security, appropriate privilege is
       defined as having one or more specific capabilities enabled in the
       effective capability set of the calling process. See cap_defaults(5)
       for the default capability for 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 halted.  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 halted, the registers at the time of the halt
              have already been dumped in memory.  An NMI in this case would
              destroy the halt 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 dump_file
              Dump the memory contents of the controller.  The dump will
              write a formatted image (.bin format) to dump_file.  If
              dump_file does not exist, it will be created.  If dump_file
              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.

       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)