Synnefo » snf-ganeti

  def acquire(self, shared=0, timeout=None, test_notify=None):

    """Acquire a shared lock.

    @param shared: whether to acquire in shared mode; by default an

        exclusive lock will be acquired

    @type timeout: float

  def __init__(self, members=None):

    """Constructs a new LockSet.

    @param members: initial members of the set

    """

  def acquire(self, names, timeout=None, shared=0, test_notify=None):

    """Acquire a set of resource locks.

    @param names: the names of the locks which shall be acquired

        (special lock names, or instance/node names)

    @param shared: whether to acquire in shared mode; by default an

        exclusive lock will be acquired

    @type timeout: float or None

    You must have acquired the locks, either in shared or in exclusive mode,

    before releasing them.

    @param names: the names of the locks which shall be released

        (defaults to all the locks acquired at that level).

  def add(self, names, acquired=0, shared=0):

    """Add a new set of elements to the set

    @param names: names of the new elements to add

    @param acquired: pre-acquire the new resource?

    @param shared: is the pre-acquisition shared?

    """

    You can either not hold anything in the lockset or already hold a superset

    of the elements you want to delete, exclusively.

    @param names: names of the resource to remove.

    @return: a list of locks which we removed; the list is always

  def acquire(self, level, names, timeout=None, shared=0):

    """Acquire a set of resource locks, at the same level.

    @param names: the names of the locks which shall be acquired

        (special lock names, or instance/node names)

    @param shared: whether to acquire in shared mode; by default

        an exclusive lock will be acquired

    @type timeout: float

    You must have acquired the locks, either in shared or in exclusive

    mode, before releasing them.

    @param names: the names of the locks which shall be released

        (defaults to all the locks acquired at that level)

  def add(self, level, names, acquired=0, shared=0):

    """Add locks at the specified level.

    @param names: names of the locks to acquire

    @param acquired: whether to acquire the newly added locks

    @param shared: whether the acquisition will be shared

    """

    You must either already own the locks you are trying to remove

    exclusively or not own any lock at an upper level.

    @param names: the names of the locks which shall be removed

        (special lock names, or instance/node names)