1. Community: ZFS
   1. What is ZFS?
   2. Getting Started
   3. ZFS FAQ
   4. Discussions
   5. Source Tour
   6. Blogs
   7. Demos
      1. ZFS Basics
      2. ZFS Self Healing
   8. Porting ZFS
   9. Documentation
   10. Links
   11. ZTEST
   12. ZFS Boot
       1. Manual Setup
          1. create directories
          2. mountroot transition
       2. netinstall setup
       3. ZFS Boot Project FAQ
   13. Data Structures
   14. ZFS Test Suite
   15. Leaders
   16. Translations
       1. Spanish
          1. Home
          2. Getting Started
          3. ZFS FAQ
       2. French
          1. Home
          2. Getting Started
          3. ZFS FAQ
       3. Japanese
          1. Home
          2. Getting Started
          3. ZFS FAQ
       4. Brazilian Portuguese
          1. Home
          2. Getting Started
          3. ZFS FAQ
       5. Russian
          1. Home
          2. Getting Started
          3. ZFS FAQ
       6. Simplified Chinese
          1. Home
          2. Getting Started
          3. ZFS FAQ

ZFS Test Suite Info

Test Cases

The ZFS Test Suite can currently be downloaded here. You can browse the source here. You should also check out the test suite README.

The ZFS Test Suite consists of a number of test directories. The following list describes the directory name and its purpose.

• acl - Tests trivial and non-trivial ACLs
• atime - Various tests of the access time property
• bootfs - Ensures the bootfs zpool property is working correctly
• clean_mirror - corrupts one half of a mirror while writing new data to the mirror
• cli_root - Performs basic testing on each the of the zfs and zpool subcommands while runing as root.
• cli_user - Performs basic testing on the zfs and zpool subcommands while runing as a non-root user.
• compression - Verifies that turning on compression actually comrpesses files.
• ctime - Tests that creation time is updated
• delegate - Will verify the delegated administration model
• devices - Ensures devices can be created in a ZFS file system
• exec - Checks that execution of binaries can be enabled/disabled on a ZFS file system
• grow_pool - Verifies that non-replicated pools can grow
• grow_replicas - Verifies that replicated pools can grow
• history - Performs basic administration operations and ensures that the history log is updated correctly
• hotspare - Tests the hotspare functionality
• inheritance - Sets file system properities and verifies that each property is inherited in various scenarios
• interop - Creates a pool using an SVM volume to ensure interoperability
• inuse - Checks that file system utilities ignore disks that are in use by ZFS
• iscsi - Basic iSCSI testing (see iSCSI test execution mode for more detailed testing)
• large_files - Creates large files in a test pool
• largest_pool - Simulates very large pool sizes
• link_count - Checks behavior of file link counts
• mdb - Ensures that ZFS related mdb(1m) macros are working
• migration - Migrates data from UFS file systems to ZFS using different command line utlities
• mmap - Tests for race conditions using mmap(2)
• mount - Shows how to autogenerate test case using mount as an example
• mv_files - Moves files from on ZFS file system to another
• nestedfs - Basic nested file system testing
• no_space - Checks behavior of the ZFS file system when there is no space remaining
• online_offline - Marks disks as offline/online during I/O
• pool_names - Steps through all valid and a sample of invalid pool names
• privilege - Checks that administration roles work with the ZFS utilities
• quota - Verifies file systems with quotas
• redundancy - Tests the pool redundancy features by simulating failed disks
• remote - Runs a small selection of tests on a remote client
• rename_dirs - Checks how ZFS handles renamed directories
• replacement - Verifies the disk replacement feature
• reservation - Ensures that reservations are upheld in a number of different scenarios
• scrub_mirror - Causes disk failures on a replicated pool and verifies that the pool can recover
• snapshot - Various snapshot, rollback and clone tests
• sparse - Checks how ZFS handles sparse files
• threadsappend - Ensure multiple threads performing write appends to the same ZFS file succeed.
• truncate Tests file truncation within ZFS
• utils_test Verifies that various UFS utilities fail on ZFS file systems
• write_dirs Verifies that filling a file system does not prevent files from being erased due to copy-on-write semantics
• xattr - Checks ZFS extended attributes
• zones - Verifies zone related ZFS features like zone cloning
• zvol - Tests that zvols can be used for swap and other zvol scenarios

Baseline Results

The following table shows the known failures of the ZFS Test Suite running in a global zone. Failures that are not listed in this table should be analyzed to determine whether or not a bug exists in ZFS or in the test suite itself.

Failing Test Case	Associated Defect ID
tests/functional/cli_root/zfs_destroy/zfs_destroy_001_pos	6342462
tests/functional/cli_root/zfs_destroy/zfs_destroy_005_neg	6342462
tests/functional/cli_root/zfs_set/mountpoint_003_pos	6567408
tests/functional/cli_root/zfs_share/zfs_share_005_pos	6565575
tests/functional/hotspare/hotspare_detach_001_pos	6491604
tests/functional/inheritance/inherit_001_pos	6506000
tests/functional/inuse/inuse_003_pos	6355481
tests/functional/iscsi/iscsi_006_neg	6495382
tests/functional/mdb/mdb_001_pos	6515139

The following table shows the known failures of the ZFS Test Suite running in a non-global zone. Failures that are not listed in this table should be analyzed to determine whether or not a bug exists in ZFS or in the test suite itself. This table is much shorter because most zpool administration features are not applicable to non-global zones.

Failing Test Case	Associated Defect ID
tests/functional/cli_root/zfs_destroy/zfs_destroy_001_pos	6342462
tests/functional/cli_root/zfs_destroy/zfs_destroy_005_neg	6342462
tests/functional/cli_root/zfs_set/mountpoint_003_pos	6567408