---

InterruptHookTrace()

Attach the pseudo interrupt handler that the instrumented module uses

Synopsis:

#include <sys/neutrino.h>

int InterruptHookTrace( 
        const struct sigevent * (* handler)(int),
        unsigned flags );

Arguments:

handler

A pointer to the handler function.

flags

Flags that specify how you want to attach the interrupt handler.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The InterruptHookTrace() kernel call attaches the pseudo interrupt handler handle that the instrumented module uses.

---

This function requires the instrumented kernel. For more information, see the documentation for the System Analysis Toolkit (SAT).

---

Returns:

An interrupt function ID, or -1 if an error occurs (errno is set).

Errors:

EAGAIN

All kernel interrupt entries are in use.

EFAULT

A fault occurred when the kernel tried to access the buffers provided.

EPERM

The process doesn't have superuser capabilities.

ENOTSUP

The kernel is not instrumented.

Classification:

QNX Neutrino

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes

See also:

InterruptAttach(), TraceEvent()

Writing an Interrupt Handler chapter of the Neutrino Programmer's Guide

---