Joe Mistachkin$Revision: 1.8 $numLevels embedding terminate async thread safe gc

This TIP introduces the ability to quickly and safely decide whether a Tcl script is evaluating in an interpreter, allowing an external system to determine whether it is safe to delete that interpreter.

For applications written in garbage-collected languages, such as C#, it is not always desirable to rely upon the Tcl_Preserve / Tcl_Release mechanism to protect an against deletion of an interpreter while it is in use. For details of how this is used, see [] [] and Joe Mistachkin's talk at Tcl 2008. Additionally, an application may want to proactively forbid attempts to delete an interpreter while it is in use. Unfortunately, there is currently no publicly exposed method to determine if a given Tcl interpreter is in use (i.e. one or more calls to Tcl_Eval are active). This TIP proposes to correct that deficiency.

This TIP introduces a single function to Tcl's public API: int Tcl_InterpActive(Tcl_Interp *interp) The Tcl_InterpActive function returns non-zero if the interpreter is in use, and zero if it is idle (i.e. not evaluating any script).

Lyo=ICotLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tICo=ICogVGNsX0ludGVycEFjdGl2ZSAtLQ==ICo=ICoJUmV0dXJucyBub24temVybyBpZiB0aGUgc3BlY2lmaWVkIGludGVycHJldGVyIGlzIGluIHVzZS4=ICo=ICogUmVzdWx0czo=ICoJU2VlIGFib3ZlLg==ICo=ICogU2lkZSBlZmZlY3RzOg==ICoJTm9uZS4=ICo=ICotLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tICovaW50VGNsX0ludGVycEFjdGl2ZShUY2xfSW50ZXJwICppbnRlcnApew==ICAgIHJldHVybiAoKChJbnRlcnAgKikgaW50ZXJwKS0+bnVtTGV2ZWxzID4gMCk7fQ==

This document has been placed in the public domain.