::Help

Commands

AddPage [::Help]

Help, Top

AddPage title aliases body

Parameters
title
aliases
body

Back [::Help]

Help, Top

Back w

Parameters
w

BuildTOC [::Help]

Help, Top

BuildTOC

ButtonPress [::Help]

Help, Top

ButtonPress

CheckLinks [::Help]

Help, Top

CheckLinks title

Parameters
title

Click [::Help]

Help, Top

Click w x y

Parameters
w
x
y

CreateHelp [::Help]

Help, Top

CreateHelp w

Parameters
w

CreateTOC [::Help]

Help, Top

CreateTOC TOC

Parameters
TOC

DoDisplay [::Help]

Help, Top

DoDisplay top

Parameters
top

DoSearch [::Help]

Help, Top

DoSearch w

Parameters
w

FindPage [::Help]

Help, Top

FindPage title

Parameters
title

Help [::Help]

Help, Top

Help title

Parameters
title(optional, default )

Listpage [::Help]

Help, Top

Listpage w llist

Parameters
w
llist

Next [::Help]

Help, Top

Next w dir

Parameters
w
dir

ReadHelpFiles [::Help]

Help, Top

Initiates the Viewhelp module. It sets the language locale for msgcat and loads the appropriate language file into the namespace ::Help. Then it looks in the passed directory for the manual contained in the "help.txt" file. The text is split into section according to the "title:" markers. Then the sections are passed to AddPage to populate the ::Help::pages() array with all help pages. Finally BuildTOC constructs the TOC.

ReadHelpFiles dir locale

Parameters
dir the directory in which the file help.txt is searched for
locale the locale according to the resource file .gorillarc
Description

Initiates the Viewhelp module. It sets the language locale for msgcat and loads the appropriate language file into the namespace ::Help. Then it looks in the passed directory for the manual contained in the "help.txt" file. The text is split into section according to the "title:" markers. Then the sections are passed to AddPage to populate the ::Help::pages() array with all help pages. Finally BuildTOC constructs the TOC.

Reset [::Help]

Help, Top

Reset

Sanity [::Help]

Help, Top

Sanity

Search [::Help]

Help, Top

Search w

Parameters
w

Show [::Help]

Help, Top

Show title

Parameters
title

Showlink [::Help]

Help, Top

Showlink w link tag

Parameters
w
link
tag(optional, default )

ShowPage [::Help]

Help, Top

ShowPage w title

Parameters
w
title

TreeviewSelection [::Help]

Help, Top

TreeviewSelection

::critcl2

Commands

loadlib [::critcl2]

critcl2, Top

loadlib dir package version mapping args

Parameters
dir
package
version
mapping
argsAdditional options.

precopy [::critcl2]

critcl2, Top

precopy dll

Parameters
dll

::gorilla

Commands

About [::gorilla]

gorilla, Top

About

AddAllRecordsToTree [::gorilla]

gorilla, Top

AddAllRecordsToTree

AddGroup [::gorilla]

gorilla, Top

AddGroup

AddGroupToTree [::gorilla]

gorilla, Top

AddGroupToTree groupName

Parameters
groupName

AddLogin [::gorilla]

gorilla, Top

since version 1.5.3.4 only the non-modal version is used

AddLogin

Description

since version 1.5.3.4 only the non-modal version is used

AddRecordToTree [::gorilla]

gorilla, Top

AddRecordToTree rn

Parameters
rn

addRufftoHelp [::gorilla]

gorilla, Top

Appends an entry to the menu passed in that will call the Ruff! documentation processor to produce source docs.

addRufftoHelp menu

Parameters
menu The menu proc to which to append the ruff command entry
Description

Appends an entry to the menu passed in that will call the Ruff! documentation processor to produce source docs.

This needs ruff! and struct::list from tcllib - both should be installed properly for this option to work

AddSubgroup [::gorilla]

gorilla, Top

AddSubgroup

AddSubgroupToGroup [::gorilla]

gorilla, Top

AddSubgroupToGroup parentName

Parameters
parentName

ArrangeIdleTimeout [::gorilla]

gorilla, Top

ArrangeIdleTimeout

ArrangeToClearClipboard [::gorilla]

gorilla, Top

ArrangeToClearClipboard mult

Parameters
mult(optional, default 1)

build-merge-widgets [::gorilla]

gorilla, Top

Builds the actual contents of each conflict tab in the tabset

build-merge-widgets container ns current_dbidx merged_dbidx

Parameters
container the outer "frame" into which to build the widgets
ns the namespace assigned to this conflict pair
current_dbidx the gorillaDB index value of the existing db entry
merged_dbidx the gorilalDB index value of the entry that was
Description

Builds the actual contents of each conflict tab in the tabset

merged into this db and conflicted with an existing entry

ChangePassword [::gorilla]

gorilla, Top

ChangePassword

CheckDefaultExtension [::gorilla]

gorilla, Top

CheckDefaultExtension name extension

Parameters
name
extension

ClearClipboard [::gorilla]

gorilla, Top

ClearClipboard

ClearStatus [::gorilla]

gorilla, Top

ClearStatus

CloseDialog [::gorilla]

gorilla, Top

CloseDialog top

Parameters
top

CloseFindDialog [::gorilla]

gorilla, Top

CloseFindDialog

CloseLockedDatabaseDialog [::gorilla]

gorilla, Top

CloseLockedDatabaseDialog

CollectTicks [::gorilla]

