storage.tcl Annotations

Persistent storage across reboots. It relies on distribution-specific event handlers that will copy the data to persistent storage, except if the STORAGE_FILE already resides in a persistent directory. File is always restored on boot. Data are accessed as an array. We refer to this persistent storage as Storage. The Storage is appropriate for information that are not suitable for the main conf, such as time of last log-in, reason of last reboot, log-in history, failed login attempts, and other casual information that are not part of the router configuration as such. Warning: Notice that this Storage facility is only for the Master Interpreter/Thread. It is not meant to be used for concurrent use by Master and Session threads/interp. @changelog * @copyright 2007-2008 Alexandros Stergiakis

Author:

Alexandros Stergiakis

Procedure Detail

load

proc load {  }

Loads stored information from last boot in the global namespace as an array named "Storage". Access to the Storage array can then be done as usual with the "global" command.

Defined in:

storage.tcl, line 71

unload

proc unload {  }

Unloads Storage from the global namespace and invokes "update" to save it. Access with the "global" command will not be possible after this.

Defined in:

storage.tcl, line 88

update

proc update { args }

Invoked with a trace when-ever Storage is modified. @assume storage::load is executed before.

Defined in:

storage.tcl, line 51