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 command
       returns the name of the safe interpreter.  If 1m-use  22mis  specified,  the
       window identified by the specified system dependent identifier 4mwindowId0m
       is used to contain the ``.''  window of the safe interpreter; it can be
       any  valid  id,  eventually  referencing  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 (eg: 1m.x.y22m)
       instead of its window Id (1m[winfo id .x.y]22m).  When 1m-use  22mis  not  speci-
       fied, a new toplevel window is created for the ``.'' window of the safe
       interpreter. On X11 if you want the embedded window to use another dis-
       play  than the default one, specify it with 1m-display22m.  See the 1mSECURITY0m
       1mISSUES 22msection below for implementation 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