gorilla, Top

CollectTicks

conflict-dialog [::gorilla]

gorilla, Top

Creates a toplevel dialog for use in handling merge conflicts in a straightforward manner

conflict-dialog conflict_list

Parameters
conflict_list a list of database record ID numbers that are in
Description

Creates a toplevel dialog for use in handling merge conflicts in a straightforward manner

conflict, each pair of ID numbers is one conflict, first number is the current DB entry, second number is the new merged DB entry

CopyToClipboard [::gorilla]

gorilla, Top

Copies a data value to the clipboard

CopyToClipboard what mult

Parameters
what One of "URL" "Username" or "Password"
mult(optional, default 1) Clipboard clear time multiplication factor, optional, defaults to 1
Description

Copies a data value to the clipboard

Consolidates all of the copy to clipboard management code into a single proc.

DatabasePreferencesDialog [::gorilla]

gorilla, Top

DatabasePreferencesDialog

DeleteGroup [::gorilla]

gorilla, Top

DeleteGroup

DeleteGroupRek [::gorilla]

gorilla, Top

DeleteGroupRek node

Parameters
node

DeleteLogin [::gorilla]

gorilla, Top

DeleteLogin

DestroyAboutDialog [::gorilla]

gorilla, Top

DestroyAboutDialog

DestroyAddSubgroupDialog [::gorilla]

gorilla, Top

DestroyAddSubgroupDialog

DestroyDatabasePreferencesDialog [::gorilla]

gorilla, Top

DestroyDatabasePreferencesDialog

DestroyDialog [::gorilla]

gorilla, Top

DestroyDialog top

Parameters
top

DestroyExportDialog [::gorilla]

gorilla, Top

DestroyExportDialog

DestroyGetPasswordDialog [::gorilla]

gorilla, Top

DestroyGetPasswordDialog

DestroyMergeReport [::gorilla]

gorilla, Top

DestroyMergeReport

DestroyOpenDatabaseDialog [::gorilla]

gorilla, Top

DestroyOpenDatabaseDialog

DestroyPasswordPolicyDialog [::gorilla]

gorilla, Top

DestroyPasswordPolicyDialog

DestroyPreferencesDialog [::gorilla]

gorilla, Top

DestroyPreferencesDialog

DestroyRenameGroupDialog [::gorilla]

gorilla, Top

DestroyRenameGroupDialog

DestroyTextFileDialog [::gorilla]

gorilla, Top

DestroyTextFileDialog top

Parameters
top

EditLogin [::gorilla]

gorilla, Top

modal version is deprecated, renamed to gorilla::EditLoginModal since version 1.5.3.4 only the non-modal version is used

EditLogin

Description

modal version is deprecated, renamed to gorilla::EditLoginModal since version 1.5.3.4 only the non-modal version is used

ErrorPopup [::gorilla]

gorilla, Top

a small helper proc to encapsulate all the details of opening a tk_messageBox with a title and message

ErrorPopup title message

Parameters
title
message
Description

a small helper proc to encapsulate all the details of opening a tk_messageBox with a title and message

EvalIfStateNormal [::gorilla]

gorilla, Top

EvalIfStateNormal menuentry index

Parameters
menuentry
index

Exit [::gorilla]

gorilla, Top

Exit

Export [::gorilla]

gorilla, Top

Export

Feedback [::gorilla]

gorilla, Top

A proc to place a message string into the Gorilla status line. This encapuslates the "set" to a global var plus the update idletasks for the status line into a single proc, making the code elsewhere slightly cleaner.

Feedback message

Parameters
message the message string to be placed in the status line.
Description

A proc to place a message string into the Gorilla status line. This encapuslates the "set" to a global var plus the update idletasks for the status line into a single proc, making the code elsewhere slightly cleaner.

returns GORILLA_OK as it should always perform its task

filename_query [::gorilla]

gorilla, Top

filename_query type args

Parameters
type
argsAdditional options.

fill-combobox-with-grouplist [::gorilla]

gorilla, Top

handles filling in the entries in the dropdown list for the group combo box - done this way for two reasons: 1) the dropdown box will always reflect the current group names; and 2) I am contemplating allowing a "limit the list" capability based upon the current value of the combo box

fill-combobox-with-grouplist win

Parameters
win
Description

handles filling in the entries in the dropdown list for the group combo box - done this way for two reasons: 1) the dropdown box will always reflect the current group names; and 2) I am contemplating allowing a "limit the list" capability based upon the current value of the combo box

Find [::gorilla]

gorilla, Top

Find

FindCompare [::gorilla]

gorilla, Top

FindCompare needle haystack caseSensitive

Parameters
needle
haystack
caseSensitive

FindNext [::gorilla]

gorilla, Top

FindNext

FindNextNode [::gorilla]

gorilla, Top

If this node has children, return the first child.

FindNextNode node

Parameters
node
Description

If this node has children, return the first child.

GeneratePassword [::gorilla]

gorilla, Top

GeneratePassword settings

Parameters
settings

get-selected-tree-data [::gorilla]

gorilla, Top

Returns the type (group/login) and db record number of the selected ttk::treeview entry

get-selected-tree-data returninfo

Parameters
returninfo(optional, default )
Return value

Returns the type (group/login) and db record number of the selected ttk::treeview entry

Description

