Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
TNF Library Functionstnfctl_kernel_open(3TNF)


NAME

 tnfctl_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);

DESCRIPTION

 

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.

RETURN VALUES

 

tnfctl_kernel_open returns TNFCTL_ERR_NONE upon success.

ERRORS

 
TNFCTL_ERR_ACCES
Permission denied. Superuser privileges are needed for kernel tracing.
TNFCTL_ERR_BUSY
Another client is currently using kernel 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWtnfc
MT LevelMT-Safe

SEE ALSO

 

prex(1), fuser(1M), TNF_PROBE(3TNF), libtnfctl(3TNF), tracing(3TNF), tnf_kernel_probes (4), attributes(5)


SunOS 5.9Go To TopLast Changed 4 Mar 1997

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.