postgresql/src/include/utils/inval.h

/*-------------------------------------------------------------------------
 *
 * inval.h
 *	  POSTGRES cache invalidation dispatcher definitions.
 *
 *
 * Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 * $Id: inval.h,v 1.26 2002/06/20 20:29:53 momjian 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(Oid relationId);

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 copyright to 2002. 2002-06-20 22:29:54 +02:00			`* Portions Copyright (c) 1996-2002, 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			`*`
Update copyright to 2002. 2002-06-20 22:29:54 +02:00			`* $Id: inval.h,v 1.26 2002/06/20 20:29:53 momjian 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
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 CacheInvalidateRelcache(Oid relationId);`
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
Add cache invalidation callback hooks. 2002-04-30 00:14:34 +02:00			`extern void CacheRegisterSyscacheCallback(int cacheid,`
			`CacheCallbackFunction func,`
			`Datum arg);`

			`extern void CacheRegisterRelcacheCallback(CacheCallbackFunction func,`
			`Datum arg);`

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 */`