If nothing in tree is selected, then what is returned depends upon the returninfo variable. If returninfo is empty, return an empty three element list. If returninfo is the word RETURN, then perform a -code return to cause the calling proc to return. Otherwise, feed the contents of returninfo through mc and set the gorilla::status variable, and then return a -code return.

getAvailableLanguages [::gorilla]

gorilla, Top

getAvailableLanguages

GetDefaultPasswordPolicy [::gorilla]

gorilla, Top

GetDefaultPasswordPolicy

GetPassword [::gorilla]

gorilla, Top

GetPassword confirm title

Parameters
confirm
title

GetSelectedNode [::gorilla]

gorilla, Top

returns node at mouse position

GetSelectedNode x y

Parameters
x
y
Description

returns node at mouse position

GetSelectedPassword [::gorilla]

gorilla, Top

Retreive the password of the selected item in the treeview

GetSelectedPassword

Description

Retreive the password of the selected item in the treeview

GetSelectedRecord [::gorilla]

gorilla, Top

Obtain the db record number of the selected item in the treeview

GetSelectedRecord

Description

Obtain the db record number of the selected item in the treeview

GetSelectedURL [::gorilla]

gorilla, Top

GetSelectedURL

GetSelectedUsername [::gorilla]

gorilla, Top

Retreive the username of the selected item in the treeview

GetSelectedUsername

Description

Retreive the username of the selected item in the treeview

GroupPopup [::gorilla]

gorilla, Top

GroupPopup node xpos ypos

Parameters
node
xpos
ypos

Help [::gorilla]

gorilla, Top

Help

IdleTimeout [::gorilla]

gorilla, Top

IdleTimeout

Import [::gorilla]

gorilla, Top

Import a csv file and add the entries therein to the currently open database

Import input_file

Parameters
input_file(optional, default )
Description

Import a csv file and add the entries therein to the currently open database

Init [::gorilla]

gorilla, Top

Init

InitGui [::gorilla]

gorilla, Top

themed widgets do'nt know a resource database option add *Button.font {Helvetica 10 bold} option add *title.font {Helvetica 16 bold}

InitGui

Description

themed widgets do'nt know a resource database option add *Button.font {Helvetica 10 bold} option add *title.font {Helvetica 16 bold}

InitPRNG [::gorilla]

gorilla, Top

Initialize the ISAAC PRNG seed. Takes one parameter.

InitPRNG seed

Parameters
seed(optional, default ) a value to use as the seed for the PRNG. The input value will
Description

Initialize the ISAAC PRNG seed. Takes one parameter.

have some more tidbits of system details appended to hopefully increase the possible entropy and will then be hashed by sha256 to obtain 32 bytes of binary seed data.

If /dev/urandom is available, it will be used to obtain 992 more bytes of higher quality random data to fill out the full 256 by 32bit seed size of the ISAAC PRNG. If /dev/urandom is not available, ISAAC itself will be used to pad out 992 additional bytes of seed data during a second call to this proc by the password unlock code.

Note as well that the choice of /dev/urandom for additional PRNG seed randomness is purposeful. The /dev/random device is defined as blocking if there is insufficient entropy in the kernel random pool to generate random output data. Blocking on /dev/random will make all of PWGorilla appear to hang, potentially for a quite lengthy and completely indeterminate amount of time given that 992 bytes of data are being read.

992 bytes of very good quality random data from /dev/urandom is an order of magnitude or more (likely much more) better random seed source than what PWGorilla was historically utilizing (16 bytes of modified sha1 output). As such the fact that /dev/urandom is not defined as cryptographic quality is mitigated somewhat by obtaining such a large amount of data, of a much higher quality than previously, that the net effect is that PWGorilla's random number generation has increased in quality significantly on any system having a working /dev/urandom device. All without appearing to hang for a lengthy period of time.

LaunchBrowser [::gorilla]

gorilla, Top

add quotes around the URL value to protect it from most issues with {*} expansion

LaunchBrowser rn

Parameters
rn
Description

add quotes around the URL value to protect it from most issues with {*} expansion

License [::gorilla]

gorilla, Top

License

LoadPreferences [::gorilla]

gorilla, Top

LoadPreferences

LoadPreferencesFromRCFile [::gorilla]

gorilla, Top

The (rc) entry in the preferences array is utilized to hold the value from the command line -rc switch

LoadPreferencesFromRCFile

Description

The (rc) entry in the preferences array is utilized to hold the value from the command line -rc switch

LoadPreferencesFromRegistry [::gorilla]

gorilla, Top

LoadPreferencesFromRegistry

LockDatabase [::gorilla]

gorilla, Top

LockDatabase

LockDirtyHandler [::gorilla]

gorilla, Top

LockDirtyHandler win args

Parameters
win
argsAdditional options.

LockDirtyMessage [::gorilla]

gorilla, Top

LockDirtyMessage

LoginPopup [::gorilla]

gorilla, Top

Creates the popup menu widget for the right clicks on a tree item

LoginPopup node xpos ypos

Parameters
node node index for right-clicked tree item
xpos
ypos
Description

Creates the popup menu widget for the right clicks on a tree item

xpos, ypos - root coordinates for the popup menu

LookupNodeData [::gorilla]

gorilla, Top

Takes a treeview node ID value and returns the node values and the node type value as a list.

LookupNodeData node

Parameters
node a treeview node identifier
Description

Takes a treeview node ID value and returns the node values and the node type value as a list.

MarkDatabaseAsDirty [::gorilla]

gorilla, Top

MarkDatabaseAsDirty

