Purpose
Manipulates
a trace hook set of the trc_hookset64_t type.
Syntax
#include <sys/libtrace.h>
void trc_hkemptyset64(hookset)
trc_hookset64_t hookset;
void trc_hkfillset64(hookset)
trc_hookset64_t hookset;
int trc_hkaddset64(hookset, hook)
trc_hookset64_t hookset;
short hook;
int trc_hkdelset64(hookset, hook)
trc_hookset64_t hookset;
short hook;
int trc_hkisset64(hookset, hook)
trc_hookset64_t hookset;
short hook;
Description
The trc_hkemptyset64, trc_hkfillset64, trc_hkaddset64, trc_hkdelset64,
and trc_hkisset64 subroutines manipulate the trace hook set
used by trc_find_first, trc_find_next, or trc_compare Subroutine. The hook set
can be used to search for several trace hooks simultaneously. The trc_hkfillset64 subroutine
sets all hook IDs except for 0x0000 and hook IDs less than 0x1000
where the least significant digit is not 0 (for example, 0x0hh1 is
not valid).
Parameters
Item |
Description |
hookset |
References the hook set to be operated on. |
hook |
Specifies a hook value ranging from 0x0000 through 0xffff. |
Return Values
Item |
Description |
trc_hkaddset64 |
- EINVAL – The hook is not valid (0 or less than 0x1000 with a nonzero
value in the least significant digit).
- 0 – The hook is in the set.
- -1 – The hook is not present.
|
Item |
Description |
trc_hkdelset64 |
- EINVAL – The hook is not valid (0 or less than 0x1000 with a nonzero
value in the least significant digit).
- 0 – The hook is in the set.
- -1 – The hook is not present.
|
Item |
Description |
trc_hkisset64 |
- EINVAL – The hook is not valid (0 or less than 0x1000 with a nonzero
value in the least significant digit).
- 0 – The hook is in the set.
- -1 – The hook is not present.
|