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

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.


[errinj_noop]
path_regexp = .*
op_regexp = .*
probability = 70

[errinj_errno]
path_regexp = *.xlog
probability = 4

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