module Corosync

Constants

VERSION

Public Class Methods

cs_send(method, *args) click to toggle source

Calls a Corosync method and raises an exception on error while handling retries. This is the same as {cs_send!} except that on the event of TryAgainError, it retries for up to 3 seconds.

@param method [Symbol] name of the method to call @param args

@return [TrueClass, Integer] Returns ‘true` on success, and an integer if the return value is not known (this should not happen unless you’re running a newer version of corosync than the gem was released for). @see cs_send!

# File lib/corosync.rb, line 47
def self.cs_send(method, *args)
  cs_error = nil

  time_start = Time.new.to_f
  begin
    begin
      cs_error = send(method, *args)
    rescue Corosync::Error => e
      e.depth += 1
      raise e
    end

    return true if cs_error == :ok # short circuit the rest of the method since this should be true the majority of the time

    break if cs_error != :err_try_again
    sleep 0.05
  end while Time.new.to_f - time_start < 3

  if exception_class = Error::Map[cs_error] then
    exception = exception_class.new("Received #{cs_error.to_s.upcase} during #{method}")
    exception.depth = 1
    raise exception
  end

  cs_error
end

cs_send!(method, *args) click to toggle source

Calls a Corosync method and raises an exception on errors. This is a convenience method to handle error responses when calling various corosync library functions. When an error is returned, an exception is raised. The exceptions are programatically generated based off the ‘:cs_error_t` enum defined in `ffi/common.rb`. For example, `:err_try_again` maps to `Corosync::TryAgainError`.

@param method [Symbol] name of the method to call @param args

# File lib/corosync.rb, line 18
def self.cs_send!(method, *args)
  cs_error = nil

  begin
    cs_error = send(method, *args)
  rescue Corosync::Error => e
    e.depth += 1
    raise e
  end

  return true if cs_error == :ok # short circuit the rest of the method since this should be true the majority of the time

  if exception_class = Error::Map[cs_error] then
    exception = exception_class.new("Received #{cs_error.to_s.upcase} during #{method}")
    exception.depth = 1
    raise exception
  end

  cs_error
end

Public Instance Methods

value() click to toggle source

# File lib/corosync/exceptions.rb, line 26
def value
  self.class.const_get :VALUE
end