TNFCTL_CLOSE(3TNF)TNFCTL_CLOSE(3TNF)NAMEtnfctl_close - close a tnfctl handle
SYNOPSIS
cc [ flag ... ] file ... -ltnfctl [ library ... ]
#include <tnf/tnfctl.h>
tnfctl_errcode_t tnfctl_close(tnfctl_handle_t *hndl,
tnfctl_targ_op_t action);
DESCRIPTIONtnfctl_close() is used to close a tnfctl handle and to free up the mem‐
ory associated with the handle. When the handle is closed, the tracing
state and the states of the probes are not changed. tnfctl_close() can
be used to close handles in any mode, that is, whether they were cre‐
ated by tnfctl_internal_open(3TNF), tnfctl_pid_open(3TNF),
tnfctl_exec_open(3TNF), tnfctl_indirect_open(3TNF), or tnfctl_ker‐
nel_open(3TNF).
The action argument is only used in direct mode, that is, if hndl was
created by tnfctl_exec_open(3TNF) or tnfctl_pid_open(3TNF). In direct
mode, action specifies whether the process will proceed, be killed, or
remain suspended. action may have the following values:
TNFCTL_TARG_DEFAULT
Kills the target process if hndl was created
with tnfctl_exec_open(3TNF), but lets it con‐
tinue if it was created with
tnfctl_pid_open(3TNF).
TNFCTL_TARG_KILL
Kills the target process.
TNFCTL_TARG_RESUME
Allows the target process to continue.
TNFCTL_TARG_SUSPEND
Leaves the target process suspended. This is
not a job control suspend. It is possible to
attach to the process again with a debugger or
with the tnfctl_pid_open(3TNF) interface. The
target process can also be continued with
prun(1).
RETURN VALUEStnfctl_close() returns TNFCTL_ERR_NONE upon success.
ERRORS
The following error codes apply to tnfctl_close():
TNFCTL_ERR_BADARG
A bad argument was sent in action.
TNFCTL_ERR_INTERNAL
An internal error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌───────────────┬─────────────────┐
│ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├───────────────┼─────────────────┤
│MT Level │ MT-Safe │
└───────────────┴─────────────────┘
SEE ALSOprex(1), prun(1), TNF_PROBE(3TNF), libtnfctl(3TNF),
tnfctl_exec_open(3TNF), tnfctl_indirect_open(3TNF), tnfctl_ker‐
nel_open(3TNF), tnfctl_pid_open(3TNF), tracing(3TNF), attributes(5)
Mar 4, 1997 TNFCTL_CLOSE(3TNF)
