NAME

       Tcl_CreateCloseHandler,  Tcl_DeleteCloseHandler  - arrange for callbacks when channels are
       closed

SYNOPSIS

       #include <tcl.h>

       void
       Tcl_CreateCloseHandler(channel, proc, clientData)

       void
       Tcl_DeleteCloseHandler(channel, proc, clientData)

ARGUMENTS

       Tcl_Channel channel (in)               The channel for which to create or delete  a  close
                                              callback.

       Tcl_CloseProc *proc (in)               The procedure to call as the callback.

       ClientData clientData (in)             Arbitrary one-word value to pass to proc.
_________________________________________________________________________________________________

DESCRIPTION

       Tcl_CreateCloseHandler  arranges  for  proc  to  be  called  when  channel  is closed with
       Tcl_Close or Tcl_UnregisterChannel, or using the Tcl close command.  Proc should match the
       following prototype:

              typedef void Tcl_CloseProc(
                      ClientData clientData);

       The clientData is the same as the value provided in the call to Tcl_CreateCloseHandler.

       Tcl_DeleteCloseHandler  removes  a  close  callback  for channel.  The proc and clientData
       identify which close callback to remove; Tcl_DeleteCloseHandler does nothing if  its  proc
       and  clientData  arguments  do  not match the proc and clientData for a  close handler for
       channel.

SEE ALSO

       close(3tcl), Tcl_Close(3tcl), Tcl_UnregisterChannel(3tcl)

KEYWORDS

       callback, channel closing