postgresql/src/include/utils/inval.h

/*-------------------------------------------------------------------------
 *
 * inval.h
 *	  POSTGRES cache invalidation dispatcher definitions.
 *
 *
 * Portions Copyright (c) 1996-2003, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 * $PostgreSQL: pgsql/src/include/utils/inval.h,v 1.31 2004/05/06 16:10:57 tgl Exp $
 *
 *-------------------------------------------------------------------------
 */
#ifndef INVAL_H
#define INVAL_H

#include "access/htup.h"


typedef void (*CacheCallbackFunction) (Datum arg, Oid relid);


extern void AcceptInvalidationMessages(void);

extern void AtEOXactInvalidationMessages(bool isCommit);

extern void CommandEndInvalidationMessages(bool isCommit);

extern void CacheInvalidateHeapTuple(Relation relation, HeapTuple tuple);

extern void CacheInvalidateRelcache(Relation relation);

extern void CacheInvalidateRelcacheByTuple(HeapTuple classTuple);

extern void CacheInvalidateRelcacheByRelid(Oid relid);

extern void CacheRegisterSyscacheCallback(int cacheid,
							  CacheCallbackFunction func,
							  Datum arg);

extern void CacheRegisterRelcacheCallback(CacheCallbackFunction func,
							  Datum arg);

#endif   /* INVAL_H */
More cleanups of the include files - centralizing to simplify the -I's required to compile 1996-08-28 03:59:28 +02:00			`/*-------------------------------------------------------------------------`
			`*`
Change my-function-name-- to my_function_name, and optimizer renames. 1999-02-14 00:22:53 +01:00			`* inval.h`
Massive commit to run PGINDENT on all .c and .h files. 1997-09-07 07:04:48 +02:00			`* POSTGRES cache invalidation dispatcher definitions.`
More cleanups of the include files - centralizing to simplify the -I's required to compile 1996-08-28 03:59:28 +02:00			`*`
			`*`
Update copyrights to 2003. 2003-08-04 04:40:20 +02:00			`* Portions Copyright (c) 1996-2003, PostgreSQL Global Development Group`
Add: * Portions Copyright (c) 1996-2000, PostgreSQL, Inc to all files copyright Regents of Berkeley. Man, that's a lot of files. 2000-01-26 06:58:53 +01:00			`* Portions Copyright (c) 1994, Regents of the University of California`
More cleanups of the include files - centralizing to simplify the -I's required to compile 1996-08-28 03:59:28 +02:00			`*`
Make ALTER COLUMN TYPE preserve clustered status for indexes it doesn't modify. Also fix a passel of problems with ALTER TABLE CLUSTER ON: failure to check that the index is safe to cluster on (or even belongs to the indicated rel, or even exists), and failure to broadcast a relcache flush event when changing an index's state. 2004-05-06 18:10:57 +02:00			`* $PostgreSQL: pgsql/src/include/utils/inval.h,v 1.31 2004/05/06 16:10:57 tgl Exp $`
More cleanups of the include files - centralizing to simplify the -I's required to compile 1996-08-28 03:59:28 +02:00			`*`
			`*-------------------------------------------------------------------------`
			`*/`
Massive commit to run PGINDENT on all .c and .h files. 1997-09-07 07:04:48 +02:00			`#ifndef INVAL_H`
More cleanups of the include files - centralizing to simplify the -I's required to compile 1996-08-28 03:59:28 +02:00			`#define INVAL_H`

Change #include's to use <> and "" as appropriate. 1999-07-16 01:04:24 +02:00			`#include "access/htup.h"`
More cleanups of the include files - centralizing to simplify the -I's required to compile 1996-08-28 03:59:28 +02:00

Add cache invalidation callback hooks. 2002-04-30 00:14:34 +02:00			`typedef void (*CacheCallbackFunction) (Datum arg, Oid relid);`


