Veil Control Functions

Veil generally requires no management. The exception to this is when you wish to reset shared variables. You may wish to do this because your underlying security definitions have changed, or because you have added new features. In this case, you may use veil_perform_reset() to re-initialise your shared variables. This function replaces the current set of shared variables with a new set in a transaction-safe manner. All current transactions will complete with the old set of variables in place. All subsequent transactions will see the new set.

The following functions comprise the Veil control functions API:

veil_init(bool)

function veil_init(bool) returns bool
This function must be redefined by the application. The default installed version simply raises an error telling you to redefine it. See Implement the Initialisation Function for a more detailed description of this function.

veil_perform_reset()

function veil_perform_reset() returns bool
This is used to reset Veil's shared variables. It causes veil_init() to be called.

veil_force_reset(bool)

function veil_force_reset() returns bool
In the event of veil_perform_reset() failing to complete and leaving shared variables in a state of limbo, this function may be called to force the reset. After forcing the reset, this function raises a panic which will reset the database server. Use this at your peril.

veil_version()

function veil_version() returns text
This function returns a string describing the installed version of veil.

Next: Building a Veil-based secure database


Generated on Fri Mar 12 08:38:46 2010 for Veil by  doxygen 1.5.6