cryptonas-branches/translation-base-v0.3/event-scripts
lars 0a1a7bd383 started a seperate branch to manage translations for v0.3.x based on tags/v0.3.4.2
fixed corrupt language.hdf file for "volume_passwd" (merged from [891])
fixed spelling in "plugin_manager" and "volume_format_fs" (merged from [880])
merged current state of update_po_files.py (removed obsolete revert_unchanged.sh)
2007-03-29 19:04:21 +00:00
..
_event_scripts_ started a seperate branch to manage translations for v0.3.x based on tags/v0.3.4.2 2007-03-29 19:04:21 +00:00
apache2_dav started a seperate branch to manage translations for v0.3.x based on tags/v0.3.4.2 2007-03-29 19:04:21 +00:00
README started a seperate branch to manage translations for v0.3.x based on tags/v0.3.4.2 2007-03-29 19:04:21 +00:00
samba started a seperate branch to manage translations for v0.3.x based on tags/v0.3.4.2 2007-03-29 19:04:21 +00:00

Event scripts for CryptoBox events

If you want to execute specific actions according to changes of the cryptobox,
then you can just add your own scripts to this directory.
These scripts are called with root user permissions.

The common synopsis for all event scripts is:
	SCRIPTNAME EVENT [[EVENT_INFOS]...]


1) Possible events
Supported events:
	premount|postmount|preumount|postumount:
		called before and after (u)mounting of a volume
		arguments (in this order):
			- device: name of the underlying device
			- vol_name: name of the (u)mounted volume
			- vol_type: type of the volume (plain|luks)
			- mount_dir: mountpoint of the volume


2) Preperation of event scripts
Every event script has to fulfill the following conditions:
	- be executable (for the cryptobox user and for root)
	- be writeable for root only
	- its parent directories must be writeable for root only
	- the directory of the script must contain a file called '_event_scripts_' (to prevent abuse)


3) Storing settings
If your custom event script needs to write information to a file, then it
should create this file below /var/cache/cryptobox-server/settings/misc/.
(adapt this directory to your setup, if you changed the default settings of
[Locations]->SettingsDir)