1996-08-28 03:59:28 +02:00
|
|
|
/*-------------------------------------------------------------------------
|
|
|
|
*
|
1999-02-14 00:22:53 +01:00
|
|
|
* lock.h
|
2000-12-22 01:51:54 +01:00
|
|
|
* POSTGRES low-level lock mechanism
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
|
|
|
*
|
2003-08-04 04:40:20 +02:00
|
|
|
* Portions Copyright (c) 1996-2003, PostgreSQL Global Development Group
|
2000-01-26 06:58:53 +01:00
|
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
2004-07-17 05:32:14 +02:00
|
|
|
* $PostgreSQL: pgsql/src/include/storage/lock.h,v 1.79 2004/07/17 03:31:26 tgl Exp $
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
|
|
|
*-------------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
#ifndef LOCK_H_
|
|
|
|
#define LOCK_H_
|
|
|
|
|
1999-07-16 01:04:24 +02:00
|
|
|
#include "storage/itemptr.h"
|
2001-09-29 06:02:27 +02:00
|
|
|
#include "storage/lwlock.h"
|
1999-07-16 19:07:40 +02:00
|
|
|
#include "storage/shmem.h"
|
1996-08-28 03:59:28 +02:00
|
|
|
|
|
|
|
|
2000-12-22 01:51:54 +01:00
|
|
|
/* originally in procq.h */
|
|
|
|
typedef struct PROC_QUEUE
|
|
|
|
{
|
2002-06-11 15:40:53 +02:00
|
|
|
SHM_QUEUE links; /* head of list of PGPROC objects */
|
2001-01-22 23:30:06 +01:00
|
|
|
int size; /* number of entries in list */
|
2000-12-22 01:51:54 +01:00
|
|
|
} PROC_QUEUE;
|
|
|
|
|
2002-06-11 15:40:53 +02:00
|
|
|
/* struct PGPROC is declared in storage/proc.h, but must forward-reference it */
|
|
|
|
typedef struct PGPROC PGPROC;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
|
|
|
|
2001-06-28 01:31:40 +02:00
|
|
|
extern int max_locks_per_xact;
|
|
|
|
|
2000-05-31 02:28:42 +02:00
|
|
|
#ifdef LOCK_DEBUG
|
2001-03-22 05:01:46 +01:00
|
|
|
extern int Trace_lock_oidmin;
|
2000-05-31 02:28:42 +02:00
|
|
|
extern bool Trace_locks;
|
|
|
|
extern bool Trace_userlocks;
|
2001-03-22 05:01:46 +01:00
|
|
|
extern int Trace_lock_table;
|
2000-05-31 02:28:42 +02:00
|
|
|
extern bool Debug_deadlocks;
|
2001-11-05 18:46:40 +01:00
|
|
|
#endif /* LOCK_DEBUG */
|
2000-05-31 02:28:42 +02:00
|
|
|
|
|
|
|
|
2000-12-22 01:51:54 +01:00
|
|
|
typedef int LOCKMASK;
|
1998-06-30 04:33:34 +02:00
|
|
|
typedef int LOCKMODE;
|
2001-01-22 23:30:06 +01:00
|
|
|
/* MAX_LOCKMODES cannot be larger than the # of bits in LOCKMASK */
|
2001-07-10 00:18:34 +02:00
|
|
|
#define MAX_LOCKMODES 10
|
1996-08-28 03:59:28 +02:00
|
|
|
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
#define LOCKBIT_ON(lockmode) (1 << (lockmode))
|
|
|
|
#define LOCKBIT_OFF(lockmode) (~(1 << (lockmode)))
|
|
|
|
|
|
|
|
typedef uint16 LOCKMETHODID;
|
2001-09-29 06:02:27 +02:00
|
|
|
/* MAX_LOCK_METHODS is the number of distinct lock control tables allowed */
|
1998-09-01 06:40:42 +02:00
|
|
|
#define MAX_LOCK_METHODS 3
|
1996-08-28 03:59:28 +02:00
|
|
|
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
#define INVALID_LOCKMETHOD 0
|
1998-08-25 23:20:32 +02:00
|
|
|
#define DEFAULT_LOCKMETHOD 1
|
|
|
|
#define USER_LOCKMETHOD 2
|
1996-08-28 03:59:28 +02:00
|
|
|
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
#define LockMethodIsValid(lockmethodid) ((lockmethodid) != INVALID_LOCKMETHOD)
|
|
|
|
|
2001-06-22 02:04:59 +02:00
|
|
|
/*
|
|
|
|
* There is normally only one lock method, the default one.
|
|
|
|
* If user locks are enabled, an additional lock method is present.
|
2001-02-23 20:24:06 +01:00
|
|
|
*
|
2000-12-22 01:51:54 +01:00
|
|
|
* This is the control structure for a lock table. It
|
2001-03-22 05:01:46 +01:00
|
|
|
* lives in shared memory. This information is the same
|
2001-02-23 19:28:46 +01:00
|
|
|
* for all backends.
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
2002-07-19 01:06:20 +02:00
|
|
|
* lockHash -- hash table holding per-locked-object lock information
|
|
|
|
*
|
2003-02-18 03:13:24 +01:00
|
|
|
* proclockHash -- hash table holding per-lock-waiter/holder lock information
|
2002-07-19 01:06:20 +02:00
|
|
|
*
|
1998-06-30 04:33:34 +02:00
|
|
|
* lockmethod -- the handle used by the lock table's clients to
|
|
|
|
* refer to the type of lock table being used.
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
1998-06-30 04:33:34 +02:00
|
|
|
* numLockModes -- number of lock types (READ,WRITE,etc) that
|
1997-09-07 07:04:48 +02:00
|
|
|
* are defined on this lock table
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
|
|
|
* conflictTab -- this is an array of bitmasks showing lock
|
1997-09-07 07:04:48 +02:00
|
|
|
* type conflicts. conflictTab[i] is a mask with the j-th bit
|
|
|
|
* turned on if lock types i and j conflict.
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
2001-09-29 06:02:27 +02:00
|
|
|
* masterLock -- synchronizes access to the table
|
2002-07-19 01:06:20 +02:00
|
|
|
*
|
1996-08-28 03:59:28 +02:00
|
|
|
*/
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
typedef struct LockMethodData
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
LOCKMETHODID lockmethodid;
|
|
|
|
int numLockModes;
|
|
|
|
LOCKMASK conflictTab[MAX_LOCKMODES];
|
|
|
|
LWLockId masterLock;
|
|
|
|
} LockMethodData;
|
|
|
|
typedef LockMethodData *LockMethod;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
1998-08-25 23:20:32 +02:00
|
|
|
|
2000-12-22 01:51:54 +01:00
|
|
|
/*
|
|
|
|
* LOCKTAG is the key information needed to look up a LOCK item in the
|
2001-03-22 05:01:46 +01:00
|
|
|
* lock hashtable. A LOCKTAG value uniquely identifies a lockable object.
|
2000-12-22 01:51:54 +01:00
|
|
|
*/
|
|
|
|
typedef struct LOCKTAG
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
2003-02-20 00:41:15 +01:00
|
|
|
Oid relId;
|
2000-12-22 01:51:54 +01:00
|
|
|
Oid dbId;
|
|
|
|
union
|
|
|
|
{
|
|
|
|
BlockNumber blkno;
|
|
|
|
TransactionId xid;
|
2003-02-20 00:41:15 +01:00
|
|
|
} objId;
|
1999-03-06 22:17:56 +01:00
|
|
|
|
2000-12-22 01:51:54 +01:00
|
|
|
/*
|
|
|
|
* offnum should be part of objId.tupleId above, but would increase
|
|
|
|
* sizeof(LOCKTAG) and so moved here; currently used by userlocks
|
|
|
|
* only.
|
|
|
|
*/
|
|
|
|
OffsetNumber offnum;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
LOCKMETHODID lockmethodid; /* needed by userlocks */
|
2000-12-22 01:51:54 +01:00
|
|
|
} LOCKTAG;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
|
|
|
|
|
|
|
/*
|
2000-12-22 01:51:54 +01:00
|
|
|
* Per-locked-object lock information:
|
1996-08-28 03:59:28 +02:00
|
|
|
*
|
|
|
|
* tag -- uniquely identifies the object being locked
|
2001-01-16 07:11:34 +01:00
|
|
|
* grantMask -- bitmask for all lock types currently granted on this object.
|
|
|
|
* waitMask -- bitmask for all lock types currently awaited on this object.
|
2002-07-19 02:17:40 +02:00
|
|
|
* lockHolders -- list of PROCLOCK objects for this lock.
|
2001-01-16 07:11:34 +01:00
|
|
|
* waitProcs -- queue of processes waiting for this lock.
|
|
|
|
* requested -- count of each lock type currently requested on the lock
|
|
|
|
* (includes requests already granted!!).
|
|
|
|
* nRequested -- total requested locks of all types.
|
|
|
|
* granted -- count of each lock type currently granted on the lock.
|
|
|
|
* nGranted -- total granted locks of all types.
|
1996-08-28 03:59:28 +02:00
|
|
|
*/
|
1998-06-30 04:33:34 +02:00
|
|
|
typedef struct LOCK
|
1997-09-07 07:04:48 +02:00
|
|
|
{
|
|
|
|
/* hash key */
|
2001-01-16 07:11:34 +01:00
|
|
|
LOCKTAG tag; /* unique identifier of lockable object */
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
/* data */
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
LOCKMASK grantMask; /* bitmask for lock types already granted */
|
|
|
|
LOCKMASK waitMask; /* bitmask for lock types awaited */
|
2002-09-04 22:31:48 +02:00
|
|
|
SHM_QUEUE lockHolders; /* list of PROCLOCK objects assoc. with
|
|
|
|
* lock */
|
2002-06-11 15:40:53 +02:00
|
|
|
PROC_QUEUE waitProcs; /* list of PGPROC objects waiting on lock */
|
2001-03-22 05:01:46 +01:00
|
|
|
int requested[MAX_LOCKMODES]; /* counts of requested
|
|
|
|
* locks */
|
2001-01-16 07:11:34 +01:00
|
|
|
int nRequested; /* total of requested[] array */
|
2001-03-22 05:01:46 +01:00
|
|
|
int granted[MAX_LOCKMODES]; /* counts of granted locks */
|
2001-01-16 07:11:34 +01:00
|
|
|
int nGranted; /* total of granted[] array */
|
1997-09-08 23:56:23 +02:00
|
|
|
} LOCK;
|
1996-08-28 03:59:28 +02:00
|
|
|
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
#define LOCK_LOCKMETHOD(lock) ((lock).tag.lockmethodid)
|
1996-08-28 03:59:28 +02:00
|
|
|
|
2000-12-22 01:51:54 +01:00
|
|
|
|
|
|
|
/*
|
|
|
|
* We may have several different transactions holding or awaiting locks
|
2003-02-18 03:13:24 +01:00
|
|
|
* on the same lockable object. We need to store some per-waiter/holder
|
|
|
|
* information for each such holder (or would-be holder).
|
2000-12-22 01:51:54 +01:00
|
|
|
*
|
2002-07-19 02:17:40 +02:00
|
|
|
* PROCLOCKTAG is the key information needed to look up a PROCLOCK item in the
|
2003-08-04 02:43:34 +02:00
|
|
|
* proclock hashtable. A PROCLOCKTAG value uniquely identifies a lock
|
2003-02-18 03:13:24 +01:00
|
|
|
* holder/waiter.
|
2000-12-22 01:51:54 +01:00
|
|
|
*
|
2003-02-18 03:13:24 +01:00
|
|
|
* There are two possible kinds of proclock tags: a transaction (identified
|
2002-06-11 15:40:53 +02:00
|
|
|
* both by the PGPROC of the backend running it, and the xact's own ID) and
|
2004-07-01 02:52:04 +02:00
|
|
|
* a session (identified by backend PGPROC, with XID = InvalidTransactionId).
|
2000-12-22 01:51:54 +01:00
|
|
|
*
|
2003-02-18 03:13:24 +01:00
|
|
|
* Currently, session proclocks are used for user locks and for cross-xact
|
2004-07-01 02:52:04 +02:00
|
|
|
* locks obtained for VACUUM. Note that a single backend can hold locks
|
|
|
|
* under several different XIDs at once (including session locks). We treat
|
|
|
|
* such locks as never conflicting (a backend can never block itself).
|
2001-01-16 07:11:34 +01:00
|
|
|
*
|
|
|
|
* The holding[] array counts the granted locks (of each type) represented
|
2003-02-18 03:13:24 +01:00
|
|
|
* by this proclock. Note that there will be a proclock object, possibly with
|
2001-01-16 07:11:34 +01:00
|
|
|
* zero holding[], for any lock that the process is currently waiting on.
|
2003-02-18 03:13:24 +01:00
|
|
|
* Otherwise, proclock objects whose counts have gone to zero are recycled
|
2001-01-16 07:11:34 +01:00
|
|
|
* as soon as convenient.
|
2001-01-22 23:30:06 +01:00
|
|
|
*
|
2004-07-01 02:52:04 +02:00
|
|
|
* Each PROCLOCK object is linked into lists for both the associated LOCK
|
|
|
|
* object and the owning PGPROC object. Note that the PROCLOCK is entered
|
|
|
|
* into these lists as soon as it is created, even if no lock has yet been
|
|
|
|
* granted. A PGPROC that is waiting for a lock to be granted will also be
|
|
|
|
* linked into the lock's waitProcs queue.
|
2000-12-22 01:51:54 +01:00
|
|
|
*/
|
2002-07-19 02:17:40 +02:00
|
|
|
typedef struct PROCLOCKTAG
|
2000-12-22 01:51:54 +01:00
|
|
|
{
|
|
|
|
SHMEM_OFFSET lock; /* link to per-lockable-object information */
|
2002-06-11 15:40:53 +02:00
|
|
|
SHMEM_OFFSET proc; /* link to PGPROC of owning backend */
|
2000-12-22 01:51:54 +01:00
|
|
|
TransactionId xid; /* xact ID, or InvalidTransactionId */
|
2002-07-19 02:17:40 +02:00
|
|
|
} PROCLOCKTAG;
|
2000-12-22 01:51:54 +01:00
|
|
|
|
2002-07-19 02:17:40 +02:00
|
|
|
typedef struct PROCLOCK
|
2000-12-22 01:51:54 +01:00
|
|
|
{
|
|
|
|
/* tag */
|
2003-02-18 03:13:24 +01:00
|
|
|
PROCLOCKTAG tag; /* unique identifier of proclock object */
|
2000-12-22 01:51:54 +01:00
|
|
|
|
|
|
|
/* data */
|
2001-03-22 05:01:46 +01:00
|
|
|
int holding[MAX_LOCKMODES]; /* count of locks currently held */
|
2001-01-16 07:11:34 +01:00
|
|
|
int nHolding; /* total of holding[] array */
|
2003-02-18 03:13:24 +01:00
|
|
|
SHM_QUEUE lockLink; /* list link for lock's list of proclocks */
|
2003-08-04 02:43:34 +02:00
|
|
|
SHM_QUEUE procLink; /* list link for process's list of
|
|
|
|
* proclocks */
|
2002-07-19 02:17:40 +02:00
|
|
|
} PROCLOCK;
|
2000-12-22 01:51:54 +01:00
|
|
|
|
2003-02-18 03:13:24 +01:00
|
|
|
#define PROCLOCK_LOCKMETHOD(proclock) \
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
(((LOCK *) MAKE_PTR((proclock).tag.lock))->tag.lockmethodid)
|
2000-12-22 01:51:54 +01:00
|
|
|
|
2002-08-17 15:04:19 +02:00
|
|
|
/*
|
2002-08-31 19:14:28 +02:00
|
|
|
* This struct holds information passed from lmgr internals to the lock
|
2002-09-04 22:31:48 +02:00
|
|
|
* listing user-level functions (lockfuncs.c). For each PROCLOCK in the
|
2002-08-31 19:14:28 +02:00
|
|
|
* system, the SHMEM_OFFSET, PROCLOCK itself, and associated PGPROC and
|
|
|
|
* LOCK objects are stored. (Note there will often be multiple copies
|
|
|
|
* of the same PGPROC or LOCK.) We do not store the SHMEM_OFFSET of the
|
|
|
|
* PGPROC or LOCK separately, since they're in the PROCLOCK's tag fields.
|
2002-08-17 15:04:19 +02:00
|
|
|
*/
|
|
|
|
typedef struct
|
|
|
|
{
|
2002-09-04 22:31:48 +02:00
|
|
|
int nelements; /* The length of each of the arrays */
|
2003-02-18 03:13:24 +01:00
|
|
|
SHMEM_OFFSET *proclockaddrs;
|
|
|
|
PROCLOCK *proclocks;
|
2002-09-04 22:31:48 +02:00
|
|
|
PGPROC *procs;
|
|
|
|
LOCK *locks;
|
2002-08-17 15:04:19 +02:00
|
|
|
} LockData;
|
2000-12-22 01:51:54 +01:00
|
|
|
|
2004-05-28 07:13:32 +02:00
|
|
|
extern int NumLockMethods;
|
|
|
|
|
1996-08-28 03:59:28 +02:00
|
|
|
/*
|
|
|
|
* function prototypes
|
|
|
|
*/
|
1997-09-08 04:41:22 +02:00
|
|
|
extern void InitLocks(void);
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
extern LockMethod GetLocksMethodTable(LOCK *lock);
|
2004-05-28 07:13:32 +02:00
|
|
|
extern LOCKMETHODID LockMethodTableInit(const char *tabName,
|
|
|
|
const LOCKMASK *conflictsP,
|
|
|
|
int numModes, int maxBackends);
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
extern LOCKMETHODID LockMethodTableRename(LOCKMETHODID lockmethodid);
|
|
|
|
extern bool LockAcquire(LOCKMETHODID lockmethodid, LOCKTAG *locktag,
|
2001-06-22 02:04:59 +02:00
|
|
|
TransactionId xid, LOCKMODE lockmode, bool dontWait);
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
extern bool LockRelease(LOCKMETHODID lockmethodid, LOCKTAG *locktag,
|
2001-03-22 05:01:46 +01:00
|
|
|
TransactionId xid, LOCKMODE lockmode);
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
extern bool LockReleaseAll(LOCKMETHODID lockmethodid, PGPROC *proc,
|
2004-07-17 05:32:14 +02:00
|
|
|
bool allxids);
|
Try to reduce confusion about what is a lock method identifier, a lock
method control structure, or a table of control structures.
. Use type LOCKMASK where an int is not a counter.
. Get rid of INVALID_TABLEID, use INVALID_LOCKMETHOD instead.
. Use INVALID_LOCKMETHOD instead of (LOCKMETHOD) NULL, because
LOCKMETHOD is not a pointer.
. Define and use macro LockMethodIsValid.
. Rename LOCKMETHOD to LOCKMETHODID.
. Remove global variable LongTermTableId in lmgr.c, because it is
never used.
. Make LockTableId static in lmgr.c, because it is used nowhere else.
Why not remove it and use DEFAULT_LOCKMETHOD?
. Rename the lock method control structure from LOCKMETHODTABLE to
LockMethodData. Introduce a pointer type named LockMethod.
. Remove elog(FATAL) after InitLockTable() call in
CreateSharedMemoryAndSemaphores(), because if something goes wrong,
there is elog(FATAL) in LockMethodTableInit(), and if this doesn't
help, an elog(ERROR) in InitLockTable() is promoted to FATAL.
. Make InitLockTable() void, because its only caller does not use its
return value any more.
. Rename variables in lock.c to avoid statements like
LockMethodTable[NumLockMethods] = lockMethodTable;
lockMethodTable = LockMethodTable[lockmethod];
. Change LOCKMETHODID type to uint16 to fit into struct LOCKTAG.
. Remove static variables BITS_OFF and BITS_ON from lock.c, because
I agree to this doubt:
* XXX is a fetch from a static array really faster than a shift?
. Define and use macros LOCKBIT_ON/OFF.
Manfred Koizar
2003-12-01 22:59:25 +01:00
|
|
|
extern int LockCheckConflicts(LockMethod lockMethodTable,
|
2001-03-22 05:01:46 +01:00
|
|
|
LOCKMODE lockmode,
|
2003-02-18 03:13:24 +01:00
|
|
|
LOCK *lock, PROCLOCK *proclock, PGPROC *proc,
|
2001-03-22 05:01:46 +01:00
|
|
|
int *myHolding);
|
2003-02-18 03:13:24 +01:00
|
|
|
extern void GrantLock(LOCK *lock, PROCLOCK *proclock, LOCKMODE lockmode);
|
2002-06-11 15:40:53 +02:00
|
|
|
extern void RemoveFromWaitQueue(PGPROC *proc);
|
1999-02-21 02:41:55 +01:00
|
|
|
extern int LockShmemSize(int maxBackends);
|
2002-06-11 15:40:53 +02:00
|
|
|
extern bool DeadLockCheck(PGPROC *proc);
|
2003-01-16 22:01:45 +01:00
|
|
|
extern void DeadLockReport(void);
|
|
|
|
extern void RememberSimpleDeadLock(PGPROC *proc1,
|
2003-08-04 02:43:34 +02:00
|
|
|
LOCKMODE lockmode,
|
|
|
|
LOCK *lock,
|
|
|
|
PGPROC *proc2);
|
2001-01-25 04:31:16 +01:00
|
|
|
extern void InitDeadLockChecking(void);
|
2002-08-31 19:14:28 +02:00
|
|
|
extern LockData *GetLockStatusData(void);
|
|
|
|
extern const char *GetLockmodeName(LOCKMODE mode);
|
1998-02-26 05:46:47 +01:00
|
|
|
|
2000-05-31 02:28:42 +02:00
|
|
|
#ifdef LOCK_DEBUG
|
1997-09-08 04:41:22 +02:00
|
|
|
extern void DumpLocks(void);
|
1998-08-25 23:20:32 +02:00
|
|
|
extern void DumpAllLocks(void);
|
1997-02-12 06:25:13 +01:00
|
|
|
#endif
|
2001-10-28 07:26:15 +01:00
|
|
|
|
2001-11-05 18:46:40 +01:00
|
|
|
#endif /* LOCK_H */
|