home | help
UNRELIABLEFS.CONF(5)	       File Formats Manual	    UNRELIABLEFS.CONF(5)

NAME
     unreliablefs.conf	--  format  of	the  configuration  file used by unreli-
     ablefs(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 para-
	     meter.

     The options are:

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

     path_regexp
	     Sets  the	regular expression that matches paths where fault injec-
	     tion is applicable.  Option uses format of regular expressions  de-
	     scribed  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
     The unreliablefs(1) utility was written by Sergey Bronnikov.

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

home | help