This code is executed only when a new interpreter is created. Note that the "main" Websh script can source several modules which each call their initialization code.

Register code to be exectuted when the interpreter for this Websh script is deleted. web::dofinalize will then call each code block that has been registered, starting with the most recently added code.

Execute finalizer code that has been registerd using web::finalizer, starting with the most recently added code. Note that this command is executed automatically and does not have to be called manually. However, it can be used as a hook, when the interpreter is deleted:

	    rename web::finalize web::finalize.orig
	    proc web::myFinalize {} {
	        # code to eval before finalize.orig
	        finalize.orig
	        # code to eval after finalize.orig
	    }
	  

Execute code in the "main" interpreter of mod_websh. (Note that this is synchronized, i.e. the main interpreter is locked for exclusive access by the current thread within the process. However, running Apache in a prefork setting sets up a main interpreter per child, so the exclusive access does not refer to server wide exclusivity, but only to child process wide exclusiveity.)

Properties are: maxrequests, maxttl, maxidletime Set or accesses properties of the interpreter class classid.

Properties are: numreq, retire, starttime, lastusedtime Sets or accesses properties of the current interpreter.

Hook to define interpreter classes depending on the requested file. Note that this hook must be defined in the Websh configuration file (WebshConfig directive of mod_websh).

When a request is directed to mod_websh, Websh needs to determine the interpreter class for that reqest. It does that by calling web::interpmap with the requested file as argument. The return value of that command is the name of the interpreter class and at the same time the filename of the script for this interpreter class.

	    proc web::interpmap {filename} {
	        if {[string match "/path/to/myApp" $filename]} {
	            # this is my special app
	            return /real/path/to/myApp
	        }
	        if {[string match "*.ws3"]} {
	            # scripts have their own interp class
	            return $filename
	        }
	        # default: all templates are handled by my handler
	        return /my/special/template/handler
	    }
	  

	  proc web::interpmap {filename} {return $filename}