ohai 13.10.0 → 13.12.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cd47e40a9d7e2877d2422f47a12fce95026eb3ed7670e40bb82d8b9a398007f
-  data.tar.gz: ae75e45d6f59c30f0abfc4e74f6af12a771edfd36f6d9acf41ea54ead46a8402
+  metadata.gz: a41edda21a06898377a46f64d60114fd881760976a7410142f2edc8da1db5720
+  data.tar.gz: c912b6aff14cb52b866353fd63ecc57e52fcf0cacf4a5a6854f26c8dc0f474ba
 SHA512:
-  metadata.gz: 926724f586f794cef84f2f95efe705e09a7a953dfb050502571039a4bedf871c3cb89a128e34453fe2e3d5887ec1f18904a418398ca58640728ef8d5668a0e24
-  data.tar.gz: 0f3a7b330e5c23c25e02fe383692aa7bc57280dc94aec1b641fae36318546dc7c72d58c2bb0b30a5ec5b0fd5a1cbfa0887f41601723179499103e192f0470631
+  metadata.gz: a9afdaa6fbf0727f4a7da85544090b4c73e14286527c9f0bb4d0d1f2ac9c93bc2669833c3f3138604802a5ddace874ac5b6002e33abf72a719a48d71af9e62ce
+  data.tar.gz: 9c5889f73fed85d39570fc4720c0ee2ae61814ef41624e04806fd3d3ba272b7bb05d50c0828e279452ea8a9b906427fe7b0e6f914a57ef880c2ca3d969e63fd9

data/Gemfile

@@ -17,6 +17,19 @@ group :ci do
   gem "rspec_junit_formatter"
 end
 
+group :docs do
+  gem "yard"
+  gem "redcarpet"
+  gem "github-markup"
+end
+
+group :debug do
+  gem "pry"
+  gem "pry-byebug"
+  gem "pry-stack_explorer"
+  gem "rb-readline"
+end
+
 instance_eval(ENV["GEMFILE_MOD"]) if ENV["GEMFILE_MOD"]
 
 # If you want to load debugging tools into the bundle exec sandbox,

data/README.md

@@ -11,7 +11,7 @@ Ohai will print out a JSON data blob for all the known data about your system. W
 Chef distributes ohai as a RubyGem. This README is for developers who want to modify the Ohai source code. For users who want to write plugins for Ohai, see the docs:
 
 - General documentation: <https://docs.chef.io/ohai.html>
-- Custom plugin documentation: <https://docs.chef.io/ohai_custom.html>
+- Writing Ohai Plugins documentation: <https://docs.chef.io/ohai_custom.html>
 
 ## Development Environment:
 
@@ -37,11 +37,16 @@ Ohai has some Rake tasks for doing various things.
 
 ```
 rake -T
-rake build          # Build the gem file ohai-$VERSION.gem
-rake install        # install the gem locally
-rake install:local  # install the gem locally without network access
-rake release        # Create tag $VERSION, build gem, and push to Rubygems
-rake spec           # Run RSpec tests
+rake build               # Build ohai-$VERSION.gem into the pkg directory
+rake clean               # Remove any temporary products
+rake clobber             # Remove any generated files
+rake docs                # Generate YARD Documentation
+rake install             # Build and install ohai-$VERSION.gem into system gems
+rake install:local       # Build and install ohai-$VERSION.gem into system gems without network access
+rake release[remote]     # Create tag $VERSION and build and push ohai-$VERSION.gem to rubygems.org
+rake spec                # Run RSpec code examples
+rake style               # Run Chefstyle tests
+rake style:auto_correct  # Auto-correct RuboCop offenses
 
 ($VERSION is the current version, from the GemSpec in Rakefile)
 ```
@@ -65,7 +70,7 @@ For information on contributing to this project see <https://github.com/chef/che
 Ohai - system information application
 
 - Author:: Adam Jacob ([adam@chef.io](mailto:adam@chef.io))
