radfish 0.2.10 → 0.2.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad19da6f011320835b8e6fc236057a1613a6c01da37672361a06b2b4affe120c
-  data.tar.gz: e6ef687e6b6c87b653c6bfe52d4781057007032f956618b9f8348eb32874e171
+  metadata.gz: 56ac8a4bd0fa74d4925bd369825c0d7df1b87e77acea9a41d1327461a058e2e4
+  data.tar.gz: 5089df7444609d31fd193e8d6c022640ec57cbda96baf26c1df920eeb17bc3ab
 SHA512:
-  metadata.gz: 5f9d5decaf01d69e5098bad75775706f775f81824aa0653fdde5add5561c014eb7169cf6b2eb2c685cb49c1937f196149ca2aa13075ec55ad3765743494b26b7
-  data.tar.gz: 4e75db9b41a4edf1468bd695eb1014b7943435aeeb8ef75b7dbd1181b233aca8b98946ea003a628461a8344d04a326c0b2f4587c20c2589d419c09e5f76b34e5
+  metadata.gz: 10cdabeb27695b1a66aeb6531fa83da737b2a66e9f6ab24505a870797968ec5de49a388299627a954f1641e45ef356182535dcd7e4916bb2e8469b447c1d7dc4
+  data.tar.gz: bb95d3be33e59529b53231948763f60803f637353a707395cbc674aa898932696868dae481108fc64545055ed26072a7fda308c948214b770635618ab850b8dc

data/lib/radfish/boot_info.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Radfish
+  # Boot configuration facade. Reached as +client.boot+.
+  #
+  # The vendor-neutral entry point for the boot mechanics that used to be hand-rolled in raw
+  # Redfish by callers (reading BootSources, disabling stale UEFI placeholders, scheduling the
+  # config job). The heavy lifting lives in the adapter; this object just exposes it cleanly and
+  # keeps +to_h+ pointing at the underlying boot configuration for backward compatibility.
+  class BootInfo
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    # The still-enabled stale UEFI boot placeholders (Dell: "Unknown.Unknown.*"). [] when the
+    # adapter has nothing to report. Pass +match:+ to target a different set of entries.
+    def stale_uefi_entries(match: nil)
+      require_adapter!(:stale_uefi_boot_entries)
+      match ? adapter.stale_uefi_boot_entries(match: match) : adapter.stale_uefi_boot_entries
+    end
+
+    # Disable the matched UEFI boot entries via a config job and return the names disabled.
+    # With no +match:+ the adapter's default (the stale placeholders) applies. The adapter drains
+    # any pending LC config job first, so this never trips LC068.
+    def disable_entries(match: nil, **opts)
+      require_adapter!(:disable_boot_entries)
+      match ? adapter.disable_boot_entries(match: match, **opts) : adapter.disable_boot_entries(**opts)
+    end
+
+    # Underlying boot configuration hash (BootSourceOverride*, boot order, ...).
+    def to_h
+      adapter.boot_config
+    end
+    alias config to_h
+
+    private
+
+    def adapter
+      @client.adapter
+    end
+
+    def require_adapter!(method)
+      return if adapter.respond_to?(method)
+
+      raise NotImplementedError, "#{@client.vendor_name} adapter does not support ##{method}"
+    end
+  end
+end

data/lib/radfish/client.rb

@@ -127,7 +127,67 @@ module Radfish
     def power
       @power ||= PowerInfo.new(self)
     end
