Tk Built-In Commands                                  Safe Tk(1T)





NAME
     loadTk - Load Tk into a safe interpreter.

SYNOPSIS
     ::safe::loadTk slave ?-use windowId? ?-display displayName?


     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  abil-
     ity  to configure the interpreter for safe Tk operations and
     load Tk into safe interpreters.


DESCRIPTION
     The ::safe::loadTk command  initializes  the  required  data
     structures  in  the named safe interpreter and then loads Tk
     into it.   The  interpreter  must  have  been  created  with
     ::safe::interpCreate   or   have   been   initialized   with
     ::safe::interpInit.  The command returns  the  name  of  the
     safe  interpreter.  If -use is specified, the window identi-
     fied by the specified system dependent  identifier  windowId
     is  used  to  contain  the  ``.''  window of the safe inter-
     preter; 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 applica-
     tion  you can use the window name (e.g. .x.y) instead of its
     window Id ([winfo id .x.y]).  When -use is 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
     -display.  See the SECURITY ISUES section below for  imple-
     mentation details.


SECURITY ISUES
     Please read the safe manual page for Tcl to learn about  the
     basic security considerations for Safe Tcl.

     ::safe::loadTk adds the value of tklibrary taken  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. ::safe::loadTk registers the
     slave's name so when the Tk initialization (TkSafeInit)  is
     called and in turn calls the master's ::safe::InitTk it will
     return the desired argv equivalent (-use  windowId,  correct
     -display, etc.)



Tk                      Last change: 8.0                        1






Tk Built-In Commands                                  Safe Tk(1T)



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

     On X11, conflicting -use and -display are likely to generate
     a fatal X error.


SEE ALSO
     safe(1T), interp(1T),  library(1T),  load(1T),  package(1T),
     source(1T), unknown(1T)


KEYWORDS
     alias, auto-loading, automkindex, load, master interpreter,
     safe interpreter, slave interpreter, source


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTk         
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for Tk is available on http:/opensolaris.org.






















Tk                      Last change: 8.0                        2