-- Copyright:: Copyright (c) 2008-2016 Chef Software, Inc.
+- Copyright:: Copyright (c) 2008-2018 Chef Software, Inc.
 - License:: Apache License, Version 2.0
 
 ```text

data/Rakefile

@@ -1,6 +1,4 @@
 require "bundler/gem_tasks"
-require "date"
-require "ohai/version"
 
 begin
   require "rspec/core/rake_task"
@@ -11,25 +9,34 @@ begin
 rescue LoadError
   desc "rspec is not installed, this task is disabled"
   task :spec do
-    abort "rspec is not installed. `(sudo) gem install rspec` to run unit tests"
+    abort "rspec is not installed. bundle install first to make sure all dependencies are installed."
   end
 end
 
-task :default => :spec
-
-require "chefstyle"
-require "rubocop/rake_task"
-RuboCop::RakeTask.new(:style) do |task|
-  task.options += ["--display-cop-names", "--no-color"]
+begin
+  require "chefstyle"
+  require "rubocop/rake_task"
+  desc "Run Chefstyle tests"
+  RuboCop::RakeTask.new(:style) do |task|
+    task.options += ["--display-cop-names", "--no-color"]
+  end
+rescue LoadError
+  puts "chefstyle gem is not installed. bundle install first to make sure all dependencies are installed."
 end
 
 begin
-  require "github_changelog_generator/task"
-
-  GitHubChangelogGenerator::RakeTask.new :changelog do |config|
-    config.future_release = Ohai::VERSION
-    config.max_issues = 0
-    config.add_issues_wo_labels = false
-  end
+  require "yard"
+  YARD::Rake::YardocTask.new(:docs)
 rescue LoadError
+  puts "yard is not available. bundle install first to make sure all dependencies are installed."
+end
+
+task :console do
+  require "irb"
+  require "irb/completion"
+  require "ohai"
+  ARGV.clear
+  IRB.start
 end
+
+task default: [:style, :spec]

data/lib/ohai/application.rb

@@ -66,14 +66,6 @@ class Ohai::Application
     :proc         => lambda { |v| puts "Ohai: #{::Ohai::VERSION}" },
     :exit         => 0
 
-  def initialize
-    super
-
-    # Always switch to a readable directory. Keeps subsequent Dir.chdir() {}
-    # from failing due to permissions when launched as a less privileged user.
-    Dir.chdir("/")
-  end
-
   def run
     elapsed = Benchmark.measure do
       configure_ohai
@@ -92,6 +84,10 @@ class Ohai::Application
   end
 
   def run_application
+    # Always switch to a readable directory. Keeps subsequent Dir.chdir() {}
+    # from failing due to permissions when launched as a less privileged user.
+    Dir.chdir("/")
+
     config[:invoked_from_cli] = true
     ohai = Ohai::System.new(config)
     ohai.all_plugins(@attributes)

data/lib/ohai/plugins/darwin/cpu.rb

@@ -1,7 +1,7 @@
 #
 # Author:: Nathan L Smith (<nlloyds@gmail.com>)
 # Author:: Tim Smith (<tsmith@chef.io>)
-# Copyright:: Copyright (c) 2013-2016 Chef Software, Inc.
+# Copyright:: Copyright (c) 2013-2018 Chef Software, Inc.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +22,7 @@ Ohai.plugin(:CPU) do
 
   collect_data(:darwin) do
     cpu Mash.new
-    shell_out("sysctl -a").stdout.lines.each do |line|
+    shell_out("sysctl hw machdep").stdout.lines.each do |line|
       case line
       when /^hw.packages: (.*)$/
         cpu[:real] = Regexp.last_match[1].to_i

data/lib/ohai/plugins/darwin/hardware.rb

@@ -34,13 +34,7 @@ Ohai.plugin(:Hardware) do
       next
     end
 
-    begin
-      require "plist"
-    rescue LoadError => e
-      # In case the plist gem isn't present, skip this plugin.
-      Ohai::Log.debug("Plugin Hardware: Can't load gem: #{e}. Cannot continue.")
-      next
-    end
+    require "plist"
 
     hw_hash = system_profiler("SPHardwareDataType")
     hw_hash[0]["_items"][0].delete("_name")

data/lib/ohai/plugins/darwin/system_profiler.rb

@@ -20,13 +20,12 @@ Ohai.plugin(:SystemProfile) do
   provides "system_profile"
 
   collect_data(:darwin) do
-    begin
-      require "plist"
+    require "plist"
 
-      system_profile Array.new
-      items = Array.new
-      detail_level = {
-        "mini" => %w{
+    system_profile Array.new
+    items = Array.new
+    detail_level = {
+      "mini" => %w{
 SPParallelATAData
 SPAudioData
 SPBluetoothData
@@ -52,21 +51,22 @@ SPThunderboltData
 SPUSBData
 SPWWANData
 SPAirPortData},
-        "full" => [
-                   "SPHardwareDataType",
-                  ],
-      }
+      "full" => [
+                 "SPHardwareDataType",
+                ],
+    }
 
-      detail_level.each do |level, data_types|
-        so = shell_out("system_profiler -xml -detailLevel #{level} #{data_types.join(' ')}")
-        Plist.parse_xml(so.stdout).each do |e|
-          items << e
-        end
+    detail_level.each do |level, data_types|
+      so = shell_out("system_profiler -xml -detailLevel #{level} #{data_types.join(' ')}")
+      Plist.parse_xml(so.stdout).each do |e|
+        # delete some bogus timing data and then keep the rest
+        e.delete("_SPCompletionInterval")
+        e.delete("_SPResponseTime")
+        e.delete("_SPCommandLineArguments")
+        items << e
       end
-
-      system_profile items.sort_by { |h| h["_dataType"] }
-    rescue LoadError => e
-      Ohai::Log.debug("Can't load gem: #{e})")
     end
+
+    system_profile ( items.sort_by { |h| h["_dataType"] } ) # rubocop: disable Lint/ParenthesesAsGroupedExpression
   end
 end

data/lib/ohai/plugins/linux/platform.rb

@@ -137,7 +137,7 @@ Ohai.plugin(:Platform) do
       "rhel"
     when /amazon/
       "amazon"
-    when /suse/
+    when /suse/, /sles/, /opensuse/
       "suse"
     when /fedora/, /pidora/, /arista_eos/
       # In the broadest sense:  RPM-based, fedora-derived distributions which are not strictly re-compiled RHEL (if it uses RPMs, and smells more like redhat and less like
@@ -286,8 +286,18 @@ Ohai.plugin(:Platform) do
     elsif lsb[:id] # LSB can provide odd data that changes between releases, so we currently fall back on it rather than dealing with its subtleties
       platform lsb[:id].downcase
       platform_version lsb[:release]
+    # Use os-release (present on all modern linux distros) BUT use old *-release files as fallback.
+    # os-release will only be used if no other *-release file is present.
+    # We have to do this for compatibility reasons, or older OS releases might get different
+    # "platform" or "platform_version" attributes (e.g. SLES12, RHEL7).
+    elsif File.exist?("/etc/os-release")
+      platform os_release_info["ID"] == "sles" ? "suse" : os_release_info["ID"] # SLES is wrong. We call it SUSE
+      platform_version os_release_info["VERSION_ID"]
+      # platform_family also does not need to be hardcoded anymore.
+      # This would be the correct way, but we stick with "determine_platform_family" for compatibility reasons.
+      # platform_family os_release_info["ID_LIKE"]
     end
 
-    platform_family determine_platform_family
+    platform_family determine_platform_family if platform_family.nil?
   end
 end

data/lib/ohai/version.rb

@@ -18,5 +18,5 @@
 
 module Ohai
   OHAI_ROOT = File.expand_path(File.dirname(__FILE__))
-  VERSION = "13.10.0"
+  VERSION = "13.12.4"
 end

data/ohai.gemspec

@@ -5,7 +5,6 @@ require "ohai/version"
 Gem::Specification.new do |s|
   s.name = "ohai"
   s.version = Ohai::VERSION
-  s.platform = Gem::Platform::RUBY
   s.summary = "Ohai profiles your system and emits JSON"
   s.description = s.summary
   s.license = "Apache-2.0"
@@ -35,5 +34,5 @@ Gem::Specification.new do |s|
   s.executables = %w{ohai}
 
   s.require_path = "lib"
-  s.files = %w{LICENSE README.md Gemfile Rakefile} + Dir.glob("*.gemspec") + Dir.glob("{docs,lib,spec}/**/*")
+  s.files = %w{LICENSE README.md Gemfile Rakefile} + Dir.glob("*.gemspec") + Dir.glob("{lib,spec}/**/*")
 end

data/spec/unit/plugins/darwin/cpu_spec.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Nathan L Smith (<nlloyds@gmail.com>)
-# Copyright:: Copyright (c) 2013-2016 Chef Software, Inc.
+# Copyright:: Copyright (c) 2013-2018 Chef Software, Inc.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -78,7 +78,7 @@ machdep.cpu.max_basic: 13
 CTL
 
     allow(@plugin).to receive(:collect_os).and_return(:darwin)
-    allow(@plugin).to receive(:shell_out).with("sysctl -a").and_return(mock_shell_out(0, @stdout, ""))
+    allow(@plugin).to receive(:shell_out).with("sysctl hw machdep").and_return(mock_shell_out(0, @stdout, ""))
     @plugin.run
   end
 

data/spec/unit/plugins/linux/platform_spec.rb

@@ -702,86 +702,145 @@ CISCO_RELEASE
 
   describe "on suse" do
 
-    let(:have_suse_release) { true }
+    context "on versions that have /etc/os-release and no /etc/SuSE-release (e.g. SLES15)" do
 
-    describe "with lsb_release results" do
-      before(:each) do
-        @plugin[:lsb][:id] = "SUSE LINUX"
-      end
+      let(:have_suse_release) { false }
+      let(:have_os_release) { true }
 
-      it "should read the platform as opensuse on openSUSE" do
-        @plugin[:lsb][:release] = "12.1"
-        expect(File).to receive(:read).with("/etc/SuSE-release").and_return("openSUSE 12.1 (x86_64)\nVERSION = 12.1\nCODENAME = Asparagus\n")
-        @plugin.run
-        expect(@plugin[:platform]).to eq("opensuse")
-        expect(@plugin[:platform_family]).to eq("suse")
-      end
-    end
+      let(:os_release_content) do
+        <<-OS_RELEASE
+VERSION="15"
+VERSION_ID="15"
+PRETTY_NAME="SUSE Linux Enterprise Server 15"
+ID="sles"
+ID_LIKE="suse"
+ANSI_COLOR="0;32"
+CPE_NAME="cpe:/o:suse:sles:15"
 
-    describe "without lsb_release results" do
-      before(:each) do
-        @plugin.lsb = nil
+OS_RELEASE
       end
 
-      it "should set platform and platform_family to suse and bogus verion to 10.0" do
-        expect(File).to receive(:read).with("/etc/SuSE-release").at_least(:once).and_return("VERSION = 10.0")
-        @plugin.run
-        expect(@plugin[:platform]).to eq("suse")
-        expect(@plugin[:platform_family]).to eq("suse")
+      before do
+        expect(File).to_not receive(:read).with("/etc/SuSE-release")
+        expect(File).to receive(:read).with("/etc/os-release").and_return(os_release_content)
       end
 
-      it "should read the version as 10.1 for bogus SLES 10" do
-        expect(File).to receive(:read).with("/etc/SuSE-release").and_return("SUSE Linux Enterprise Server 10 (i586)\nVERSION = 10\nPATCHLEVEL = 1\n")
+      it "correctly detects SLES15" do
         @plugin.run
         expect(@plugin[:platform]).to eq("suse")
-        expect(@plugin[:platform_version]).to eq("10.1")
+        expect(@plugin[:platform_version]).to eq("15")
         expect(@plugin[:platform_family]).to eq("suse")
       end
 
-      it "should read the version as 11.2" do
-        expect(File).to receive(:read).with("/etc/SuSE-release").and_return("SUSE Linux Enterprise Server 11.2 (i586)\nVERSION = 11\nPATCHLEVEL = 2\n")
-        @plugin.run
-        expect(@plugin[:platform]).to eq("suse")
-        expect(@plugin[:platform_version]).to eq("11.2")
-        expect(@plugin[:platform_family]).to eq("suse")
-      end
+    end
 
-      it "[OHAI-272] should read the version as 11.3" do
-        expect(File).to receive(:read).with("/etc/SuSE-release").exactly(1).times.and_return("openSUSE 11.3 (x86_64)\nVERSION = 11.3")
-        @plugin.run
-        expect(@plugin[:platform]).to eq("opensuse")
-        expect(@plugin[:platform_version]).to eq("11.3")
-        expect(@plugin[:platform_family]).to eq("suse")
-      end
+    context "on versions that have both /etc/os-release and /etc/SuSE-release (e.g. SLES12)" do
+      let(:have_suse_release) { true }
+      let(:have_os_release) { true }
 
-      it "[OHAI-272] should read the version as 9.1" do
-        expect(File).to receive(:read).with("/etc/SuSE-release").exactly(1).times.and_return("SuSE Linux 9.1 (i586)\nVERSION = 9.1")
-        @plugin.run
-        expect(@plugin[:platform]).to eq("suse")
-        expect(@plugin[:platform_version]).to eq("9.1")
-        expect(@plugin[:platform_family]).to eq("suse")
-      end
+      describe "with lsb_release results" do
+        before(:each) do
+          @plugin[:lsb][:id] = "SUSE LINUX"
+        end
 
-      it "[OHAI-272] should read the version as 11.4" do
-        expect(File).to receive(:read).with("/etc/SuSE-release").exactly(1).times.and_return("openSUSE 11.4 (i586)\nVERSION = 11.4\nCODENAME = Celadon")
-        @plugin.run
-        expect(@plugin[:platform]).to eq("opensuse")
-        expect(@plugin[:platform_version]).to eq("11.4")
-        expect(@plugin[:platform_family]).to eq("suse")
+        it "should read the platform as opensuse on openSUSE" do
+          @plugin[:lsb][:release] = "12.1"
+          expect(File).to receive(:read).with("/etc/SuSE-release").and_return("openSUSE 12.1 (x86_64)\nVERSION = 12.1\nCODENAME = Asparagus\n")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("opensuse")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
       end
+    end
 
-      it "should read the platform as opensuse on openSUSE" do
-        expect(File).to receive(:read).with("/etc/SuSE-release").and_return("openSUSE 12.2 (x86_64)\nVERSION = 12.2\nCODENAME = Mantis\n")
-        @plugin.run
-        expect(@plugin[:platform]).to eq("opensuse")
-        expect(@plugin[:platform_family]).to eq("suse")
+    context "on versions that have no /etc/os-release but /etc/SuSE-release (e.g. SLES11)" do
+      let(:have_suse_release) { true }
+      let(:have_os_release) { false }
+
+      describe "with lsb_release results" do
+        before(:each) do
+          @plugin[:lsb][:id] = "SUSE LINUX"
+        end
+
+        it "should read the platform as opensuse on openSUSE" do
+          @plugin[:lsb][:release] = "12.1"
+          expect(File).to receive(:read).with("/etc/SuSE-release").and_return("openSUSE 12.1 (x86_64)\nVERSION = 12.1\nCODENAME = Asparagus\n")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("opensuse")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
       end
+    end
 
-      it "should read the platform as opensuseleap on openSUSE Leap" do
-        expect(File).to receive(:read).with("/etc/SuSE-release").and_return("openSUSE 42.1 (x86_64)\nVERSION = 42.1\nCODENAME = Malachite\n")
-        @plugin.run
-        expect(@plugin[:platform]).to eq("opensuseleap")
-        expect(@plugin[:platform_family]).to eq("suse")
+    context "on openSUSE and older SLES versions" do
+      let(:have_suse_release) { true }
+      let(:have_os_release) { true }
+
+      describe "without lsb_release results" do
+        before(:each) do
+          @plugin.lsb = nil
+        end
+
+        it "should set platform and platform_family to suse and bogus verion to 10.0" do
+          expect(File).to receive(:read).with("/etc/SuSE-release").at_least(:once).and_return("VERSION = 10.0")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("suse")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
+
+        it "should read the version as 10.1 for bogus SLES 10" do
+          expect(File).to receive(:read).with("/etc/SuSE-release").and_return("SUSE Linux Enterprise Server 10 (i586)\nVERSION = 10\nPATCHLEVEL = 1\n")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("suse")
+          expect(@plugin[:platform_version]).to eq("10.1")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
+
+        it "should read the version as 11.2" do
+          expect(File).to receive(:read).with("/etc/SuSE-release").and_return("SUSE Linux Enterprise Server 11.2 (i586)\nVERSION = 11\nPATCHLEVEL = 2\n")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("suse")
+          expect(@plugin[:platform_version]).to eq("11.2")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
+
+        it "[OHAI-272] should read the version as 11.3" do
+          expect(File).to receive(:read).with("/etc/SuSE-release").exactly(1).times.and_return("openSUSE 11.3 (x86_64)\nVERSION = 11.3")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("opensuse")
+          expect(@plugin[:platform_version]).to eq("11.3")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
+
+        it "[OHAI-272] should read the version as 9.1" do
+          expect(File).to receive(:read).with("/etc/SuSE-release").exactly(1).times.and_return("SuSE Linux 9.1 (i586)\nVERSION = 9.1")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("suse")
+          expect(@plugin[:platform_version]).to eq("9.1")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
+
+        it "[OHAI-272] should read the version as 11.4" do
+          expect(File).to receive(:read).with("/etc/SuSE-release").exactly(1).times.and_return("openSUSE 11.4 (i586)\nVERSION = 11.4\nCODENAME = Celadon")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("opensuse")
+          expect(@plugin[:platform_version]).to eq("11.4")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
+
+        it "should read the platform as opensuse on openSUSE" do
+          expect(File).to receive(:read).with("/etc/SuSE-release").and_return("openSUSE 12.2 (x86_64)\nVERSION = 12.2\nCODENAME = Mantis\n")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("opensuse")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
+
+        it "should read the platform as opensuseleap on openSUSE Leap" do
+          expect(File).to receive(:read).with("/etc/SuSE-release").and_return("openSUSE 42.1 (x86_64)\nVERSION = 42.1\nCODENAME = Malachite\n")
+          @plugin.run
+          expect(@plugin[:platform]).to eq("opensuseleap")
+          expect(@plugin[:platform_family]).to eq("suse")
+        end
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ohai
 version: !ruby/object:Gem::Version
-  version: 13.10.0
+  version: 13.12.4
 platform: ruby
 authors:
 - Adam Jacob
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-09 00:00:00.000000000 Z
+date: 2018-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: systemu
@@ -188,7 +188,6 @@ files:
 - README.md
 - Rakefile
 - bin/ohai
-- docs/man/man1/ohai.1
 - lib/ohai.rb
 - lib/ohai/application.rb
 - lib/ohai/common/dmi.rb
@@ -543,7 +542,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.5
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Ohai profiles your system and emits JSON

data/docs/man/man1/ohai.1

@@ -1,97 +0,0 @@
-.\" Man page generated from reStructuredText.
-.
-.TH "OHAI" "1" "Ohai 7.0.0" "" "ohai"
-.SH NAME
-ohai \- The man page for the ohai command line tool.
-.
-.nr rst2man-indent-level 0
-.
-.de1 rstReportMargin
-\\$1 \\n[an-margin]
-level \\n[rst2man-indent-level]
-level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
--
-\\n[rst2man-indent0]
-\\n[rst2man-indent1]
-\\n[rst2man-indent2]
-..
-.de1 INDENT
-.\" .rstReportMargin pre:
-. RS \\$1
-. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
-. nr rst2man-indent-level +1
-.\" .rstReportMargin post:
-..
-.de UNINDENT
-. RE
-.\" indent \\n[an-margin]
-.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.nr rst2man-indent-level -1
-.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
-..
-.sp
-Ohai is a tool that is used to detect attributes on a node, and then provide these attributes to the chef\-client at the start of every chef\-client run. Ohai is required by the chef\-client and must be present on a node. (Ohai is installed on a node as part of the chef\-client install process.)
-.sp
-The types of attributes Ohai collects include (but are not limited to):
-.INDENT 0.0
-.IP \(bu 2
-Platform details
-.IP \(bu 2
-Network usage
-.IP \(bu 2
-Memory usage
-.IP \(bu 2
-Processor usage
-.IP \(bu 2
-Kernel data
-.IP \(bu 2
-Host names
-.IP \(bu 2
-Fully qualified domain names
-.IP \(bu 2
-Other configuration details
-.UNINDENT
-.sp
-Attributes that are collected by Ohai are automatic attributes, in that these attributes are used by the chef\-client to ensure that these attributes remain unchanged after the chef\-client is done configuring the node.
-.sp
-ohai is the command\-line interface for Ohai, a tool that is used to detect attributes on a node, and then provide these attributes to the chef\-client at the start of every chef\-client run.
-.SH OPTIONS
-.sp
-This command has the following syntax:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-ohai OPTION
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-This tool has the following options:
-.INDENT 0.0
-.TP
-.B \fBATTRIBUTE_NAME ATTRIBUTE NAME ...\fP
-Use to have Ohai show only output for named attributes.
-.TP
-.B \fB\-d PATH\fP, \fB\-\-directory PATH\fP
-The directory in which Ohai plugins are located. For example: \fB/etc/ohai/plugins\fP\&.
-.TP
-.B \fB\-h\fP, \fB\-\-help\fP
-Shows help for the command.
-.TP
-.B \fB\-l LEVEL\fP, \fB\-\-log_level LEVEL\fP
-The level of logging that will be stored in a log file.
-.TP
-.B \fB\-L LOGLOCATION\fP, \fB\-\-logfile c\fP
-The location in which log file output files will be saved. If this location is set to something other than \fBSTDOUT\fP, standard output logging will still be performed (otherwise there would be no output other than to a file).
-.TP
-.B \fB\-v\fP, \fB\-\-version\fP
-The version of Ohai\&.
-.UNINDENT
-.SH AUTHOR
-Opscode
-.\" Generated by docutils manpage writer.
-.