summaryrefslogtreecommitdiffstats
path: root/source/rainerscript/functions/rs-getenv.rst
blob: 0035a8b1ea876995224f750db387f2eb7d4cb66a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
********
getenv()
********

Purpose
=======

getenv(str)

Like the OS call, returns the value of the environment variable,
if it exists. Returns an empty string if it does not exist.


Examples
========

The following example can be used to build a dynamic filter based on
some environment variable:

.. code-block:: none

   if $msg contains getenv('TRIGGERVAR') then /path/to/errfile