mirror of
https://github.com/inspec/inspec
synced 2024-09-20 14:31:58 +00:00
67 lines
1.6 KiB
Text
67 lines
1.6 KiB
Text
---
|
|
title: About the bridge Resource
|
|
platform: linux
|
|
---
|
|
|
|
# bridge
|
|
|
|
Use the `bridge` InSpec audit resource to test basic network bridge properties, such as name, if an interface is defined, and the associations for any defined interface.
|
|
|
|
<br>
|
|
|
|
## Availability
|
|
|
|
### Installation
|
|
|
|
This resource is distributed along with InSpec itself. You can use it automatically.
|
|
|
|
### Version
|
|
|
|
This resource first became available in v1.0.0 of InSpec.
|
|
|
|
## Syntax
|
|
|
|
A `bridge` resource block declares the bridge to be tested and what interface it should be associated with:
|
|
|
|
describe bridge('br0') do
|
|
it { should exist }
|
|
it { should have_interface 'eth0' }
|
|
end
|
|
|
|
<br>
|
|
|
|
## Properties
|
|
|
|
* On Linux platforms, any value in the `/sys/class/net/{interface}/bridge` directory may be tested
|
|
* On the Windows platform, the `Get-NetAdapter` cmdlet is associated with the `Get-NetAdapterBinding` cmdlet and returns the `ComponentID ms_bridge` value as a JSON object
|
|
|
|
<br>
|
|
|
|
## Property Examples
|
|
|
|
### interfaces
|
|
|
|
The `interfaces` property tests if the named interface is present:
|
|
|
|
its('interfaces') { should eq 'foo' }
|
|
its('interfaces') { should eq 'bar' }
|
|
its('interfaces') { should include('foo') }
|
|
|
|
<br>
|
|
|
|
## Matchers
|
|
|
|
For a full list of available matchers, please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
|
|
|
|
### exist
|
|
|
|
The `exist` matcher tests if the network bridge is available:
|
|
|
|
it { should exist }
|
|
|
|
### have_interface
|
|
|
|
The `have_interface` matcher tests if the named interface is defined for the network bridge:
|
|
|
|
it { should have_interface 'eth0' }
|
|
|