TNF Library Functions                   tnfprocessdisable(3TNF)



NAME
     tnfprocessdisable, tnfprocessenable, tnfthreaddisable,
     tnfthreadenable - probe control internal interface

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



     void tnfprocessdisable(void);


     void tnfprocessenable(void);


     void tnfthreaddisable(void);


     void tnfthreadenable(void);


DESCRIPTION
     There are three levels of granularity for controlling  trac-
     ing and probe functions (called probing from here on): prob-
     ing for the entire process, a  particular  thread,  and  the
     probe  itself  can  be  disabled  or enabled.  The first two
     (process and thread) are controlled by this interface.   The
     probe is controlled with the prex(1) utility.


     The tnfprocessdisable() function turns off probing for the
     process.  The  default  process  state  is  to  have probing
     enabled. The tnfprocessenable() function turns on  probing
     for the process.


     The tnfthreaddisable() function turns off probing for  the
     currently running thread. Threads are "born" or created with
     this state enabled. The tnfthreadenable()  function  turns
     on probing for the currently running thread.  If the program
     is a non-threaded program, these two thread interfaces  dis-
     able or enable probing for the process.

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








SunOS 5.11           Last change: 5 Feb 2002                    1






TNF Library Functions                   tnfprocessdisable(3TNF)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWtnfd                    
    
     Interface Stability          Unstable                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     prex(1),        tnfdump(1),        TNFDECLARERECORD(3TNF),
     TNFPROBE(3TNF), attributes(5)

NOTES
     A probe is considered enabled only if:

         o    prex(1) has enabled the probe AND

         o    the process  has  probing  enabled,  which  is  the
              default  or  could be set with tnfprocessenable()
              AND

         o    the thread that hits the probe has probing enabled,
              which  is  every  thread's  default or could be set
              with tnfthreadenable().


     There is a run time cost associated  with  determining  that
     the probe is  disabled.  To reduce the performance effect of
     probes, this cost should be  minimized.   The  quickest  way
     that  a  probe  can  be determined to be disabled is  by the
     enable control that prex(1) uses.  Therefore, to disable all
     the  probes  in a process use the disable command in prex(1)
     rather than tnfprocessdisable().


     The tnfprocessdisable() and tnfprocessenable() functions
     should only be used to toggle probing based on some internal
     program condition. The tnfthreaddisable() function  should
     be used to turn off probing for threads that are uninterest-
     ing.












SunOS 5.11           Last change: 5 Feb 2002                    2