1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
=begin
== Lock system
# module BDB
#
The lock subsystem provides interprocess and intraprocess concurrency
control mechanisms. While the locking system is used extensively by
the Berkeley DB access methods and transaction system, it may also be
used as a stand-alone subsystem to provide concurrency control to any
set of designated resources.
#
# class Lockid
# end
#
The lock subsystem is created, initialized, and opened by calls to
(({BDB::Env#open})) with the ((|DBD::INIT_LOCK|)) or
((|DBB::INIT_CDB|)) flags specified.
The following options can be given when the environnement is created
: ((|"set_lk_conflicts"|))
Set lock conflicts matrix
: ((|"set_lk_detect"|))
Set automatic deadlock detection
: ((|"set_lk_max"|))
Set maximum number of locks
=== BDB::LockError
#
Exception generated by lock call
#
# class LockError < Exception
# end
=== BDB::LockHeld
#^
Lock not held by locker
#^
# class LockHeld < LockError
# end
=== BDB::LockGranted
#^
Lock not granted
#^
# class LockGranted < LockError
# end
=== BDB::LockDead
#^
Locker killed to resolve a deadlock
#^
# class LockDead < LockError
# end
## a BDB::Lockid object is created by the method lock, lock_id
# class Lockid
=== BDB::Lockid
A lock ID can be obtained with ((<BDB::Env#lock_id|URL:env.html#lock_id>))
See also ((<BDB::Env#lock_stat|URL:env.html#lock_stat>)) and
((<BDB::Env#lock_detect|URL:env.html#lock_detect>))
==== Methods
--- get(string, mode , flags = 0)
--- lock_get(string, mode [, flags])
The lock_get function acquires a lock from the lock table, it return
an object ((|BDB::Lock|))
((|string|)) specifies the object to be locked or released.
((|mode|)) is an index into the environment's lock conflict array
((|flags|)) value must be set to 0 or the value ((|BDBD::LOCK_NOWAIT|))
in this case if a lock cannot be granted because the requested
lock conflicts with an existing lock, raise an error ((|BDB::LockGranted|))
--- vec(array , flags = 0)
--- lock_vec(array [, flags])
The ((|lock_vec|)) function atomically obtains and releases one or more
locks from the lock table. The ((|lock_vec|)) function is intended to
support acquisition or trading of multiple locks under one lock table
semaphore, as is needed for lock coupling or in multigranularity
locking for lock escalation.
: ((|array|))
ARRAY of HASH with the following keys
: ((|"op"|))
the operation to be performed, which must be set to one
of the following values ((|BDB::LOCK_GET|)), ((|BDB::LOCK_PUT|)),
((|BDB::LOCK_PUT_ALL|)) or ((|BDB::LOCK_PUT_OBJ|))
: ((|"obj"|))
the object (String) to be locked or released
: ((|"mode"|))
is an index into the environment's lock conflict array
: ((|"lock"|))
an object ((|BDB::Lock|))
: ((|flags|))
value must be set to 0 or the value ((|BDBD::LOCK_NOWAIT|))
in this case if a lock cannot be granted because the requested
lock conflicts with an existing lock, raise an error
((|BDB::LockGranted|))return immediately
# end
# class Lock
=== BDB::Lock
==== Methods
--- put()
--- lock_put()
--- release()
--- delete()
The ((|lock_put|)) function releases lock from the lock table.
# end
# end
=end
|
