loadTk man page on YellowDog

Man page or keyword search:  
man Server   18644 pages
apropos Keyword Search (all sections)
Output format
YellowDog logo
[printable version]

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

______________________________________________________________________________

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 ability 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  initial‐
       ized with ::safe::interpInit.  The command returns the name of the safe
       interpreter.  If -use 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  (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 ISSUES section below for implementa‐
       tion details.

SECURITY ISSUES
       Please read the safe manual page for Tcl to learn about the basic secu‐
       rity considerations for Safe Tcl.

       ::safe::loadTk  adds  the  value	 of  tk_library	 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	(Tk_SafeInit)  is called and in turn calls the
       master's ::safe::InitTk it will	return	the  desired  argv  equivalent
       (-use windowId, correct -display, etc.)

       When  -use 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 -use and -display are likely to generate a fatal  X
       error.

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

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

Tk				      8.0			    Safe Tk(n)
[top]

List of man pages available for YellowDog

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net