tnfctl_strerror(3TNF) TNF Library Functions tnfctl_strerror(3TNF)NAME
tnfctl_strerror - map a tnfctl error code to a string
SYNOPSIS
cc [ flag ... ] file ... -ltnfctl [ library ... ]
#include <tnf/tnfctl.h>
const char * tnfctl_strerror(tnfctl_errcode_t errcode);
DESCRIPTION
tnfctl_strerror() maps the error number in errcode to an error message string, and it returns a pointer to that string. The returned string
should not be overwritten or freed.
ERRORS
tnfctl_strerror() returns the string "unknown libtnfctl.so error code" if the error number is not within the legal range.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWtnfc |
+-----------------------------+-----------------------------+
|MT Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO prex(1), TNF_PROBE(3TNF), libtnfctl(3TNF), tracing(3TNF), attributes(5)SunOS 5.11 4 Mar 1997 tnfctl_strerror(3TNF)
Check Out this Related Man Page
tnfctl_close(3TNF) TNF Library Functions tnfctl_close(3TNF)NAME
tnfctl_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);
DESCRIPTION
tnfctl_close() is used to close a tnfctl handle and to free up the memory associated with the handle. When the handle is closed, the trac-
ing 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
created 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 continued with
prun(1).
RETURN VALUES
tnfctl_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 ALSO prex(1), prun(1), TNF_PROBE(3TNF), libtnfctl(3TNF), tnfctl_exec_open(3TNF), tnfctl_indirect_open(3TNF), tnfctl_kernel_open(3TNF),
tnfctl_pid_open(3TNF), tracing(3TNF), attributes(5)SunOS 5.11 4 Mar 1997 tnfctl_close(3TNF)