Safe Tk(n) Tk Built-In Commands Safe Tk(n)

NAME
       loadTk - Load Tk into a safe interpreter.

SYNOPSIS
       ::::ssaaffee::::llooaaddTTkk slave ?-uussee windowId? ?-ddiissppllaayy 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 ability to configure the interpreter
       for safe Tk operations and load Tk into safe interpreters.


DESCRIPTION
       The ::::ssaaffee::::llooaaddTTkk command initializes the required data structures  in
       the  named safe interpreter and then loads Tk into it.  The interpreter
       must have been created with ::::ssaaffee::::iinntteerrppCCrreeaattee or have been  initial-
       ized with ::::ssaaffee::::iinntteerrppIInniitt.  The command returns the name of the safe
       interpreter.  If -uussee is specified, the window identified by the speci-
       fied  system dependent identifier windowId 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  (eg:  ..xx..yy) instead of its window Id ([[wwiinnffoo iidd
       ..xx..yy]]).  When -uussee 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  -ddiissppllaayy.   See the SSEECCUURRIITTYY IISSSSUUEESS section below for implementa-
       tion details.


SSEECCUURRIITTYY IISSSSUUEESS
       Please read the ssaaffee manual page for Tcl to learn about the basic secu-
       rity considerations for Safe Tcl.

       ::::ssaaffee::::llooaaddTTkk  adds  the  value  of  ttkklliibbrraarryy  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. ::::ssaaffee::::llooaaddTTkk registers the slave's  name  so  when
       the  Tk  initialization  (TTkkSSaaffeeIInniitt)  is called and in turn calls the
       master's ::::ssaaffee::::IInniittTTkk it will  return  the  desired  aarrggvv  equivalent
       (-uussee windowId, correct -ddiissppllaayy, etc...).

       When  -uussee is 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 -uussee and -ddiissppllaayy are likely to generate a fatal  X
       error.


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


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



Tk                                    8.0                           Safe Tk(n)