tnfctl_close(3TNF) TNF Library Functions 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 continue 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 contin‐
ued 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 │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWtnfc │
├─────────────────────────────┼─────────────────────────────┤
│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)SunOS 5.10 4 Mar 1997 tnfctl_close(3TNF)
