CFINGERD.TEXT(5)
NAME
cfingerd.text - cfingerd text rules
EXPLANATION
cfingerd offers different commands that can be placed in text files to
display corresponding information. Each command used with cfingerd in
text files begins with a dollar-sign (or a "$"). This usually indicates to cfingerd that when it's displaying a file, it issues the command given directly after that character and inserts its output.
If you want to display a raw "$" sign, simply put two "$" signs
together, or "$$".
Text commands are only parsed if ALLOW_LINE_PARSING is enabled in
/etc/cfingerd/cfingerd.conf(5). If it is disabled the text files will
be sent as is, complete with any single or double dollar signs they may
contain.
TEXT COMMANDS
The following is a list of text commands and what they do. They are
checked case insensitively.
$CENTER will display the entire contents of the line. This command
must start at the beginning of the line. This is a very common command.
$DATE displays the current system date in the format of MM/DD/YY.
$TIME displays the current system time in the format HH:MM A/PM (timezone).
$IDENT displays the identity of the current person fingering your system.
$COMPILE_DATETIME displays the date and time of which the current issue
of cfingerd was compiled on your system.
$VERSION displays the current version of cfingerd.
$EXEC executes the rest of the line as a system command and send the
output to the fingering user. Pipes, parameters etc. are available.
The $EXEC command must be on a line by itself in order to function
properly. The command is executed as nobody.nogroup if used in a system file. If used in a user file (e.g. .plan) the command is executed
as that particular user. cfingerd will fork() before executing the new
command and will drop all priviledges so this is safe.
This feature is only available if ALLOW_EXECUTION is enabled in cfingerd.conf. The program may prodeuce a maximum of 10MB of output.
CONTACTING
If you like the software, and you want to learn more about the software, or want to see a feature added to it that isn't already here,
then please write to cfingerd@infodrom.north.de. The project's webpage
is at http://www.infodrom.north.de/cfingerd/ .
SEE ALSO
- cfingerd(8), cfingerd.conf(5), finger(1), userlist(1), any of the
included docs with the standard cfingerd distribution.