This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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

See also:

InterruptAttach(), TraceEvent()

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