zinject(8)

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 [-C dvas] [-e device_error] [-f frequency] [-l level] [-r range] [-amq] path
    Force an error into the contents of a file.

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

zinject -t mos_type [-C dvas] [-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.

-C dvas
    Inject the given error only into specific DVAs. The mask should be specified as a list of 0-indexed DVAs separated by commas (ex. '0,2'). This option is not applicable to logical data errors such as decompress and decrypt.

-d vdev
    A vdev specified by path or GUID.

-e device_error
    Specify checksum for an ECKSUM error, decrypt for a data decryption 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)