Merge [::gorilla]

gorilla, Top

Merge

merge-destroy [::gorilla]

gorilla, Top

Called to destroy a merge widget set. Also checks to see if the tabset of the toplevel window becomes empty due to the destruction of the last contained merge widget set and if so also destroys the toplevel

merge-destroy container tabset

Parameters
container the container to destroy
tabset the tabset to check for emptiness
Description

Called to destroy a merge widget set. Also checks to see if the tabset of the toplevel window becomes empty due to the destruction of the last contained merge widget set and if so also destroys the toplevel

MoveDialog [::gorilla]

gorilla, Top

MoveDialog type

Parameters
type

MoveGroup [::gorilla]

gorilla, Top

MoveGroup

MoveLogin [::gorilla]

gorilla, Top

MoveLogin

MoveTreeNode [::gorilla]

gorilla, Top

MoveTreeNode node dest

Parameters
node
dest

MoveTreeNodeRek [::gorilla]

gorilla, Top

MoveTreeNodeRek node newParents

Parameters
node
newParents

New [::gorilla]

gorilla, Top

New

Open [::gorilla]

gorilla, Top

If the current database was modified, give user a chance to think

Open defaultFile

Parameters
defaultFile(optional, default )
Description

If the current database was modified, give user a chance to think

OpenDatabase [::gorilla]

gorilla, Top

OpenDatabase title defaultFile allowNew

Parameters
title
defaultFile(optional, default )
allowNew(optional, default 0)

PasswordPolicy [::gorilla]

gorilla, Top

PasswordPolicy

PasswordPolicyDialog [::gorilla]

gorilla, Top

PasswordPolicyDialog title settings

Parameters
title
settings

populateLoginPopup [::gorilla]

gorilla, Top

builds the dynamic menu of group names for the right click move-to function

populateLoginPopup win

Parameters
win
Description

builds the dynamic menu of group names for the right click move-to function

PopupAddSubgroup [::gorilla]

gorilla, Top

PopupAddSubgroup

PopupCopyPassword [::gorilla]

gorilla, Top

PopupCopyPassword

PopupCopyURL [::gorilla]

gorilla, Top

PopupCopyURL

PopupCopyUsername [::gorilla]

gorilla, Top

PopupCopyUsername

PopupDeleteGroup [::gorilla]

gorilla, Top

PopupDeleteGroup

PopupDeleteLogin [::gorilla]

gorilla, Top

PopupDeleteLogin

PopupEditLogin [::gorilla]

gorilla, Top

PopupEditLogin

PopupRenameGroup [::gorilla]

gorilla, Top

PopupRenameGroup

PopupViewLogin [::gorilla]

gorilla, Top

PopupViewLogin

Preferences [::gorilla]

gorilla, Top

Preferences

PreferencesDialog [::gorilla]

gorilla, Top

PreferencesDialog

PreferencesSpinBoxValidate [::gorilla]

gorilla, Top

PreferencesSpinBoxValidate value

Parameters
value

quoteBackslashes [::gorilla]

gorilla, Top

quoteBackslashes str

Parameters
str

remove-from-conflict-list [::gorilla]

gorilla, Top

remove this entry from the global merge conflict data list

remove-from-conflict-list current_dbidx merged_dbidx current_tree_node merged_tree_node

Parameters
current_dbidx
merged_dbidx
current_tree_node
merged_tree_node
Description

remove this entry from the global merge conflict data list

RenameGroup [::gorilla]

gorilla, Top

RenameGroup

RunFind [::gorilla]

gorilla, Top

RunFind

Save [::gorilla]

gorilla, Top

Save

SaveAs [::gorilla]

gorilla, Top

SaveAs

SaveBackup [::gorilla]

gorilla, Top

tries to backup the actual database observing the keepBackupFile flag. If the backup fails an errorType and a errorMessage string filtered by msgcat are returned.

SaveBackup filename

Parameters
filename
Description

tries to backup the actual database observing the keepBackupFile flag. If the backup fails an errorType and a errorMessage string filtered by msgcat are returned.

If the timestamp flag is set the backup file gets a timestamp appendix according to the local settings

filename name of current database containing full path

SavePreferences [::gorilla]

gorilla, Top

SavePreferences

SavePreferencesToRCFile [::gorilla]

gorilla, Top

SavePreferencesToRCFile

SavePreferencesToRegistry [::gorilla]

gorilla, Top

SavePreferencesToRegistry

SetDefaultPasswordPolicy [::gorilla]

gorilla, Top

SetDefaultPasswordPolicy settings

Parameters
settings

setup-default-dirname [::gorilla]

gorilla, Top

Makes sure that the global ::gorilla::dirName variable is set to a sensible default if it does not already exist.

setup-default-dirname

Description

Makes sure that the global ::gorilla::dirName variable is set to a sensible default if it does not already exist.

Side-effect of modifying the global ::gorilla::dirName variable

ShowTextFile [::gorilla]

gorilla, Top

ShowTextFile top title fileName

Parameters
top
title
fileName

StatusModified [::gorilla]

gorilla, Top

StatusModified name1 name2 op

Parameters
name1
name2
op

TreeNodeDouble [::gorilla]

gorilla, Top

TreeNodeDouble node

Parameters
node

TreeNodePopup [::gorilla]

gorilla, Top

TreeNodePopup node

Parameters
node

TreeNodeSelect [::gorilla]

gorilla, Top

