zfs_dataset resource

[edit on GitHub]

Use the zfs_dataset Chef InSpec audit resource to test the ZFS datasets on FreeBSD systems.

Availability

Installation

This resource is distributed along with Chef InSpec itself. You can use it automatically.

Version

This resource first became available in v1.16.0 of InSpec.

Syntax

A zfs_dataset resource block declares the ZFS dataset properties that should be tested:

describe zfs_dataset('dataset') do
  it { should MATCHER 'value' }
end

where

• ('dataset') is the name of the ZFS dataset (eg: 'tank/tmp')
• MATCHER is a valid matcher for this resource
• 'value' is the value to be tested

Examples

The following examples show how to use this Chef InSpec audit resource.

Test a dataset of ‘tank/tmp’

describe zfs_dataset('tank/tmp') do
  it { should be_mounted }
  its('atime') { should eq  'on' }
  its('compression') { should eq  'lz4' }
  its('exec') { should eq  'off' }
  its('readonly') { should eq  'off' }
  its('setuid') { should eq  'off' }
end

Matchers

This Chef InSpec audit resource has the matchers listed below, in addition to dynamically exposing all ZFS dataset properties available (see: man zfs for the list of supported properties). For a full list of available matchers, please visit our matchers page.

be_mounted

The be_mounted matcher tests if the dataset is accessible from the file system:

it { should be_mounted }