Module: Rex::Ref

Included in:
Service
Defined in:
lib/rex/sync/ref.rb

Overview

This module provides a uniform reference counted interface for classes to use.

Instance Method Summary collapse

Instance Method Details

#cleanup ⇒ Object

Called to clean up resources once the ref count drops to zero.



54
55
 
# File 'lib/rex/sync/ref.rb', line 54

def cleanup
end

#deref ⇒ Object

Decrements the total number of references. If the reference count reaches zero, true is returned. Otherwise, false is returned.



39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/rex/sync/ref.rb', line 39

def deref
	@_references_mutex.synchronize {
		if ((@_references -= 1) == 0)
			cleanup

			true
		else
			false
		end
	}
end

#ref ⇒ Object

Increments the total number of references.



27
28
29
30
31
32
33
 
# File 'lib/rex/sync/ref.rb', line 27

def ref
	@_references_mutex.synchronize {
		@_references += 1
	}

	self
end

#refinit ⇒ Object

Initializes the reference count to one.



17
18
19
20
21
22
 
# File 'lib/rex/sync/ref.rb', line 17

def refinit
	@_references       = 1
	@_references_mutex = Mutex.new

	self
end