UNRELIABLEFS.CONF(5)

NAME
unreliablefs.conf - format of the configuration file used by unreliablefs(1)

DESCRIPTION
The configuration file format is quite simple. Sections are delimited by square brackets:

[Section]

And options within brackets sections are simple key value pairs:

Option = Value

OPTIONS
Per-fault-injection customizable variables are specified within sections with section names matching the fault-injection name.

Supported fault injections are:

errinj_noop
    File operation replaced with no-op.

errinj_kill_caller
    Send SIGKILL signal to a process that invoked file operation.

errinj_errno
    Set random errno. errno(2) limited by supported errno's.

errinj_slowdown
    File operation slowdown for nanoseconds specified by duration parameter.

The options are:

op_regexp
    Sets the regular expression that matches file operation for what fault injection is applicable. Option uses format of regular expressions described in re_format(7). POSIX Extended Regular Expression syntax is supported and regular expressions do not differentiate case.

path_regexp
    Sets the regular expression that matches paths where fault injection is applicable. Option uses format of regular expressions described in re_format(7). POSIX Extended Regular Expression syntax is supported and regular expressions do not differentiate case.

probability
    Sets the probability in percents. Probability equal to 0 means that error injection will never happen. Probability equal to 100 means that error injection will happen on each file operation.

duration
    Sets the duration of file operation slowdown. Applicable to errinj_slowdown only.

EXAMPLES

    [errinj_noop]
    path_regexp = .*
    op_regexp = .*
    probability = 70
    [errinj_errno]
    path_regexp = *.xlog
    probability = 4

SEE ALSO
unreliablefs(1), errno(2), syslog(3), re_format(7)

AUTHORS
-nosplit The unreliablefs(1) utility was written by Sergey Bronnikov.