Parameter Types

Configuration parameters can belong to the following types:

•address—network connection address specified as <IP address>:<port>;

•boolean—parameter having only two possible values: Yes or No;

•integer—a non-negative integer;

•fractional number — a non-negative number with a fractional part;

•time interval—a time interval, consisting of a non-negative integer and a suffix (letter), which stands for a time unit. The following suffixes can be used:

▫w—weeks (1w = 7d);

▫d—days (1d = 24h);

▫h—hours (1h = 60m);

▫m—minutes (1m = 60s);

▫s or no suffix—seconds.

If the time interval is specified in seconds, you can specify milliseconds after a point (but no more than three digits after the separator, for example, 0.5s—500 milliseconds). It is possible to specify several time intervals in different time units. In this case, the resulting interval is counted as a sum of intervals (in fact, a time interval is always converted to milliseconds before the value is written to configuration).

In general terms, any time an interval can be represented as an expression of this form: N1wN2dN3hN4mN5[.N6]s, where N1, …, N6 is a number of corresponding time unites included in this interval. For example, a year (365 days) can be represented as follows (all records are equal): 365d, 52w1d, 52w24h, 51w7d24h, 51w7d23h60m, 8760h, 525600m, 31536000s.

The examples below show you how intervals of 30 minutes, 2 seconds, 500 milliseconds can be specified:

1)in the configuration file:

2)using the drweb-ctl cfset command:

3)via a command-line parameter (for example, for Command-Line Arguments):

•size—parameter value can be the size of an object (file, buffer, cache, and so on), consisting of a non-negative integer and a suffix, which stands for a unit. The following suffixes can be used:

▫mb—megabytes (1mb = 1024kb);

▫kb—kilobytes (1kb = 1024b);

▫b—bytes.

If the suffix is omitted, the size is considered as in bytes. It is possible to specify several sizes in different units. In this case, the resulting size is counted as their sum (in fact, a size value is always converted to bytes);

•path to a directory (file)—parameter value can be a string, which is a path to a directory (file).

•logging level—the level at which the Dr.Web for UNIX Mail Servers component events are logged. The following values are possible:

▫DEBUG—the most detailed logging level. All messages and debug information are registered;

▫INFO—all messages are registered;

▫NOTICE—all error messages, warnings, and notifications are registered;

▫WARNING—all error messages and warnings are registered;

▫ERROR—only error messages are registered;

•log type—parameter value defines how the Dr.Web for UNIX Mail Servers component performs logging (its logging method). The following values are possible:

▫Stderr[:ShowTimestamp]—messages are displayed in the stderr—standard error stream. This value can be used only in the settings of configuration daemon. At that, if it works in background mode (“daemonized”), i.e. it is launched with the parameter -d specified, this value cannot be used because components operating in the background mode cannot access I/O streams of the terminal). The additional parameter ShowTimestamp instructs to add a time stamp to every message;

▫Auto—messages for logging are sent to the configuration daemon Dr.Web ConfigD, which saves them to one location according to its configuration (the parameter Log in the [Root] section). This value is specified for all components except for the configuration daemon and is used as a default value;

▫Syslog[:<facility>]—messages are transmitted to the system logging service syslog;

▫additional option <facility> is used to specify a level at which syslog registers messages. The following values are possible:

▪DAEMON—messages of daemons,

▪USER—messages of user processes,

▪MAIL—messages of mail programs,

▪LOCAL0—messages of local processes 0,

…

▪LOCAL7—messages of local processes 7;

▫<path>—Messages are to be saved directly to the specified log.

Example of how to specify the parameter value:

1)in the configuration file:

2)using the drweb-ctl cfset command:

3)via a command-line parameter (for example, for the Command-Line Arguments):

•action—action performed by the Dr.Web for UNIX Mail Servers component upon detection of certain threats or upon another event. The following values are possible:

▫Report—instructs only to notify on threat detection without performing any other action;

▫Cure—instructs to attempt to cure the threat (that is, remove only malicious content);

▫Quarantine—instructs to move the infected file to quarantine;

▫Delete—instructs to delete the infected file.

Other parameter types and their possible values are specified in the description of these parameters.