trc_ishookset Subroutine

Purpose

Return an indication of all hooks currently being traced.

Library

libtrace.a

Syntax

#include <sys/libtrace.h>

int trc_ishookset(int chan, char *hkst, size_t hkst_sz)

Description

The trc_ishookset subroutine returns 1 if the specified channel is being traced, 0 otherwise. If it returns 1, the hookset item is modified to contain an indication of the hooks being traced. The facilities in the libtrace.a library for examining a data item of trc_hookset_t or trc_hookset64_t type can then be used.

If data of the trc_hookset_t type is passed on a system before AIX® 6.1, the status of all 12-bit hook IDs are returned. If data of the trc_hookset_t type is passed on AIX 6.1 and later, only information about the hooks of the form 0xhhh0 (represented as 0xhhh) is returned where h is a hexadecimal digit. If data of the trc_hookset64_t type, which is valid beginning with AIX 6.1, is passed, information about all 16-bit hook IDs is returned.

Parameters

Item Description
chan The channel to query ranging from channel number 0 through 7.
hkst

Pointer to a variable of type trc_hookset_t or trc_hookset64_t.

hkst_sz Size of the hookset being passed in.

Return Values

Item Description
1 System trace is on.
0 System trace is off.

Files

/dev/systrct1[-{0-7}]