trc_hkemptyset64, trc_hkfillset64, trc_hkaddset64, trc_hkdelset64, or trc_hkisset64 Subroutine

Purpose

Manipulates a trace hook set of the trc_hookset64_t type.

Library

libtrace.a

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.