interface

Use the interface InSpec audit resource to test basic network adapter properties, such as name, status, and link speed (in MB/sec).

  • On Linux platforms, /sys/class/net/#{iface} is used as source
  • On the Windows platform, the Get-NetAdapter cmdlet is used as source


Syntax

An interface resource block declares network interface properties to be tested:

describe interface('eth0') do
  it { should be_up }
  its('speed') { should eq 1000 }
  its('name') { should eq eth0 }
end


Properties

name, speed


Resource Property Examples

name

The name matcher tests if the named network interface exists:

its('name') { should eq eth0 }

speed

The speed matcher tests the speed of the network interface, in MB/sec:

its('speed') { should eq 1000 }


Matchers

For a full list of available matchers, please visit our matchers page.

be_up

The be_up matcher tests if the network interface is available:

it { should be_up }