Class: Yast2::Systemd::UnitProperties

Inherits:
OpenStruct
  • Object
show all
Includes:
Yast::Logger
Defined in:
library/systemd/src/lib/yast2/systemd/unit_properties.rb

Overview

Structure holding properties of systemd unit

Constant Summary collapse

SUPPORTED_STATES = 
%w[enabled disabled].freeze
ACTIVE_STATES =

Values of #active_state fow which we consider a unit "active".

systemctl.c:check_unit_active uses (active, reloading) For bsc#884756 we also consider "activating" to be active.

"maintenance" means that the unit will automatically return to be "active" after a while. (systemctl clean was invoked)

(The remaining states are "deactivating", "inactive", "failed".)

Yes, depending on systemd states that are NOT covered by their interface stability promise is fragile. But: 10 to 50ms per call of systemctl is-active, times 100 to 300 services (depending on hardware and software installed, VM or not) is a 1 to 15 second delay (bsc#1045658). That is why we try hard to avoid many systemctl calls.

["active", "activating", "maintenance", "reloading"].freeze

Instance Method Summary collapse

Constructor Details

#initialize(systemd_unit, property_text) ⇒ UnitProperties

Returns a new instance of UnitProperties.

Parameters:

  • systemd_unit (Yast2::Systemd::Unit)
  • property_text (String, nil) —

    if provided, use it instead of calling systemctl show

[View source] [View on GitHub]

31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
 
# File 'library/systemd/src/lib/yast2/systemd/unit_properties.rb', line 31

def initialize(systemd_unit, property_text)
  super()
  self[:systemd_unit] = systemd_unit
  if property_text.nil?
    raw_output   = load_systemd_properties
    self[:raw]   = raw_output.stdout
    self[:error] = raw_output.stderr
    self[:exit]  = raw_output.exit
  else
    self[:raw]   = property_text
    self[:error] = ""
    self[:exit]  = 0
  end

  if !exit.zero? || !error.empty?
    message = "Failed to get properties for unit '#{systemd_unit.unit_name}' ; "
    message << "Command `#{raw_output.command}` returned error: #{error}"
    log.error(message)
    self[:not_found?] = true
    return
  end

  extract_properties
  self[:active?]         = ACTIVE_STATES.include?(active_state)
  self[:running?]        = sub_state  == "running"
  self[:loaded?]         = load_state == "loaded"
  self[:not_found?]      = load_state == "not-found"
  self[:static?]         = unit_file_state == "static"
  self[:preset_enabled?] = read_preset_enabled_state
  self[:enabled?]        = read_enabled_state
  self[:supported?]      = SUPPORTED_STATES.include?(unit_file_state)
  self[:can_reload?]     = can_reload == "yes"
end