1mNAME0m
       loadTk - Load Tk into a safe interpreter.

1mSYNOPSIS0m
       1m::safe::loadTk 4m22mslave24m ?1m-use 4m22mwindowId24m? ?1m-display 4m22mdisplayName24m?

       Safe  Tk  is  based on Safe Tcl, which provides a mechanism that allows
       restricted and mediated access to auto-loading and  packages  for  safe
       interpreters.   Safe  Tk  adds the ability to configure the interpreter
       for safe Tk operations and load Tk into safe interpreters.


1mDESCRIPTION0m
       The 1m::safe::loadTk 22mcommand initializes the required data structures  in
       the  named safe interpreter and then loads Tk into it.  The interpreter
       must have been created with 1m::safe::interpCreate 22mor have been  initial-
       ized with 1m::safe::interpInit22m.  The command returns the name of the safe
       interpreter.  If 1m-use 22mis specified, the window identified by the speci-
       fied  system dependent identifier 4mwindowId24m is used to contain the ``.''
       window of the safe interpreter; it can be any valid id, eventually ref-
       erencing  a  window belonging to another application. As a convenience,
       if the window you plan to use is a Tk Window of the application you can
       use  the  window  name  (e.g. 1m.x.y22m) instead of its window Id (1m[winfo id0m
       1m.x.y]22m).  When 1m-use 22mis not specified, a new toplevel window  is  created
       for  the  ``.''  window of the safe interpreter. On X11 if you want the
       embedded window to use another display than the default one, specify it
       with  1m-display22m.   See the 1mSECURITY ISSUES 22msection below for implementa-
       tion details.


1mSECURITY ISSUES0m
       Please read the 1msafe 22mmanual page for Tcl to learn about the basic secu-
       rity considerations for Safe Tcl.

       1m::safe::loadTk  22madds  the  value  of  1mtk_library  22mtaken from the master
       interpreter to the virtual access path of the safe interpreter so  that
       auto-loading will work in the safe interpreter.


       Tk  initialization is now safe with respect to not trusting the slave's
       state for startup. 1m::safe::loadTk 22mregisters the slave's  name  so  when
       the  Tk  initialization  (1mTk_SafeInit22m)  is called and in turn calls the
       master's 1m::safe::InitTk 22mit will  return  the  desired  1margv  22mequivalent
       (1m-use 4m22mwindowId24m, correct 1m-display22m, etc.)

       When  1m-use 22mis not used, the new toplevel created is specially decorated
       so the user is always aware that the  user  interface  presented  comes
       from  a potentially unsafe code and can easily delete the corresponding
       interpreter.

       On X11, conflicting 1m-use 22mand 1m-display 22mare likely to generate a fatal  X
       error.


1mSEE ALSO0m
       safe(n),   interp(n),   library(n),   load(n),  package(n),  source(n),
       unknown(n)


1mKEYWORDS0m
       alias,  auto-loading,  auto_mkindex,  load,  master  interpreter,  safe