TreeNodeSelect node

Parameters
node

TreeNodeSelectionChanged [::gorilla]

gorilla, Top

TreeNodeSelectionChanged

TryResizeFromPreference [::gorilla]

gorilla, Top

TryResizeFromPreference top

Parameters
top

UpdateMenu [::gorilla]

gorilla, Top

UpdateMenu

versionCallback [::gorilla]

gorilla, Top

versionCallback w token total current

Parameters
w
token
total
current

versionDownload [::gorilla]

gorilla, Top

versionDownload githubVersion url

Parameters
githubVersion actual version on Github server
url the url of the file to be downloaded

versionGet [::gorilla]

gorilla, Top

versionGet platform

Parameters
platform The Tk windowingsystem or string "source"
Description

returns list: version url || 0 errormessage

versionIsNewer [::gorilla]

gorilla, Top

versionIsNewer github

Parameters
github Version downloaded from Github version.txt
Description

format is: n.n.n(...) returns 1 if github version is newer otherwise 0

versionLookup [::gorilla]

gorilla, Top

Look if there is a new version on the Github Download site. The version data are contained in the file version.txt

versionLookup

Description

Look if there is a new version on the Github Download site. The version data are contained in the file version.txt

ViewEntry [::gorilla]

gorilla, Top

proposed by Richard Ellis, 04.08.2010 ViewLogin: non modal and everything disabled EditLogin: modal dialog with changes saved

ViewEntry rn

Parameters
rn
Description

proposed by Richard Ellis, 04.08.2010 ViewLogin: non modal and everything disabled EditLogin: modal dialog with changes saved

ViewEntryShowPWHelper [::gorilla]

gorilla, Top

ViewEntryShowPWHelper button entry rn

Parameters
button
entry
rn

ViewLogin [::gorilla]

gorilla, Top

ViewLogin

XSelectionHandler [::gorilla]

gorilla, Top

XSelectionHandler offset maxChars

Parameters
offset
maxChars

::gorilla::LoginDialog

Commands

AddLogin [::gorilla::LoginDialog]

LoginDialog, Top

AddLogin

build-gui-callbacks [::gorilla::LoginDialog]

LoginDialog, Top

This builds the callback procs that will handle this dialogs interaction with the user - generation of these procs borrows a bit of ideas from Lisp macros to avoid having to pass a bunch of constants around in proc parameters (i.e., the pvns name or the widget path/proc names) or having the procs reference a bunch of quasi-global variables

build-gui-callbacks pvns widgets

Parameters
pvns the name of the private variable namespace for the dialog. The GUI interaction procs will be built within this namespace.
widgets
Description

This builds the callback procs that will handle this dialogs interaction with the user - generation of these procs borrows a bit of ideas from Lisp macros to avoid having to pass a bunch of constants around in proc parameters (i.e., the pvns name or the widget path/proc names) or having the procs reference a bunch of quasi-global variables

widgets A key/value list (i.e. a dict or a list from array get) of descriptive widget names and the actual widget window pathname to apply as the "macro" transformations for each proc built. Each key will be substituted for the value of that key in the body of each proc, with the result being that the resulting procs are "customized" at build time to know which GUI widgets to access for performing their relevant functions.

BuildLoginDialog [::gorilla::LoginDialog]

LoginDialog, Top

Builds out the widgets to create a single instance of an edit login dialog window.

BuildLoginDialog top pvns

Parameters
top the parent window for all of the component widgets.
pvns
Description

Builds out the widgets to create a single instance of an edit login dialog window.

pvns the private variable namespace which has been assigned to

this login dialog window to hold -textvariables and GUI event callback procedures specific to this particular edit login window.

Does not return any useful value to the caller.

calculateWraplength [::gorilla::LoginDialog]

LoginDialog, Top

calculateWraplength lengths

Parameters
lengths

convert_map [::gorilla::LoginDialog]

LoginDialog, Top

convert_map map

Parameters
map

DestroyLoginDialog [::gorilla::LoginDialog]

LoginDialog, Top

Used to withdraw, reset, and store for later an edit dialog from the screen.

DestroyLoginDialog win

Parameters
win the toplevel name of the edit dialog to withdraw, reset, and store.
Description

Used to withdraw, reset, and store for later an edit dialog from the screen.

EditLogin [::gorilla::LoginDialog]

LoginDialog, Top

EditLogin

get-pvns-from-toplevel [::gorilla::LoginDialog]

LoginDialog, Top

Extracts the private namespace name for an edit dialog

get-pvns-from-toplevel top

Parameters
top the toplevel name of an edit dialog from which to extract the private variable namespace
Description

Extracts the private namespace name for an edit dialog

info [::gorilla::LoginDialog]

LoginDialog, Top

A testing proc for debugging purposes

info

Description

A testing proc for debugging purposes

K [::gorilla::LoginDialog]

LoginDialog, Top

K x y

Parameters
x
y

LoginDialog [::gorilla::LoginDialog]

LoginDialog, Top

Open a dialog to edit/create an entry in the login DB.

LoginDialog args

Parameters
argsAdditional options.
-group Set initial "group" name to apply to a new record. This initializes the "group" field of the edit dialog.
-rn Record number from Itcl login DB to edit. Magic record number -999 is defined to mean edit a new (blank) record. Defaults to -999 if not provided.
-treenode The ttk::treeview node ID of an existing record when a user requests editing of an existing record. This is used to update the tree display when a user clicks "Ok" to their changes.
Description

