inspec 1.51.0 → 1.51.6

data/docs/resources/filesystem.md.erb

@@ -4,7 +4,8 @@ title: About the filesystem Resource
 
 # filesystem
 
-Use the `filesystem` InSpec resource to audit filesystem disk space usage
+Use the `filesystem` InSpec resource to audit filesystem disk space usage.
+
 <br>
 
 ## Syntax
@@ -17,12 +18,12 @@ A `filesystem` resource block declares tests for disk space in a partion:
 
 where
 
-* `filesystem('/')` states that it will be looking at the root (/) partition
-* `size` is measured in megabytes (MB)
+* `filesystem('/')` states that the resource will look at the root (/) partition.
+* `size` is measured in megabytes (MB).
 
 <br>
 
-## Examples
+## Resource Property Examples
 
 The following examples show how to use this InSpec audit resource.
 

data/docs/resources/firewalld.md.erb

@@ -65,7 +65,7 @@ The `default_zone` property displays the default active zone to be used.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### `be_installed`
 

data/docs/resources/gem.md.erb

@@ -24,7 +24,7 @@ where
 
 <br>
 
-## Examples
+## Resource Property Examples
 
 The following examples show how to use this InSpec audit resource.
 
@@ -63,7 +63,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_installed
 

data/docs/resources/group.md.erb

@@ -39,7 +39,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_local
 

data/docs/resources/host.md.erb

@@ -56,7 +56,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_reachable
 

data/docs/resources/iis_app.md.erb

@@ -67,7 +67,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### exist
 

data/docs/resources/iis_site.md.erb

@@ -65,7 +65,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_running
 

data/docs/resources/interface.md.erb

@@ -25,7 +25,7 @@ An `interface` resource block declares network interface properties to be tested
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_up
 

data/docs/resources/iptables.md.erb

@@ -54,7 +54,7 @@ Note that the rule specification must exactly match what's in the output of `ipt
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### have_rule
 

data/docs/resources/json.md.erb

@@ -52,7 +52,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### name
 

data/docs/resources/kernel_module.md.erb

@@ -91,7 +91,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_loaded
 

data/docs/resources/kernel_parameter.md.erb

@@ -49,7 +49,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### value
 

data/docs/resources/launchd_service.md.erb

@@ -35,7 +35,7 @@ The path to the service manager's control may be specified for situations where
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_enabled
 

data/docs/resources/limits_conf.md.erb

@@ -53,7 +53,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### domain
 

data/docs/resources/login_def.md.erb

@@ -53,7 +53,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### name
 

data/docs/resources/mount.md.erb

@@ -41,7 +41,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_mounted
 

data/docs/resources/mysql_conf.md.erb

@@ -87,7 +87,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### setting
 

data/docs/resources/nginx_conf.md.erb

@@ -50,7 +50,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### http
 

data/docs/resources/npm.md.erb

@@ -44,7 +44,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_installed
 

data/docs/resources/oneget.md.erb

@@ -37,7 +37,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_installed
 

data/docs/resources/os.md.erb

@@ -52,7 +52,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ## os.family? Helpers
 

data/docs/resources/os_env.md.erb

@@ -13,7 +13,7 @@ Use the `os_env` InSpec audit resource to test the environment variables for the
 A `os_env` resource block declares an environment variable, and then declares its value:
 
     describe os_env('VARIABLE') do
-      its('matcher') { should eq 1 }
+      its('property') { should eq 1 }
     end
 
 where
@@ -60,7 +60,7 @@ Habitat uses the `os_env` resource to test environment variables. The environmen
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### content
 

data/docs/resources/package.md.erb

@@ -91,7 +91,7 @@ Memcached is an in-memory key-value store that helps improve the performance of
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_held
 

data/docs/resources/packages.md.erb

@@ -0,0 +1,66 @@
+---
+title: About the packages Resource
+---
+
+# packages
+
+Use the `packages` InSpec audit resource to test the properties of multiple packages on the system.
+
+<br>
+
+## Syntax
+
+A `packages` resource block declares a regular expression search to select packages
+
+    describe packages(/name/) do
+      its('statuses') { should cmp 'installed' }
+    end
+
+<br>
+
+## Examples
+
+The following examples show how to use this InSpec audit resource.
+
+### Verify that no `xserver` packages are installed
+
+    describe package(/xserver/) do
+      its('statuses') { should_not cmp 'installed' }
+    end
+
+### Verify all `openssl` packages match a certain version
+
+    describe package(/openssl/) do
+      its('versions') { should cmp '1.0.1e-42.el7' }
+    end
+
+### Verify that both the `i686` and `x86_64` versions of `libgcc` are installed
+
+    describe package(/libgcc/) do
+      its('architectures') { should include 'x86_64' }
+      its('architectures') { should include 'i686' }
+    end
+
+<br>
+
+## Matchers
+
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
+
+### statuses
+
+The `statuses` matcher tests if packages are installed on the system
+
+    its('statuses') { should cmp 'installed' }
+
+### versions
+
+The `versions` matcher tests the versions of the packages installed on the system
+
+    its('versions') { should cmp '3.4.0.2-4.el7' }
+
+### architectures
+
+The `architectures` matcher tests the architecture of packages installed on the system
+
+    its('architectures') { should include 'i686' }

data/docs/resources/parse_config.md.erb

@@ -41,7 +41,7 @@ where each test
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### assignment_regex
 

data/docs/resources/parse_config_file.md.erb

@@ -76,7 +76,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### assignment_regex
 

data/docs/resources/passwd.md.erb

@@ -68,7 +68,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### gids
 

data/docs/resources/pip.md.erb

@@ -51,7 +51,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_installed
 

data/docs/resources/port.md.erb

@@ -99,7 +99,7 @@ or:
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### address
 

data/docs/resources/postgres_conf.md.erb

@@ -67,7 +67,7 @@ where `unix_socket_group` is set to the PostgreSQL default setting (the group to
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### setting
 

data/docs/resources/postgres_session.md.erb

@@ -59,7 +59,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### output
 

data/docs/resources/powershell.md.erb

@@ -17,7 +17,7 @@ A `powershell` resource block declares a Powershell script to be tested, and the
     EOH
 
     describe powershell(script) do
-      its('matcher') { should eq 'output' }
+      its('property') { should eq 'output' }
     end
 
 where
@@ -80,7 +80,7 @@ No newline:
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### exit_status
 

data/docs/resources/processes.md.erb

@@ -98,7 +98,7 @@ Below is a mapping table to help you understand what property the unix field map
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### property_name
 

data/docs/resources/registry_key.md.erb

@@ -90,7 +90,7 @@ where `'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\Schedule'` is the f
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### children
 

data/docs/resources/runit_service.md.erb

@@ -35,7 +35,7 @@ The path to the service manager's control may be specified for situations where
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### be_enabled
 

data/docs/resources/security_policy.md.erb

@@ -37,7 +37,7 @@ The following examples show how to use this InSpec audit resource.
 
 ## Matchers
 
-This InSpec audit resource has the following matchers. For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+For a full list of available matchers please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/). 
 
 ### policy_name