inspec 2.0.16 → 2.0.17

data/docs/resources/mysql_session.md.erb

@@ -1,74 +1,74 @@
----
-title: About the mysql_session Resource
-platform: os
----
-
-# mysql_session
-
-Use the `mysql_session` InSpec audit resource to test SQL commands run against a MySQL database.
-
-<br>
-
-## Syntax
-
-A `mysql_session` resource block declares the username and password to use for the session, and then the command to be run:
-
-    describe mysql_session('username', 'password').query('QUERY') do
-      its('stdout') { should match(/expected-result/) }
-    end
-
-where
-
-* `mysql_session` declares a username and password, connecting locally, with permission to run the query
-* `query('QUERY')` contains the query to be run
-* `its('stdout') { should eq(/expected-result/) }` compares the results of the query against the expected result in the test
-
-<br>
-
-## Examples
-
-The following examples show how to use this InSpec audit resource.
-
-### Test for matching databases
-
-    sql = mysql_session('my_user','password')
-
-    describe sql.query('show databases like \'test\';') do
-      its('stdout') { should_not match(/test/) }
-    end
-
-### Alternate Connection: Different Host
-
-    sql = mysql_session('my_user','password','db.example.com')
-
-### Alternate Connection: Different Port
-
-    sql = mysql_session('my_user','password','localhost',3307)
-
-### Alternate Connection: Using a socket
-
-    sql = mysql_session('my_user','password', nil, nil, '/var/lib/mysql-default/mysqld.sock')
-
-### Test for a successful query
-
-    describe mysql_session('my_user','password').query('show tables in existing_database;') do
-      its('exit_status') { should eq(0) }
-    end
-
-### Test for a failing query
-
-    describe mysql_session('my_user','password').query('show tables in non_existent_database;') do
-      its('exit_status') { should_not eq(0) }
-    end
-
-### Test for specific error message
-
-    describe mysql_session('my_user','password').query('show tables in non_existent_database;') do
-      its('stderr') { should match(/Unknown database/) }
-    end
-
-<br>
-
-## Matchers
-
-This InSpec audit resource builds a [command](https://www.inspec.io/docs/reference/resources/command) object and returns the the result object. For a full list of available matchers, please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+---
+title: About the mysql_session Resource
+platform: os
+---
+
+# mysql_session
+
+Use the `mysql_session` InSpec audit resource to test SQL commands run against a MySQL database.
+
+<br>
+
+## Syntax
+
+A `mysql_session` resource block declares the username and password to use for the session, and then the command to be run:
+
+    describe mysql_session('username', 'password').query('QUERY') do
+      its('stdout') { should match(/expected-result/) }
+    end
+
+where
+
+* `mysql_session` declares a username and password, connecting locally, with permission to run the query
+* `query('QUERY')` contains the query to be run
+* `its('stdout') { should eq(/expected-result/) }` compares the results of the query against the expected result in the test
+
+<br>
+
+## Examples
+
+The following examples show how to use this InSpec audit resource.
+
+### Test for matching databases
+
+    sql = mysql_session('my_user','password')
+
+    describe sql.query('show databases like \'test\';') do
+      its('stdout') { should_not match(/test/) }
+    end
+
+### Alternate Connection: Different Host
+
+    sql = mysql_session('my_user','password','db.example.com')
+
+### Alternate Connection: Different Port
+
+    sql = mysql_session('my_user','password','localhost',3307)
+
+### Alternate Connection: Using a socket
+
+    sql = mysql_session('my_user','password', nil, nil, '/var/lib/mysql-default/mysqld.sock')
+
+### Test for a successful query
+
+    describe mysql_session('my_user','password').query('show tables in existing_database;') do
+      its('exit_status') { should eq(0) }
+    end
+
+### Test for a failing query
+
+    describe mysql_session('my_user','password').query('show tables in non_existent_database;') do
+      its('exit_status') { should_not eq(0) }
+    end
+
+### Test for specific error message
+
+    describe mysql_session('my_user','password').query('show tables in non_existent_database;') do
+      its('stderr') { should match(/Unknown database/) }
+    end
+
+<br>
+
+## Matchers
+
+This InSpec audit resource builds a [command](https://www.inspec.io/docs/reference/resources/command) object and returns the the result object. For a full list of available matchers, please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).

data/docs/resources/nginx.md.erb

@@ -1,79 +1,79 @@
----
-title: The Nginx Resource
-platform: linux
----
-
-# nginx
-
-Use the `nginx` InSpec audit resource to test the fields and validity of nginx.
-
-Nginx resource extracts and exposes data reported by the command 'nginx -V'
-
-<br>
-
-## Syntax
-
-An `nginx` InSpec audit resource block extracts configuration settings that should be tested:
-
-    describe nginx do
-      its('attribute') { should eq 'value' }
-    end
-
-    describe nginx('path to nginx') do
-      its('attribute') { should eq 'value' }
-    end
-
-where
-
-* `'attribute'` is a configuration parsed from result of the command 'nginx -V'
-* `'value'` is the value that is expected of the attribute
-
-<br>
-
-## Properties
-
-* 'compiler_info',  'error_log_path',  'http_client_body_temp_path',  'http_fastcgi_temp_path',  'http_log_path',  'http_proxy_temp_path',  'http_scgi_temp_path',  'http_uwsgi_temp_path',  'lock_path',  'modules', 'modules_path',  'openssl_version',  'prefix',  'sbin_path',  'service',  'support_info',  'version'
-
-<br>
-
-## Property Examples
-
-### version(String)
-
-`version` returns a string of the version of the running nginx instance
-
-    describe nginx do
-      its('version') { should eq '1.12.0' }
-    end
-
-### modules(String)
-
-`modules` returns a array modules in the running nginx instance
-
-    describe nginx do
-      its('modules') { should include 'my_module' }
-    end
-
-### openssl_version(Hash)
-
-`openssl_version ` returns a hash with 'version' and 'date' as keys
-
-    describe nginx do
-      its('openssl_version.date') { should eq '11 Feb 2013' }
-    end
-
-### compiler_info(Hash)
-
-`compiler_info ` returns a hash with 'compiler' , version' and 'date' as keys
-
-    describe nginx do
-      its('compiler_info.compiler') { should eq 'gcc' }
-    end
-
-### support_info(String)
-
-`support_info ` returns a string containing supported protocols
-
-    describe nginx do
-      its('support_info') { should match /TLS/ }
-    end
+---
+title: The Nginx Resource
+platform: linux
+---
+
+# nginx
+
+Use the `nginx` InSpec audit resource to test the fields and validity of nginx.
+
+Nginx resource extracts and exposes data reported by the command 'nginx -V'
+
+<br>
+
+## Syntax
+
+An `nginx` InSpec audit resource block extracts configuration settings that should be tested:
+
+    describe nginx do
+      its('attribute') { should eq 'value' }
+    end
+
+    describe nginx('path to nginx') do
+      its('attribute') { should eq 'value' }
+    end
+
+where
+
+* `'attribute'` is a configuration parsed from result of the command 'nginx -V'
+* `'value'` is the value that is expected of the attribute
+
+<br>
+
+## Properties
+
+* 'compiler_info',  'error_log_path',  'http_client_body_temp_path',  'http_fastcgi_temp_path',  'http_log_path',  'http_proxy_temp_path',  'http_scgi_temp_path',  'http_uwsgi_temp_path',  'lock_path',  'modules', 'modules_path',  'openssl_version',  'prefix',  'sbin_path',  'service',  'support_info',  'version'
+
+<br>
+
+## Property Examples
+
+### version(String)
+
+`version` returns a string of the version of the running nginx instance
+
+    describe nginx do
+      its('version') { should eq '1.12.0' }
+    end
+
+### modules(String)
+
+`modules` returns a array modules in the running nginx instance
+
+    describe nginx do
+      its('modules') { should include 'my_module' }
+    end
+
+### openssl_version(Hash)
+
+`openssl_version ` returns a hash with 'version' and 'date' as keys
+
+    describe nginx do
+      its('openssl_version.date') { should eq '11 Feb 2013' }
+    end
+
+### compiler_info(Hash)
+
+`compiler_info ` returns a hash with 'compiler' , version' and 'date' as keys
+
+    describe nginx do
+      its('compiler_info.compiler') { should eq 'gcc' }
+    end
+
+### support_info(String)
+
+`support_info ` returns a string containing supported protocols
+
+    describe nginx do
+      its('support_info') { should match /TLS/ }
+    end

data/docs/resources/nginx_conf.md.erb

@@ -1,128 +1,128 @@
----
-title: About the nginx_conf Resource
-platform: linux
----
-
-# nginx_conf
-
-Use the `nginx_conf` InSpec resource to test configuration data for the NGINX server located at `/etc/nginx/nginx.conf` on Linux and Unix platforms.
-
-**Stability: Experimental**
-
-<br>
-
-## Syntax
-
-An `nginx_conf` resource block declares the client NGINX configuration data to be tested:
-
-    describe nginx_conf.params['pid'] do
-      it { should cmp 'logs/nginx.pid' }
-    end
-
-where
-
-* `nginx_conf` is the resource to reference your NGINX configuration
-* `params` accesses all its parameters
-* `params['pid']` selects the `pid` entry from the global NGINX configuration
-* `{ should cmp 'logs/nginx.pid' }` tests if the PID is set to `logs/nginx.pid` (via `cmp` matcher)
-
-<br>
-
-## Examples
-
-The following examples show how to use this InSpec audit resource.
-
-### Find a specific server
-
-    servers = nginx_conf.servers
-    domain2 = servers.find { |s| s.params['server_name'].flatten.include? 'domain2.com' }
-    describe 'No server serves domain2' do
-      subject { domain2 }
-      it { should be_nil }
-    end
-
-### Test a raw parameter
-
-    describe nginx_conf.params['worker_processes'].flatten do
-      it { should cmp 5 }
-    end
-
-<br>
-
-## Matchers
-
-For a full list of available matchers, please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
-
-### http
-
-Retrieves all `http` entries in the configuration file.
-
-    nginx_conf.http
-    => nginx_conf /etc/nginx/nginx.conf, http entries
-
-It provides further access to all individual entries, servers, and locations.
-
-    nginx_conf.http.entries
-    => [nginx_conf /etc/nginx/nginx.conf, http entry ...]
-
-    nginx_conf.http.servers
-    => [nginx_conf /etc/nginx/nginx.conf, server entry ...]
-
-    nginx_conf.http.locations
-    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
-
-You can access each of these from the array and inspect it further (see below).
-
-### servers
-
-Retrieve all `servers` entries in the configuration:
-
-    # all servers across all configs aggregated:
-    nginx_conf.servers
-    => [nginx_conf /etc/nginx/nginx.conf, server entry ...]
-
-    # servers that belong to a specific http entry:
-    nginx_conf.http.entries[0].servers
-    => [nginx_conf /etc/nginx/nginx.conf, server entry ...]
-
-Servers provide access to all their locations, parent http entry, and raw parameters:
-
-    server = nginx_conf.servers[0]
-
-    server.locations
-    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
-
-    server.parent
-    => nginx_conf /etc/nginx/nginx.conf, http entry
-
-    server.params
-    => {"listen"=>[["85"]],
-       "server_name"=>[["domain1.com", "www.domain1.com"]],
-       "root"=>[["html"]],
-       "location"=>[{"_"=>["~", "\\.php$"], "fastcgi_pass"=>[["127.0.0.1:1025"]]}]}
-
-### locations
-
-Retrieve all `location` entries in the configuration:
-
-    # all locations across all configs aggregated:
-    nginx_conf.locations
-    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
-
-    # locations of a http entry aggregated:
-    nginx_conf.http.entries[0].locations
-    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
-
-    # locations of a specific server:
-    nginx_conf.servers[0].locations
-    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
-
-Locations provide access to their parent server entry and raw parameters:
-
-    location = nginx_conf.locations[0]
-
-    location.parent
-    => nginx_conf /etc/nginx/nginx.conf, server entry
-
-    location.params
-    => {"_"=>["~", "\\.php$"], "fastcgi_pass"=>[["127.0.0.1:1025"]]}
+---
+title: About the nginx_conf Resource
+platform: linux
+---
+
+# nginx_conf
+
+Use the `nginx_conf` InSpec resource to test configuration data for the NGINX server located at `/etc/nginx/nginx.conf` on Linux and Unix platforms.
+
+**Stability: Experimental**
+
+<br>
+
+## Syntax
+
+An `nginx_conf` resource block declares the client NGINX configuration data to be tested:
+
+    describe nginx_conf.params['pid'] do
+      it { should cmp 'logs/nginx.pid' }
+    end
+
+where
+
+* `nginx_conf` is the resource to reference your NGINX configuration
+* `params` accesses all its parameters
+* `params['pid']` selects the `pid` entry from the global NGINX configuration
+* `{ should cmp 'logs/nginx.pid' }` tests if the PID is set to `logs/nginx.pid` (via `cmp` matcher)
+
+<br>
+
+## Examples
+
+The following examples show how to use this InSpec audit resource.
+
+### Find a specific server
+
+    servers = nginx_conf.servers
+    domain2 = servers.find { |s| s.params['server_name'].flatten.include? 'domain2.com' }
+    describe 'No server serves domain2' do
+      subject { domain2 }
+      it { should be_nil }
+    end
+
+### Test a raw parameter
+
+    describe nginx_conf.params['worker_processes'].flatten do
+      it { should cmp 5 }
+    end
+
+<br>
+
+## Matchers
+
+For a full list of available matchers, please visit our [matchers page](https://www.inspec.io/docs/reference/matchers/).
+
+### http
+
+Retrieves all `http` entries in the configuration file.
+
+    nginx_conf.http
+    => nginx_conf /etc/nginx/nginx.conf, http entries
+
+It provides further access to all individual entries, servers, and locations.
+
+    nginx_conf.http.entries
+    => [nginx_conf /etc/nginx/nginx.conf, http entry ...]
+
+    nginx_conf.http.servers
+    => [nginx_conf /etc/nginx/nginx.conf, server entry ...]
+
+    nginx_conf.http.locations
+    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
+
+You can access each of these from the array and inspect it further (see below).
+
+### servers
+
+Retrieve all `servers` entries in the configuration:
+
+    # all servers across all configs aggregated:
+    nginx_conf.servers
+    => [nginx_conf /etc/nginx/nginx.conf, server entry ...]
+
+    # servers that belong to a specific http entry:
+    nginx_conf.http.entries[0].servers
+    => [nginx_conf /etc/nginx/nginx.conf, server entry ...]
+
+Servers provide access to all their locations, parent http entry, and raw parameters:
+
+    server = nginx_conf.servers[0]
+
+    server.locations
+    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
+
+    server.parent
+    => nginx_conf /etc/nginx/nginx.conf, http entry
+
+    server.params
+    => {"listen"=>[["85"]],
+       "server_name"=>[["domain1.com", "www.domain1.com"]],
+       "root"=>[["html"]],
+       "location"=>[{"_"=>["~", "\\.php$"], "fastcgi_pass"=>[["127.0.0.1:1025"]]}]}
+
+### locations
+
+Retrieve all `location` entries in the configuration:
+
+    # all locations across all configs aggregated:
+    nginx_conf.locations
+    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
+
+    # locations of a http entry aggregated:
+    nginx_conf.http.entries[0].locations
+    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
+
+    # locations of a specific server:
+    nginx_conf.servers[0].locations
+    => [nginx_conf /etc/nginx/nginx.conf, location entry ...]
+
+Locations provide access to their parent server entry and raw parameters:
+
+    location = nginx_conf.locations[0]
+
+    location.parent
+    => nginx_conf /etc/nginx/nginx.conf, server entry
+
+    location.params
+    => {"_"=>["~", "\\.php$"], "fastcgi_pass"=>[["127.0.0.1:1025"]]}