|Skip Navigation Links|
|Exit Print View|
|man pages section 3: Extended Library Functions Oracle Solaris 10 1/13 Information Library|
- create handle for kernel probe control
cc [ flag ... ] file ... -ltnfctl [ library ... ] #include <tnf/tnfctl.h> tnfctl_errcode_t tnfctl_kernel_open(tnfctl_handle_t **ret_val);
tnfctl_kernel_open() starts a kernel tracing session and returns in ret_val an opaque handle that can be used to control tracing and probes in the kernel. Only one kernel tracing session is possible at a time on a given machine. An error code of TNFCTL_ERR_BUSY is returned if there is another process using kernel tracing. Use the command
fuser -f /dev/tnfctl
to print the process id of the process currently using kernel tracing. Only a superuser may use tnfctl_kernel_open(). An error code of TNFCTL_ERR_ACCES is returned if the caller does not have the necessary privileges.
tnfctl_kernel_open returns TNFCTL_ERR_NONE upon success.
Permission denied. Superuser privileges are needed for kernel tracing.
Another client is currently using kernel tracing.
Memory allocation failed.
/dev/tnfctl not found.
Some other failure occurred.
See attributes(5) for descriptions of the following attributes: