Added info for 'execute xxx'

SVN revision: 611
This commit is contained in:
Stefan Ritt 2003-09-16 10:43:39 +00:00
parent 256ace67c0
commit 147f34cc28

View File

@ -339,12 +339,25 @@ if several logbooks use the same images and icons, but differnt colors. By defau
the CSS <i>default.css</i> is used. This can be overwritten by this statement.
<p>
<LI><b><code>Title image = &lt;string&gt;</code></b>
<br>
HTML code for the icon in the upper right corner. By default, following code
is used:<p>
&lt;img border=0 src="elog.gif" alt="ELOG logo"&gt;<p>
This code can be replaced by <b><code>&lt;string&gt;</code></b> to display a different
icon file, or to display some text. The icon image has to be present in the theme directory,
which is usually <b><code>&lt;elog root&gt;/themes/default</code></b>.
<p>
<LI><b><code>Title image URL = &lt;URL&gt;</code></b>
<br>
The ELOG icon at the right upper corner usually points to the ELOG home page. This
URL can be changed to point to a corporate page for example with this option. The
icon can be changed by replacing the <b><code>elog.gif</code></b> icon in the
theme directory.
theme directory. This option should only be used if the <b><code>Title image</code></b>
option is not used.
<p>
<LI><b><code>Date format = &lt;string&gt;</code></b>
@ -855,6 +868,28 @@ Values used for new message entry form:
Default is <i>"0, attribname, attribvalue, 80, 500"</i>. Trailing parameters can be ommitted,
so specifying for example only the flags is possible.
<p>
<LI><b><code>Execute new | edit | delete = &lt;command&gt;</b></code>
<br>
It is possible to execute a shell command on the server side after a new message
has been submitted, edited or deleted. This feature has been used in the past
for SMS notifications over a telephone system and for synchrnonization of the ELOG
database with an external SQL database. The <b><code>&lt;command&gt;</code></b> can
contain substitutions similar to the <b><code>Subst</code></b> command.
Following (Unix) command writes a notification into some file:<p>
<pre>
Execute new = echo "New message of type $type from $long_name on $remote_host" >> /tmp/elog.log
</pre>
<br>
It should be noted that this feature can impose a security problem. If someone can edit
the elogd.cfg through the <b><code>Config</code></b> command of elogd, that person
can put malicious code into elogd.cfg and execute it. This is even more severe if elogd
runs with root privileges. To avoid such problems, the execute facility is disabled
in elogd by default and has to be enabled explicitly with the "-x" command line flag.
The administrator has to ensure then of course that only trusted people can edit elogd.cfg.
<p>
</UL>