Open a dialog to edit/create an entry in the login DB.

Requirements: If -rn is not -999 then the record number must exist in the Itcl DB when called. In addition, to edit an existing record, the -treenode value must also be passed in.

Additionally, a simple check is made such that there is a one to one mapping of existing record numbers to open edit dialogs. It is disallowed to edit the exact same record in two independent dialogs simultaneously.

make-label [::gorilla::LoginDialog]

LoginDialog, Top

A helper proc to generate a ttk::label element for the Edit Login Dialog. Collapses all of the details of label creation into one place. Also autogenerates a unique label name.

make-label top text

Parameters
top the parent window of the new label window.
text
Return value

Returns the generated label name.

Description

A helper proc to generate a ttk::label element for the Edit Login Dialog. Collapses all of the details of label creation into one place. Also autogenerates a unique label name.

text the textual value to place in the label. Will have a colon

appended and the result will then be passed through mc for translation purposes (i.e., the colon becomes part of the "mc" string for translation).

pop [::gorilla::LoginDialog]

LoginDialog, Top

Remove a window name from the stack in the idle-windows namespace variable. Side-effect: Modifes namespace variable idle-windows.

pop

Description

Remove a window name from the stack in the idle-windows namespace variable. Side-effect: Modifes namespace variable idle-windows.

This is used to maintain a list of "inactive" withdrawn dialogs for reuse in future edit requests. Such avoids having to rebuild both the dialog as well as the dialog state space and GUI handling procs.

push [::gorilla::LoginDialog]

LoginDialog, Top

add an window name to the end of the namespace variable idle-windows

push win

Parameters
win the window name to "push" onto the idle-windows stack variable
Description

add an window name to the end of the namespace variable idle-windows

Side-effect: Modifes namespace variable idle-windows.

This is used to maintain a list of "inactive" withdrawn dialogs for reuse in future edit requests. Such avoids having to rebuild both the dialog as well as the dialog state space and GUI handling procs.

smacro [::gorilla::LoginDialog]

LoginDialog, Top

smacro map body

Parameters
map
body

wrap-measure [::gorilla::LoginDialog]

LoginDialog, Top

wrap-measure text

Parameters
text(optional, default )

::gorilla::dbget

Commands

create-time [::gorilla::dbget]

dbget, Top

create-time rn default

Parameters
rn
default(optional, default )

get-date-record [::gorilla::dbget]

dbget, Top

get-date-record element recnum default

Parameters
element
recnum
default

get-record [::gorilla::dbget]

dbget, Top

get-record element recnum default

Parameters
element
recnum
default

group [::gorilla::dbget]

dbget, Top

group rn default

Parameters
rn
default(optional, default )

last-access [::gorilla::dbget]

dbget, Top

last-access rn default

Parameters
rn
default(optional, default )

last-modified [::gorilla::dbget]

dbget, Top

last-modified rn default

Parameters
rn
default(optional, default )

last-pass-change [::gorilla::dbget]

dbget, Top

last-pass-change rn default

Parameters
rn
default(optional, default )

lifetime [::gorilla::dbget]

dbget, Top

lifetime rn default

Parameters
rn
default(optional, default )

notes [::gorilla::dbget]

dbget, Top

notes rn default

Parameters
rn
default(optional, default )

password [::gorilla::dbget]

dbget, Top

password rn default

Parameters
rn
default(optional, default )

title [::gorilla::dbget]

dbget, Top

title rn default

Parameters
rn
default(optional, default )

url [::gorilla::dbget]

dbget, Top

url rn default

Parameters
rn
default(optional, default )

user [::gorilla::dbget]

dbget, Top

user rn default

Parameters
rn
default(optional, default )

username [::gorilla::dbget]

dbget, Top

username rn default

Parameters
rn
default(optional, default )

uuid [::gorilla::dbget]

dbget, Top

uuid rn default

Parameters
rn
default(optional, default )

::gorilla::dbset

Commands

create-time [::gorilla::dbset]

dbset, Top

create-time rn value

Parameters
rn
value

create-time-string [::gorilla::dbset]

dbset, Top

create-time-string rn value

Parameters
rn
value

group [::gorilla::dbset]

dbset, Top

group rn value

Parameters
rn
value

last-access [::gorilla::dbset]

dbset, Top

last-access rn value

Parameters
rn
value

last-access-string [::gorilla::dbset]

dbset, Top

last-access-string rn value

Parameters
rn
value

last-modified [::gorilla::dbset]

dbset, Top

last-modified rn value

Parameters
rn
value

last-modified-string [::gorilla::dbset]

dbset, Top

last-modified-string rn value

Parameters
rn
value

last-pass-change [::gorilla::dbset]

dbset, Top

last-pass-change rn value

Parameters
rn
value

last-pass-change-string [::gorilla::dbset]

dbset, Top

last-pass-change-string rn value

Parameters
rn
value

lifetime [::gorilla::dbset]

dbset, Top

lifetime rn value

Parameters
rn
value

lifetime-string [::gorilla::dbset]

dbset, Top

lifetime-string rn value

Parameters
rn
value

notes [::gorilla::dbset]

dbset, Top

notes rn value

Parameters
rn
value

password [::gorilla::dbset]

dbset, Top

password rn value

Parameters
rn
value

title [::gorilla::dbset]

dbset, Top

title rn value

Parameters
rn
value

