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



NAME
     hps_log - display log and supplementary information from the
          HPS host adapter or cluster controllers

S:YNOPSIS
     hpslog [aduc] [addr] [device]

DESCRIPTION
     hpslog reads the log table from either an HPS host  adapter
     or  an HPS cluster controller and writes it to standard out
     put.  The default is to interpret the contents and produce a
     formatted  display of the log table of the host adapter with
     device name /dev/rhp0.

OPTIONS
     One or more of the following options may be selected:

     a    Specifies that the log table from one  of  the  cluster
          controllers  should  be  read.   The cluster address is
          specified in addr.

     d    Specifies the device file name  for  the  host  adapter
          board. The  file  name  is  specified  in  device. The
          default is /dev/rhp0.

     u    Produces an  unformatted  (binary)  write  of  the  log
          table. This is designed to be piped into another pro-
          gram to interpret the data.

     c    Specifies that the log table be  cleared  after  it  is
          read

EXAMPLES
     The following example writes  a  formatted  display  of  the
     default  host  adapter's  log  table and then clears the log
     table:

          hpslog c

     The following example writes  a  formatted  display  of  the
     cluster controller 1 log table:

          hpslog a 1

     The following example writes a formatted display of the  log
     table of a second host adapter in the system:

          hpslog d /dev/rhp1

     For a description of the host adapter log information, refer
     to  the  HPS Application Installation Manual and the include
     file hps.ioctl.h. For a  description  of  the  cluster



                        Printed 11/19/92                   Page 1

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



     controller log information, refer to the HPS Diagnostic
     Application User Manual and the include file hps.diag.h.

     Compile under UNIX System V with either:

          cc -c -I../include -O hpslog.c
          ld -o hpslog /lib/crt0.o hpslog.o logsub.o rlogsub.o rhpslib.o -lc

     or, if compilation is done on a system that requires IOCB
     structure alignment on 32-bit boundaries:

          cc -c -DHPSALIGN -I../include -O hpslog.c
          ld -o hpslog /lib/crt0.o hpslog.o logsub.o rlogsub.o rhpslib.o -lc

     Use the BSD switch for Berkeley 4.2 UNIX systems.

BUGS
     Earlier versions display "Board assy" header instead of
     "Running".

SEE ALSO
     hty(7)

































 Page 2                 Printed 11/19/92