Parent

Namespace

Class/Module Index [+]

Quicksearch

Sys::CPU

Encapsulates system CPU information


Public Class Methods

architecture() click to toggle source
# File lib/unix/sys/cpu.rb, line 92
def self.architecture
  if respond_to?(:sysinfo, true)
    buf = 0.chr * 257

    if sysinfo(SI_ARCHITECTURE, buf, buf.size) < 0
      raise Error, "sysinfo function failed"
    end

    buf.strip
  elsif respond_to?(:sysctlbyname, true)
    optr = FFI::MemoryPointer.new(:char, 256)
    size = FFI::MemoryPointer.new(:size_t)

    size.write_int(optr.size)

    if RbConfig::CONFIG['host_os'] =~ /darwin/
      name = 'hw.machine'
    else
      name = 'hw.machine_arch'
    end

    if sysctlbyname(name, optr, size, nil, 0) < 0
      raise Error, "sysctlbyname function failed"
    end

    optr.read_string
  else
    buf  = 0.chr * 64
    mib  = FFI::MemoryPointer.new(:int, 2)
    size = FFI::MemoryPointer.new(:long, 1)

    mib.write_array_of_int([CTL_HW, HW_MACHINE_ARCH])
    size.write_int(buf.size)

    if sysctl(mib, 2, buf, size, nil, 0) < 0
      raise Error, "sysctl function failed"
    end

    buf.strip
  end
end
cpu_stats() click to toggle source

Returns a hash of arrays that contain the number of seconds that the system spent in user mode, user mode with low priority (nice), system mode, and the idle task, respectively.

# File lib/linux/sys/cpu.rb, line 99
def self.cpu_stats
  cpu_stat_file = "/proc/stat"
  hash = {} # Hash needed for multi-cpu systems

  lines = IO.readlines(cpu_stat_file)

  lines.each_with_index{ |line, i|
    array = line.split
    break unless array[0] =~ /cpu/   # 'cpu' entries always on top

    # Some machines list a 'cpu' and a 'cpu0'. In this case only
    # return values for the numbered cpu entry.
    if lines[i].split[0] == "cpu" && lines[i+1].split[0] =~ /cpu\d/
      next
    end

    vals = array[1..-1].map{ |e| e = e.to_i / 100 } # 100 jiffies/sec.
    hash[array[0]] = vals
  }

  hash
end
cpu_type(host = Socket.gethostname) click to toggle source

Returns a string indicating the type of processor, e.g. GenuineIntel.

# File lib/windows/sys/cpu.rb, line 258
def self.cpu_type(host = Socket.gethostname)
  cs = BASE_CS + "//#{host}/root/cimv2:Win32_Processor='cpu0'"
  begin
    wmi = WIN32OLE.connect(cs)
  rescue WIN32OLERuntimeError => e
    raise Error, e
  else
    return wmi.Manufacturer
  end
end
fpu_type() click to toggle source
# File lib/unix/sys/cpu.rb, line 306
def self.fpu_type
  raise NoMethodError unless respond_to?(:processor_info, true)

  pinfo = ProcInfo.new

  if processor_info(0, pinfo) < 0
    if processor_info(1, pinfo) < 0
      raise Error, "process_info function failed"
    end
  end

  pinfo[:pi_fputypes].to_s
end
freq() click to toggle source
# File lib/unix/sys/cpu.rb, line 245
def self.freq
  if respond_to?(:sysctlbyname, true)
    optr = FFI::MemoryPointer.new(:long)
    size = FFI::MemoryPointer.new(:size_t)

    size.write_long(optr.size)

    if RbConfig::CONFIG['host_os'] =~ /bsd/
      name = 'hw.clockrate'
    else
      name = 'hw.cpufrequency'
    end

    if sysctlbyname(name, optr, size, nil, 0) < 0
      raise Error, "sysctlbyname failed"
    end

    if RbConfig::CONFIG['host_os'] =~ /darwin/
      optr.read_long / 1000000
    else
      optr.read_long
    end
  elsif respond_to?(:sysctl, true)
    buf  = 0.chr * 16
    mib  = FFI::MemoryPointer.new(:int, 2)
    size = FFI::MemoryPointer.new(:long, 1)

    mib.write_array_of_int([CTL_HW, HW_CPU_FREQ])
    size.write_int(buf.size)

    if sysctl(mib, 2, buf, size, nil, 0) < 0
      raise Error, "sysctl function failed"
    end

    buf.unpack("I*").first / 1000000
  else
    pinfo = ProcInfo.new

    # Some systems start at 0, some at 1
    if processor_info(0, pinfo) < 0
      if processor_info(1, pinfo) < 0
        raise Error, "process_info function failed"
      end
    end

    pinfo[:pi_clock].to_i
  end