url [::gorilla::dbset]

dbset, Top

url rn value

Parameters
rn
value

user [::gorilla::dbset]

dbset, Top

user rn value

Parameters
rn
value

username [::gorilla::dbset]

dbset, Top

username rn value

Parameters
rn
value

uuid [::gorilla::dbset]

dbset, Top

uuid rn value

Parameters
rn
value

::gorilla::dbunset

Commands

create-time [::gorilla::dbunset]

dbunset, Top

create-time rn

Parameters
rn

group [::gorilla::dbunset]

dbunset, Top

group rn

Parameters
rn

last-access [::gorilla::dbunset]

dbunset, Top

last-access rn

Parameters
rn

last-modified [::gorilla::dbunset]

dbunset, Top

last-modified rn

Parameters
rn

last-pass-change [::gorilla::dbunset]

dbunset, Top

last-pass-change rn

Parameters
rn

lifetime [::gorilla::dbunset]

dbunset, Top

lifetime rn

Parameters
rn

notes [::gorilla::dbunset]

dbunset, Top

notes rn

Parameters
rn

password [::gorilla::dbunset]

dbunset, Top

password rn

Parameters
rn

title [::gorilla::dbunset]

dbunset, Top

title rn

Parameters
rn

url [::gorilla::dbunset]

dbunset, Top

url rn

Parameters
rn

user [::gorilla::dbunset]

dbunset, Top

user rn

Parameters
rn

uuid [::gorilla::dbunset]

dbunset, Top

uuid rn

Parameters
rn

::gorilla::dnd

Commands

init [::gorilla::dnd]

dnd, Top

Adds drag and drop bindings to the tree widget command passed as a parameter

init tree

Parameters
tree name of tree widget onto which to add DND bindings
Description

Adds drag and drop bindings to the tree widget command passed as a parameter

Attaches event bindings to the widget passed as the sole parameter for handling drag and drop operations. Also creates a single label widget as a child of the parameter which will be utilized as a drag indicator.

tree the widget name to attach the event bindings. The created label will be a child of this widget

motion [::gorilla::dnd]

dnd, Top

Called by mouse motion event to both decide when to initiate a drag and to animate the drag as it occurs

motion tree x y

Parameters
tree the tree widget
x new mouse x position
y new mouse y position
Description

Called by mouse motion event to both decide when to initiate a drag and to animate the drag as it occurs

press [::gorilla::dnd]

dnd, Top

Called by mouse button press event to record the x,y position of the mouse cursor in preparation for a possible drag occurring.

press tree x y

Parameters
tree the tree widget
x x mouse cursor position
y y mouse cursor position
Description

Called by mouse button press event to record the x,y position of the mouse cursor in preparation for a possible drag occurring.

release [::gorilla::dnd]

dnd, Top

Called by mouse button release event. If a drag was occurring then handle actually performing the "move" of the selected items to the destination location in the tree.

release tree x y

Parameters
tree the tree widget
x mouse x position of release event
y mouse y position of release event
Description

Called by mouse button release event. If a drag was occurring then handle actually performing the "move" of the selected items to the destination location in the tree.

select [::gorilla::dnd]

dnd, Top

Called by event loop when treeview selection changes

select tree

Parameters
tree the name of the treeview widget
Description

Called by event loop when treeview selection changes

If a drag is happening then retreives the list of selected treeview rows and stores them in a namespace varaible in prepraration for a drag operation occurring. Also inserts the names of the rows in the drag label as feedback to a user for what items are being dragged.

If a drag is not happening then do nothing.

::gorilla::progress

Commands

active? [::gorilla::progress]

progress, Top

tests for progress subsystem being in active state for toplevel tl. If not forces calling proc to unconditionally return.

active? tl

Parameters
tl
Description

tests for progress subsystem being in active state for toplevel tl. If not forces calling proc to unconditionally return.

finished [::gorilla::progress]

progress, Top

Sets progress subsystem state to inactive, clears message text from the configured widget, deletes variable trace.

finished tl

Parameters
tl
Description

Sets progress subsystem state to inactive, clears message text from the configured widget, deletes variable trace.

init [::gorilla::progress]

progress, Top

Initializes the progress subsystem for use.

init args

Parameters
argsAdditional options.
-win window R Where the progress bar should appear uses toplevel window name as internal key.
Description

Initializes the progress subsystem for use.

parameters

  -message string R The message string to display in the label
                    widget associated with the progress bar.
  -max integer O Defines the range of the progress bar.  The value
                 should be integer multiplies of 100.

The message entry must contain one, and only one, %d format substitution marker. This will be replaced by the percent complete (scaled to the -max range) as given in calls to the ::gorilla::progress::update subcommand.

Note, init simply utilizes the passed message string unaltered, msgcat translations are outside the scope of this module and are expected to be handled by the code calling init, not by this module.

newmessage [::gorilla::progress]

progress, Top

Updates the internal message string and current widget text value without modifying the widget name being utilized for feedback.

newmessage tl text

Parameters
tl
text
Description

Updates the internal message string and current widget text value without modifying the widget name being utilized for feedback.

tracefired [::gorilla::progress]

progress, Top

Handles variable trace callbacks by passing current value of "value" variable to update proc

tracefired tl a b c

Parameters
tl
a
b
c
Description

Handles variable trace callbacks by passing current value of "value" variable to update proc

update-pbar [::gorilla::progress]

progress, Top

called to update the configured progress bar with a new value

