tnfctl_kernel_open(3TNF) TNF Library Functions tnfctl_kernel_open(3TNF)NAMEtnfctl_kernel_open - create handle for kernel probe control
SYNOPSIS
cc [ flag ... ] file ... -ltnfctl [ library ... ]
#include <tnf/tnfctl.h>
tnfctl_errcode_t tnfctl_kernel_open(tnfctl_handle_t **ret_val);
DESCRIPTIONtnfctl_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.
RETURN VALUEStnfctl_kernel_open returns TNFCTL_ERR_NONE upon success.
ERRORS
TNFCTL_ERR_ACCES Permission denied. Superuser privi‐
leges are needed for kernel tracing.
TNFCTL_ERR_BUSY Another client is currently using ker‐
nel tracing.
TNFCTL_ERR_ALLOCFAIL Memory allocation failed.
TNFCTL_ERR_FILENOTFOUND /dev/tnfctl not found.
TNFCTL_ERR_INTERNAL Some other failure occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWtnfc │
├─────────────────────────────┼─────────────────────────────┤
│MT Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOprex(1), fuser(1M), TNF_PROBE(3TNF), libtnfctl(3TNF), tracing(3TNF),
tnf_kernel_probes (4), attributes(5)SunOS 5.10 4 Mar 1997 tnfctl_kernel_open(3TNF)