TNF Library Functions                    tnfctlkernelopen(3TNF)



NAME
     tnfctlkernelopen - create handle for kernel probe control

SYNOPSIS
     cc [ flag ... ] file ... -ltnfctl [ library ... ]
     #include 



     tnfctlerrcodet tnfctlkernelopen(tnfctlhandlet **retval);


DESCRIPTION
     tnfctlkernelopen() starts a  kernel  tracing  session  and
     returns in retval an opaque handle that can be used to con-
     trol tracing and probes in  the  kernel.   Only  one  kernel
     tracing  session  is  possible at a time on a given machine.
     An error code of  TNFCTLERBUSY 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  ker-
     nel  tracing. Only a superuser may use tnfctlkernelopen().
     An error code of  TNFCTLERACES is returned if the caller
     does not have the necessary privileges.

RETURN VALUES
     tnfctlkernelopen returns TNFCTLERNONE upon success.

ERORS
     TNFCTLERACES           Permission   denied.    Superuser
                                privileges  are needed for kernel
                                tracing.


     TNFCTLERBUSY            Another client is currently using
                                kernel tracing.


     TNFCTLERALOCFAIL       Memory allocation failed.


     TNFCTLERFILENOTFOUND    /dev/tnfctl not found.


     TNFCTLERINTERNAL        Some other failure occurred.





SunOS 5.11           Last change: 4 Mar 1997                    1






TNF Library Functions                    tnfctlkernelopen(3TNF)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWtnfc                    
    
     MT Level                     MT-Safe                     
    


SEE ALSO
     prex(1),   fuser(1M),   TNFPROBE(3TNF),    libtnfctl(3TNF),
     tracing(3TNF), tnfkernelprobes(4), attributes(5)





































SunOS 5.11           Last change: 4 Mar 1997                    2