1th_manage(1M)           System Administration Commands           th_manage(1M)
2
3
4

NAME

6       th_manage - manage the fault injection test harness
7

SYNOPSIS

9       th_manage name instance command
10
11
12       th_manage path command
13
14

DESCRIPTION

16       th_manage applies the action specified by command to the instance spec‐
17       ified by instance of the  driver  specified  by  name  (or  the  driver
18       instance  specified by path). The driver instance must be running fault
19       injection specifications (errdefs) defined by th_define(1M).
20
21
22       th_manage supports several commands that operate on the driver instance
23       specified by name and instance (or path). The commands are:
24
25       broadcast         Awaken  all th_define processes, causing them to dis‐
26                         play their current status and exit if the  errdef  is
27                         now  defunct  (that  is,  if  count,  failcount , and
28                         acc_chk  are all zero).
29
30
31       clear_acc_chk     Awaken all th_define processes. If  count  and  fail‐
32                         count  are already zero, then set acc_chk to zero, so
33                         that th_define exits once it has displayed  its  sta‐
34                         tus.
35
36
37       clear_errdefs     Awaken  all th_define processes. count, failcount and
38                         acc_chk are all set to zero  so  that  all  th_define
39                         commands exit once they have displayed their status.
40
41
42       clear_errors      Awaken  all  th_define processes. If count is already
43                         zero, set failcount and  acc_chk  to  zero,  so  that
44                         th_define exits once it has displayed its status.
45
46
47       get_handles       List all the access handles.
48
49
50       start             Begin or resume execution of all errdefs.
51
52
53       stop              Suspend  all  errdefs  for this name and instance (or
54                         path).
55
56

EXAMPLES

58       Example 1 Useful Commands
59
60
61       To begin the tests, enter:
62
63
64
65       # th_manage foo 0 start
66
67
68
69       To check the status of the errdefs, enter:
70
71
72
73       # th_manage foo 0 broadcast
74
75
76
77       This causes each th_define process to print out its current status.
78
79
80
81       If the driver has reported a fatal error, you can take the driver  off‐
82       line using libdevice, clear the error condition by entering:
83
84
85
86       # th_manage foo 0 clear_acc_chk
87
88
89
90       or
91
92
93
94       # th_manage foo 0 clear_errors
95
96
97
98       and bring the driver online again using libdevice.
99
100
101
102       To terminate testing, enter:
103
104
105
106       # th_manage foo 0 clear_errdefs
107
108

SEE ALSO

110       th_define(1M)
111
112
113
114SunOS 5.11                        4 Jan 2001                     th_manage(1M)
Impressum