update-pbar tl value

Parameters
tl the toplevel that this pbar is attached to
value
Description

called to update the configured progress bar with a new value

value the new value, can be integer or floating point, will be truncated to an integer and limited to the range 0 ... 100.

validate [::gorilla::progress]

progress, Top

Validates the contents of the passed dictionary to make sure it contains required elements, and that the elements make sense.

validate config

Parameters
config
Description

Validates the contents of the passed dictionary to make sure it contains required elements, and that the elements make sense.

validate_max [::gorilla::progress]

progress, Top

validate_max config

Parameters
config

validate_message [::gorilla::progress]

progress, Top

validate_message config

Parameters
config

validate_window [::gorilla::progress]

progress, Top

validate_window config

Parameters
config

::isaac

Commands

init [::isaac]

isaac, Top

init seed

Parameters
seed

int32 [::isaac]

isaac, Top

int32

isaac [::isaac]

isaac, Top

isaac

mix [::isaac]

isaac, Top

mix a b c d e f g h

Parameters
a
b
c
d
e
f
g
h

rand [::isaac]

isaac, Top

rand

srand [::isaac]

isaac, Top

srand seed

Parameters
seed

test [::isaac]

isaac, Top

test

test2 [::isaac]

isaac, Top

test2

::pwsafe

Commands

createFromFile [::pwsafe]

pwsafe, Top

createFromFile fileName password percentvar

Parameters
fileName
password
percentvar(optional, default )

createFromStream [::pwsafe]

pwsafe, Top

createFromStream stream password version percentvar

Parameters
stream
password
version
percentvar(optional, default )

createFromString [::pwsafe]

pwsafe, Top

createFromString data password percentvar

Parameters
data
password
percentvar(optional, default )

dumpAllRecords [::pwsafe]

pwsafe, Top

dumpAllRecords db out

Parameters
db
out

writeToFile [::pwsafe]

pwsafe, Top

writeToFile db fileName version percentvar

Parameters
db
fileName
version
percentvar(optional, default )

writeToString [::pwsafe]

pwsafe, Top

writeToString db version percentvar

Parameters
db
version
percentvar(optional, default )

::pwsafe::int

Commands

calculateKeyStrechForDelay [::pwsafe::int]

int, Top

Computes a V3 keystretch iteration value that produces a time delay of "seconds". Note that the returned value will be dependent upon whether the sha256 C extension is in use or not.

calculateKeyStrechForDelay seconds

Parameters
seconds the number of seconds that the V3 keystrech function should execute
Description

Computes a V3 keystretch iteration value that produces a time delay of "seconds". Note that the returned value will be dependent upon whether the sha256 C extension is in use or not.

returns an iteration count value

computeHRND [::pwsafe::int]

int, Top

computeHRND RND password

Parameters
RND
password

computeStretchedKey [::pwsafe::int]

int, Top

computeStretchedKey salt password iterations pvar_in

Parameters
salt
password
iterations
pvar_in

genderbender [::pwsafe::int]

int, Top

genderbender val

Parameters
val

keyStretchMsDelay [::pwsafe::int]

int, Top

Computes the time in milliseconds to perform a V3 keystretch using iter iterations

keyStretchMsDelay iter

Parameters
iter the number of iterations for the V3 keystretch algorithm
Description

Computes the time in milliseconds to perform a V3 keystretch using iter iterations

returns a time value in milliseconds

randomizeVar [::pwsafe::int]

int, Top

randomizeVar args

Parameters
argsAdditional options.

randomString [::pwsafe::int]

int, Top

randomString length

Parameters
length

sha1isz [::pwsafe::int]

int, Top

sha1isz msg isz

Parameters
msg
isz(optional, default 0)

::pwsafe::io

Commands

dumpRecord [::pwsafe::io]

io, Top

dumpRecord db out rn

Parameters
db
out
rn

::tooltip

Commands

clear [::tooltip]

tooltip, Top

clear pattern

Parameters
pattern(optional, default .*)

enableCanvas [::tooltip]

tooltip, Top

enableCanvas w args

Parameters
w
argsAdditional options.

enableListbox [::tooltip]

tooltip, Top

enableListbox w args

Parameters
w
argsAdditional options.

enableTag [::tooltip]

tooltip, Top

enableTag w tag

Parameters
w
tag

fade [::tooltip]

tooltip, Top

fade w step

Parameters
w
step

hide [::tooltip]

tooltip, Top

hide fadeOk

Parameters
fadeOk(optional, default 0)

itemTip [::tooltip]

tooltip, Top

itemTip w args

Parameters
w
argsAdditional options.

listitemMotion [::tooltip]

tooltip, Top

listitemMotion w x y

Parameters
w
x
y

listitemTip [::tooltip]

tooltip, Top

listitemTip w x y

Parameters
w
x
y

menuMotion [::tooltip]

tooltip, Top

menuMotion w

Parameters
w

register [::tooltip]

tooltip, Top

register w args

Parameters
w
argsAdditional options.

show [::tooltip]

tooltip, Top

show w msg i

Parameters
w
msg
i(optional, default )

tagTip [::tooltip]

tooltip, Top

tagTip w tag

Parameters
w
tag

tooltip [::tooltip]

tooltip, Top

tooltip w args

Parameters
w
argsAdditional options.

wname [::tooltip]

tooltip, Top

wname w

Parameters
w(optional, default )
Document generated by Ruff!