System Administration Commands                      thmanage(1M)



NAME
     thmanage - manage the fault injection test harness

SYNOPSIS
     thmanage name instance command


     thmanage path command


DESCRIPTION
     thmanage applies the action specified  by  command  to  the
     instance  specified  by  instance of the driver specified by
     name (or the driver instance specified by path). The  driver
     instance  must  be  running  fault  injection specifications
     (errdefs) defined by thdefine(1M).


     thmanage supports several  commands  that  operate  on  the
     driver  instance  specified  by name and instance (or path).
     The commands are:

     broadcast         Awaken all  thdefine  processes,  causing
                       them  to  display their current status and
                       exit if the errdef is  now  defunct  (that
                       is, if count, failcount , and accchk  are
                       all zero).


     clearaccchk     Awaken all thdefine processes.  If  count
                       and  failcount  are already zero, then set
                       accchk to zero, so that  thdefine  exits
                       once it has displayed its status.


     clearerrdefs     Awaken  all  thdefine  processes.  count,
                       failcount  and accchk are all set to zero
                       so that all thdefine commands  exit  once
                       they have displayed their status.


     clearerrors      Awaken all thdefine processes.  If  count
                       is already zero, set failcount and accchk
                       to zero, so that thdefine exits  once  it
                       has displayed its status.


     gethandles       List all the access handles.


     start             Begin or resume execution of all errdefs.




SunOS 5.11           Last change: 4 Jan 2001                    1






System Administration Commands                      thmanage(1M)



     stop              Suspend all  errdefs  for  this  name  and
                       instance (or path).


EXAMPLES
     Example 1 Useful Commands


     To begin the tests, enter:



     # thmanage foo 0 start



     To check the status of the errdefs, enter:



     # thmanage foo 0 broadcast



     This causes each thdefine process to print out its  current
     status.



     If the driver has reported a fatal error, you can  take  the
     driver offline using libdevice, clear the error condition by
     entering:



     # thmanage foo 0 clearaccchk



     or



     # thmanage foo 0 clearerrors



     and bring the driver online again using libdevice.







SunOS 5.11           Last change: 4 Jan 2001                    2






System Administration Commands                      thmanage(1M)



     To terminate testing, enter:



     # thmanage foo 0 clearerrdefs


SEE ALSO
     thdefine(1M)














































SunOS 5.11           Last change: 4 Jan 2001                    3