end
load_avg() click to toggle source
# File lib/unix/sys/cpu.rb, line 294
def self.load_avg
  if respond_to?(:getloadavg, true)
    loadavg = FFI::MemoryPointer.new(:double, 3)

    if getloadavg(loadavg, loadavg.size) < 0
      raise Error, "getloadavg function failed"
    end

    loadavg.get_array_of_double(0, 3)
  end
end
machine() click to toggle source
# File lib/unix/sys/cpu.rb, line 170
def self.machine
  if respond_to?(:sysctl, true)
    buf  = 0.chr * 32
    mib  = FFI::MemoryPointer.new(:int, 2)
    size = FFI::MemoryPointer.new(:long, 1)

    mib.write_array_of_int([CTL_HW, HW_MACHINE])
    size.write_int(buf.size)

    if sysctl(mib, 2, buf, size, nil, 0) < 0
      raise Error, "sysctl function failed"
    end

    buf.strip
  else
    buf = 0.chr * 257

    if sysinfo(SI_MACHINE, buf, buf.size) < 0
      raise Error, "sysinfo function failed"
    end

    buf.strip
  end
end
model() click to toggle source
# File lib/unix/sys/cpu.rb, line 195
def self.model
  if RbConfig::CONFIG['host_os'] =~ /darwin/
    ptr  = FFI::MemoryPointer.new(:long)
    size = FFI::MemoryPointer.new(:size_t)

    size.write_long(ptr.size)

    if sysctlbyname("hw.cputype", ptr, size, nil, 0) < 0
      raise "sysctlbyname function failed"
    end

    case ptr.read_long
      when  CPU_TYPE_X86, CPU_TYPE_X86_64
        "Intel"
      when CPU_TYPE_SPARC
        "Sparc"
      when CPU_TYPE_POWERPC, CPU_TYPE_POWERPC64
        "PowerPC"
      else
        "Unknown"
    end
  else
    if respond_to?(:sysctl, true)
      buf  = 0.chr * 64
      mib  = FFI::MemoryPointer.new(:int, 2)
      size = FFI::MemoryPointer.new(:long, 1)

      mib.write_array_of_int([CTL_HW, HW_MODEL])
      size.write_int(buf.size)

      if sysctl(mib, 2, buf, size, nil, 0) < 0
        raise Error, "sysctl function failed"
      end

      buf.strip
    else
      pinfo = ProcInfo.new

      # Some systems start at 0, some at 1
      if processor_info(0, pinfo) < 0
        if processor_info(1, pinfo) < 0
          raise Error, "process_info function failed"
        end
      end

      pinfo[:pi_processor_type].to_s
    end
  end
end
num_cpu() click to toggle source
# File lib/unix/sys/cpu.rb, line 134
def self.num_cpu
  if respond_to?(:sysctlbyname, true)
    optr = FFI::MemoryPointer.new(:long)
    size = FFI::MemoryPointer.new(:size_t)

    size.write_long(optr.size)

    if sysctlbyname('hw.ncpu', optr, size, nil, 0) < 0
      raise Error, "sysctlbyname failed"
    end

    optr.read_long
  elsif respond_to?(:sysconf, true)
    num = sysconf(SC_NPROCESSORS_ONLN)

    if num < 0
      raise Error, "sysconf function failed"
    end

    num
  else
    buf  = 0.chr * 4
    mib  = FFI::MemoryPointer.new(:int, 2)
    size = FFI::MemoryPointer.new(:long, 1)

    mib.write_array_of_int([CTL_HW, HW_NCPU])
    size.write_int(buf.size)

    if sysctl(mib, 2, buf, size, nil, 0) < 0
      raise Error, "sysctl function failed"
    end

    buf.strip.unpack("C").first
  end