-    
+
+    # Boot facade: client.boot.stale_uefi_entries / client.boot.disable_entries(match:).
+    def boot
+      @boot ||= BootInfo.new(self)
+    end
+
+    # Live BMC power state (e.g. "On"/"Off"), read straight from the adapter. Replaces callers
+    # reaching through the adapter to the vendor client's own power-state call.
+    def power_state
+      @adapter.power_status
+    end
+
+    # Canonical Redfish BootProgress order (normalized to snake_case), earliest to latest. Used to
+    # decide when a host has reached OR passed a requested state.
+    BOOT_PROGRESS_ORDER = %i[
+      none
+      primary_processor_initialization_started
+      bus_initialization_started
+      memory_initialization_started
+      secondary_processor_initialization_started
+      pci_resource_config_started
+      system_hardware_initialization_complete
+      setup_entered
+      os_boot_started
+      os_running
+    ].freeze
+
+    # Normalized last BootProgress state (a snake_case symbol), or nil when the BMC omits
+    # BootProgress entirely (iDRAC8). nil means "cannot observe", never "not running".
+    def boot_progress
+      return nil unless @adapter.respond_to?(:boot_progress)
+
+      @adapter.boot_progress
+    end
+
+    # Wait until the host reaches (or passes) +target+ BootProgress, bounded by +timeout+ or, when
+    # not given, the adapter's per-model POST ceiling. Returns the observed state on success, or nil
+    # when the BMC does not report BootProgress (nothing to wait on -- the caller uses other signals).
+    # Raises Radfish::BootProgressTimeout on a stall.
+    def wait_for_boot_progress(target, timeout: nil, poll: 20)
+      target = target.to_sym
+      ceiling = timeout || (@adapter.respond_to?(:boot_progress_ceiling) ? @adapter.boot_progress_ceiling(target) : 900)
+      deadline = Time.now + ceiling
+      target_idx = BOOT_PROGRESS_ORDER.index(target)
+
+      loop do
+        state = boot_progress
+        return nil if state.nil? # BMC omits BootProgress (iDRAC8): unobservable, not a failure
+        return state if state == target
+
+        state_idx = BOOT_PROGRESS_ORDER.index(state)
+        return state if target_idx && state_idx && state_idx >= target_idx
+
+        if Time.now > deadline
+          raise BootProgressTimeout,
+                "BootProgress did not reach #{target.inspect} within #{ceiling}s (last: #{state.inspect})"
+        end
+        sleep poll
+      end
+    end
+
     def thermal
       @thermal ||= ThermalInfo.new(self)
     end

data/lib/radfish/core/boot.rb

@@ -34,7 +34,16 @@ module Radfish
       def boot_to_cd
         raise NotImplementedError, "Adapter must implement #boot_to_cd"
       end
-      
+
+      # Convenience: one-time boot to the virtual CD. Default delegates to the adapter's standard
+      # Redfish boot override (boot_to_cd, which defaults to a one-time override). Adapters with a
+      # more reliable vendor path (e.g. Dell's SCP ServerBoot) override this. `reboot:` is accepted
+      # for signature parity with those overrides; the default does not reboot -- the caller cycles
+      # power (the app's install_os! does).
+      def set_one_time_cd_boot(reboot: false)
+        boot_to_cd
+      end
+
       def boot_to_usb
         raise NotImplementedError, "Adapter must implement #boot_to_usb"
       end

data/lib/radfish/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Radfish
-  VERSION = "0.2.10"
+  VERSION = "0.2.12"
 end

data/lib/radfish.rb

@@ -30,6 +30,10 @@ module Radfish
   class TaskTimeoutError < TaskError; end
   class TaskFailedError < TaskError; end
 
+  # Raised by Client#wait_for_boot_progress when a host does not reach the requested
+  # BootProgress state within its (per-model) ceiling.
+  class BootProgressTimeout < TimeoutError; end
+
   module Debuggable
     def debug(message, level = 1, color = :light_cyan)
       return unless respond_to?(:verbosity) && verbosity >= level
@@ -90,6 +94,7 @@ require_relative 'radfish/vendor_detector'
 require_relative 'radfish/system_info'
 require_relative 'radfish/bmc_info'
 require_relative 'radfish/power_info'
+require_relative 'radfish/boot_info'
 require_relative 'radfish/thermal_info'
 require_relative 'radfish/pci_info'
 require_relative 'radfish/controller'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: radfish
 version: !ruby/object:Gem::Version
-  version: 0.2.10
+  version: 0.2.12
 platform: ruby
 authors:
 - Jonathan Siegel
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-20 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -166,6 +165,7 @@ files:
 - exe/radfish
 - lib/radfish.rb
 - lib/radfish/bmc_info.rb
+- lib/radfish/boot_info.rb
 - lib/radfish/cli.rb
 - lib/radfish/cli/base.rb
 - lib/radfish/client.rb
@@ -197,7 +197,6 @@ metadata:
   homepage_uri: https://github.com/buildio/radfish
   source_code_uri: https://github.com/buildio/radfish
   changelog_uri: https://github.com/buildio/radfish/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -212,8 +211,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Unified Redfish API Client for Server Management
 test_files: []