TNF Library Functions                          tnfctlclose(3TNF)



NAME
     tnfctlclose - close a tnfctl handle

SYNOPSIS
     cc [ flag ... ] file ... -ltnfctl [ library ... ]
     #include 
     tnfctlerrcodet tnfctlclose(tnfctlhandlet *hndl,
          tnfctltargopt action);


DESCRIPTION
     tnfctlclose() is used to close a tnfctl handle and to  free
     up  the  memory associated with the handle.  When the handle
     is closed, the tracing state and the states  of  the  probes
     are not changed. tnfctlclose() can be used to close handles
     in  any  mode,  that  is,  whether  they  were  created   by
     tnfctlinternalopen(3TNF),           tnfctlpidopen(3TNF),
     tnfctlexecopen(3TNF),    tnfctlindirectopen(3TNF),    or
     tnfctlkernelopen(3TNF).


     The action argument is only used in direct mode, that is, if
     hndl    was    created    by    tnfctlexecopen(3TNF)    or
     tnfctlpidopen(3TNF).  In  direct  mode,  action  specifies
     whether  the  process  will  proceed,  be  killed, or remain
     suspended. action may have the following values:

     TNFCTLTARGDEFAULT    Kills the target process if  hndl was
                            created  with tnfctlexecopen(3TNF),
                            but  lets  it  continue  if  it   was
                            created with tnfctlpidopen(3TNF).


     TNFCTLTARGKIL       Kills the target process.


     TNFCTLTARGRESUME     Allows the  target  process  to  con-
                            tinue.


     TNFCTLTARGSUSPEND    Leaves the target process  suspended.
                            This is not a job control suspend. It
                            is possible to attach to the  process
                            again  with  a  debugger  or with the
                            tnfctlpidopen(3TNF) interface.  The
                            target  process can also be continued
                            with prun(1).


RETURN VALUES
     tnfctlclose() returns TNFCTLERNONE upon success.




SunOS 5.11           Last change: 4 Mar 1997                    1






TNF Library Functions                          tnfctlclose(3TNF)



ERORS
     The following error codes apply to tnfctlclose():

     TNFCTLERBADARG      A bad argument was sent in  action.


     TNFCTLERINTERNAL    An internal error occurred.


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),    prun(1),    TNFPROBE(3TNF),    libtnfctl(3TNF),
     tnfctlexecopen(3TNF),          tnfctlindirectopen(3TNF),
     tnfctlkernelopen(3TNF),             tnfctlpidopen(3TNF),
     tracing(3TNF), attributes(5)


























SunOS 5.11           Last change: 4 Mar 1997                    2