end
processors(host = Socket.gethostname) click to toggle source

Returns a CPUStruct for each CPU on host, or the localhost if no host is specified. A CPUStruct contains the following members:

  • address_width

  • architecture

  • availability

  • caption

  • config_manager_error_code

  • config_manager_user_config

  • cpu_status

  • creation_class_name

  • freq

  • voltage

  • data_width

  • description

  • device_id

  • error_cleared?

  • error_description

  • ext_clock

  • family

  • install_date

  • l2_cache_size

  • l2_cache_speed

  • last_error_code

  • level

  • load_avg

  • manufacturer

  • max_clock_speed

  • name

  • other_family_description

  • pnp_device_id

  • power_management_supported?

  • power_management_capabilities

  • processor_id

  • processor_type

  • revision

  • role

  • socket_designation

  • status

  • status_info

  • stepping

  • system_creation_class_name

  • system_name

  • unique_id

  • upgrade_method

  • version

  • voltage_caps

Note that not all of these members will necessarily be defined.

# File lib/windows/sys/cpu.rb, line 199
def self.processors(host = Socket.gethostname) # :yields: CPUStruct
  begin
    wmi = WIN32OLE.connect(BASE_CS + "//#{host}/root/cimv2")
  rescue WIN32OLERuntimeError => e
    raise Error, e
  else
    wmi.InstancesOf("Win32_Processor").each{ |cpu|
      yield CPUStruct.new(
        cpu.AddressWidth,
        self.get_cpu_arch(cpu.Architecture),
        self.get_availability(cpu.Availability),
        cpu.Caption,
        self.get_cmec(cpu.ConfigManagerErrorCode),
        cpu.ConfigManagerUserConfig,
        get_status(cpu.CpuStatus),
        cpu.CreationClassName,
        cpu.CurrentClockSpeed,
        cpu.CurrentVoltage,
        cpu.DataWidth,
        cpu.Description,
        cpu.DeviceId,
        cpu.ErrorCleared,
        cpu.ErrorDescription,
        cpu.ExtClock,
        self.get_family(cpu.Family),
        cpu.InstallDate,
        cpu.L2CacheSize,
        cpu.L2CacheSpeed,
        cpu.LastErrorCode,
        cpu.Level,
        cpu.LoadPercentage,
        cpu.Manufacturer,
        cpu.MaxClockSpeed,
        cpu.Name,
        cpu.OtherFamilyDescription,
        cpu.PNPDeviceID,
        cpu.PowerManagementSupported,
        cpu.PowerManagementCapabilities,
        cpu.ProcessorId,
        self.get_processor_type(cpu.ProcessorType),
        cpu.Revision,
        cpu.Role,
        cpu.SocketDesignation,
        cpu.Status,
        cpu.StatusInfo,
        cpu.Stepping,
        cpu.SystemCreationClassName,
        cpu.SystemName,
        cpu.UniqueId,
        self.get_upgrade_method(cpu.UpgradeMethod),
        cpu.Version,
        self.get_voltage_caps(cpu.VoltageCaps)
      )
    }
  end
end
state(num = 0) click to toggle source
# File lib/unix/sys/cpu.rb, line 320
def self.state(num = 0)
  raise NoMethodError unless respond_to?(:processor_info, true)

  pinfo = ProcInfo.new

  if processor_info(num, pinfo) < 0
    raise Error, "process_info function failed"
  end

  case pinfo[:pi_state].to_i
    when P_ONLINE
      "online"
    when P_OFFLINE
      "offline"
    when P_POWEROFF
      "poweroff"
    when P_FAULTED
      "faulted"
    when P_NOINTR
      "nointr"
    when P_SPARE
      "spare"
    else
      "unknown"
  end
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.