bsd_service resource

Use the bsd_service Chef InSpec audit resource to test a service using a Berkeley OS-style init on the FreeBSD platform.

Availability

This resource is distributed with Chef InSpec and is automatically available for use.

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

A bsd_service resource block declares the name of a service and then one (or more) matchers to test the state of the service:

describe bsd_service('service_name') do
  it { should be_installed }
  it { should be_enabled }
  it { should be_running }
end

where

('service_name') must specify a service name
be_installed, be_enabled, and be_running are the different matchers for this resource.

The path to the service manager’s control may be specified for situations where the path isn’t available in the current PATH. For example:

describe bsd_service('service_name', '/path/to/control') do
  it { should be_enabled }
  it { should be_installed }
  it { should be_running }
end

All properties available to the service resource may be used.

For a full list of available matchers, see our Universal Matchers page.

This resource has the following special matchers.

The be_enabled matcher tests if the named service is enabled:

it { should be_enabled }

The be_installed matcher tests if the named service is installed:

it { should be_installed }

The be_running matcher tests if the named service is running:

it { should be_running }