qnx_trace_close()

close a channel to a trace buffer

Synopsis:

#include <sys/trace.h>
int qnx_trace_close( pid_t proc_pid );

Description:

The qnx_trace_close() function closes a previously opened channel to a trace buffer.

If proc_pid is zero or PROC_PID, the trace buffer on the current node is accessed. To access a trace buffer on another node, you must establish a virtual circuit to the process manager on that node and pass the vid as proc_pid.

Returns:

0: Success
-1: An error occurred. errno is set to indicate the error.

Errors:

EINVAL: The qnx_trace_open() function hasn't been called.
ENOSYS: The process manager doesn't support trace calls.
ESRCH: The proc_pid is invalid.

Examples:

See qnx_trace_read().

Classification:

QNX

Safety:
Interrupt handler	No
Signal handler	Yes, but modifies errno
Thread	Yes