xenial (8) zinject.8.gz

NAME

       zinject - ZFS Fault Injector

DESCRIPTION

       zinject  creates artificial problems in a ZFS pool by simulating data corruption or device failures. This
       program is dangerous.

SYNOPSIS

       zinject
              List injection records.

       zinject -b objset:object:level:blkd [-f frequency] [-amu] pool
              Force an error into the pool at a bookmark.

       zinject -c <id | all>
              Cancel injection records.

       zinject -d vdev -A <degrade|fault> pool
              Force a vdev into the DEGRADED or FAULTED state.

       zinject -d vdev [-e device_error] [-L label_error] [-T failure] [-F] pool
              Force a vdev error.

       zinject -I [-s seconds | -g txgs] pool
              Simulate a hardware failure that fails to honor a cache flush.

       zinject -p function pool
              Panic inside the specified function.

       zinject -t data [-e device_error] [-f frequency] [-l level] [-r range] [-amq] path
              Force an error into the contents of a file.

       zinject -t dnode [-e device_error] [-f frequency] [-l level] [-amq] path
              Force an error into the metadnode for a file or directory.

       zinject -t mos_type [-e device_error] [-f frequency] [-l level] [-r range] [-amqu] pool
              Force an error into the MOS of a pool.

OPTIONS

       -a     Flush the ARC before injection.

       -b objset:object:level:start:end
              Force an error into the pool at this bookmark tuple. Each number is in hexidecimal, and  only  one
              block can be specified.

       -d vdev
              A vdev specified by path or GUID.

       -e device_error
              Specify checksum for an ECKSUM error, dtl for an ECHILD error, io for an EIO error where reopening
              the device will succeed, or nxio for an ENXIO error where reopening the device will fail.

       -f frequency
              Only inject errors a fraction of the time. Expressed as an integer percentage between 1 and 100.

       -F     Fail faster. Do fewer checks.

       -g txgs
              Run for this many transaction groups before reporting failure.

       -h     Print the usage message.

       -l level
              Inject an error at a particular block level. The default is 0.

       -L label_error
              Set the label error region to one of  nvlist,  pad1,  pad2, or  uber.

       -m     Automatically remount the underlying filesystem.

       -q     Quiet mode. Only print the handler number added.

       -r range
              Inject an error over a particular logical range of an object, which  will  be  translated  to  the
              appropriate blkid range according to the object's properties.

       -s seconds
              Run for this many seconds before reporting failure.

       -T failure
              Set the failure type to one of  all,  claim,  free,  read, or  write.

       -t mos_type
              Set  this  to  mos  for  any  data in the MOS, mosdir for an object directory, config for the pool
              configuration, bpobj for the block pointer list, spacemap for the  space  map,  metaslab  for  the
              metaslab, or errlog for the persistent error log.

       -u     Unload the pool after injection.

ENVIRONMENT VARIABLES

       ZINJECT_DEBUG
              Run zinject in debug mode.

AUTHORS

       This  man  page  was written by Darik Horn <dajhorn@vanadac.com> excerpting the zinject usage message and
       source code.

SEE ALSO

       zpool(8), zfs(8)