Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
UNRELIABLEFS.CONF(5)	      File Formats Manual	  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 sec-
       tions 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 reg-
	       ular 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  in-
	       jection	is  applicable.	 Option	uses format of regular expres-
	       sions described in re_format(7).	 POSIX	Extended  Regular  Ex-
	       pression	 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	opera-
	       tion.

       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
       The unreliablefs(1) utility was written by Sergey Bronnikov.

FreeBSD	Ports 14.quarterly	April 15, 2021		  UNRELIABLEFS.CONF(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=unreliablefs.conf&sektion=5&manpath=FreeBSD+Ports+14.3.quarterly>

home | help