Clean up some longstanding problems in shared-cache invalidation. SI messages now include the relevant database OID, so that operations in one database do not cause useless cache flushes in backends attached to other databases. Declare SI messages properly using a union, to eliminate the former assumption that Oid is the same size as int or Index. Rewrite the nearly-unreadable code in inval.c, and document it better. Arrange for catcache flushes at end of command/transaction to happen before relcache flushes do --- this avoids loading a new tuple into the catcache while setting up new relcache entry, only to have it be flushed again immediately. 2001-06-19 21:42:16 +02:00			`extern void AcceptInvalidationMessages(void);`
More cleanups of the include files - centralizing to simplify the -I's required to compile 1996-08-28 03:59:28 +02:00
Clean up some longstanding problems in shared-cache invalidation. SI messages now include the relevant database OID, so that operations in one database do not cause useless cache flushes in backends attached to other databases. Declare SI messages properly using a union, to eliminate the former assumption that Oid is the same size as int or Index. Rewrite the nearly-unreadable code in inval.c, and document it better. Arrange for catcache flushes at end of command/transaction to happen before relcache flushes do --- this avoids loading a new tuple into the catcache while setting up new relcache entry, only to have it be flushed again immediately. 2001-06-19 21:42:16 +02:00			`extern void AtEOXactInvalidationMessages(bool isCommit);`

			`extern void CommandEndInvalidationMessages(bool isCommit);`
Improve cache invalidation handling. Eespecially this would fix TODO * elog() flushes cache, try invalidating just entries from current xact, perhaps using invalidation cache 2000-01-10 07:30:56 +01:00
Catcaches can now store negative entries as well as positive ones, to speed up repetitive failed searches; per pghackers discussion in late January. inval.c logic substantially simplified, since we can now treat inserts and deletes alike as far as inval events are concerned. Some repair work needed in heap_create_with_catalog, which turns out to have been doing CommandCounterIncrement at a point where the new relation has non-self-consistent catalog entries. With the new inval code, that resulted in assert failures during a relcache entry rebuild. 2002-03-03 18:47:56 +01:00			`extern void CacheInvalidateHeapTuple(Relation relation, HeapTuple tuple);`
More cleanups of the include files - centralizing to simplify the -I's required to compile 1996-08-28 03:59:28 +02:00
Restructure smgr API as per recent proposal. smgr no longer depends on the relcache, and so the notion of 'blind write' is gone. This should improve efficiency in bgwriter and background checkpoint processes. Internal restructuring in md.c to remove the not-very-useful array of MdfdVec objects --- might as well just use pointers. Also remove the long-dead 'persistent main memory' storage manager (mm.c), since it seems quite unlikely to ever get resurrected. 2004-02-10 02:55:27 +01:00			`extern void CacheInvalidateRelcache(Relation relation);`

			`extern void CacheInvalidateRelcacheByTuple(HeapTuple classTuple);`
Another pgindent run. Fixes enum indenting, and improves #endif spacing. Also adds space for one-line comments. 2001-10-28 07:26:15 +01:00
Make ALTER COLUMN TYPE preserve clustered status for indexes it doesn't modify. Also fix a passel of problems with ALTER TABLE CLUSTER ON: failure to check that the index is safe to cluster on (or even belongs to the indicated rel, or even exists), and failure to broadcast a relcache flush event when changing an index's state. 2004-05-06 18:10:57 +02:00			`extern void CacheInvalidateRelcacheByRelid(Oid relid);`

Add cache invalidation callback hooks. 2002-04-30 00:14:34 +02:00			`extern void CacheRegisterSyscacheCallback(int cacheid,`
pgindent run. 2002-09-04 22:31:48 +02:00			`CacheCallbackFunction func,`
			`Datum arg);`
Add cache invalidation callback hooks. 2002-04-30 00:14:34 +02:00
			`extern void CacheRegisterRelcacheCallback(CacheCallbackFunction func,`
pgindent run. 2002-09-04 22:31:48 +02:00			`Datum arg);`
Add cache invalidation callback hooks. 2002-04-30 00:14:34 +02:00
New pgindent run with fixes suggested by Tom. Patch manually reviewed, initdb/regression tests pass. 2001-11-05 18:46:40 +01:00			`#endif /* INVAL_H */`