libtnfctl(3LIB) Interface Libraries libtnfctl(3LIB)NAME
libtnfctl - TNF probe control library
SYNOPSIS
cc [ flag... ] file.. -ltnfctl [ library... ]
#include <tnf/tnfctl.h>
DESCRIPTION
Functions in this library provide TNF probe control routines for use by processes and the kernel.
INTERFACES
The shared object libtnfctl.so.1 provides the public interfaces defined below. See Intro(3) for additional information on shared object
interfaces.
tnfctl_buffer_alloc tnfctl_buffer_dealloc
tnfctl_check_libs tnfctl_close
tnfctl_continue tnfctl_exec_open
tnfctl_filter_list_add tnfctl_filter_list_delete
tnfctl_filter_list_get tnfctl_filter_state_set
tnfctl_indirect_open tnfctl_internal_open
tnfctl_kernel_open tnfctl_pid_open
tnfctl_probe_apply tnfctl_probe_apply_ids
tnfctl_probe_connect tnfctl_probe_disable
tnfctl_probe_disconnect_all tnfctl_probe_enable
tnfctl_probe_state_get tnfctl_probe_trace
tnfctl_probe_untrace tnfctl_register_funcs
tnfctl_strerror tnfctl_trace_attrs_get
tnfctl_trace_state_set
FILES
/usr/lib/libtnfctl.so.1 shared object
/usr/lib/64/libtnfctl.so.1 64-bit shared object
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWtnfc (32-bit) |
+-----------------------------+-----------------------------+
| |SUNWtnfcx (64-bit) |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe with exceptions |
+-----------------------------+-----------------------------+
SEE ALSO pvs(1), Intro(3), libtnfctl(3TNF), tracing(3TNF), attributes(5)NOTES
This API is MT-Safe. Multiple threads can concurrently operate on independent tnfctl handles, which is the typical behavior expected.
libtnfctl does not support multiple threads operating on the same tnfctl handle. If this is desired, it is the client's responsibility to
implement locking to ensure that two threads that use the same tnfctl handle are not simultaneously present in a libtnfctl interface.
SunOS 5.11 22 May 2003 libtnfctl(3LIB)
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)