@ -97,8 +97,12 @@ typedef struct
uint32 xrecoff ; /* low bits */
} PageXLogRecPtr ;
# define PageXLogRecPtrGet(val) \
( ( uint64 ) ( val ) . xlogid < < 32 | ( val ) . xrecoff )
static inline XLogRecPtr
PageXLogRecPtrGet ( PageXLogRecPtr val )
{
return ( uint64 ) val . xlogid < < 32 | val . xrecoff ;
}
# define PageXLogRecPtrSet(ptr, lsn) \
( ( ptr ) . xlogid = ( uint32 ) ( ( lsn ) > > 32 ) , ( ptr ) . xrecoff = ( uint32 ) ( lsn ) )
@ -200,16 +204,10 @@ typedef PageHeaderData *PageHeader;
# define PG_DATA_CHECKSUM_VERSION 1
/* ----------------------------------------------------------------
* page support macro s
* page support function s
* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
*/
/*
* PageIsValid
* True iff page is valid .
*/
# define PageIsValid(page) PointerIsValid(page)
/*
* line pointer ( s ) do not count as part of header
*/
@ -219,21 +217,31 @@ typedef PageHeaderData *PageHeader;
* PageIsEmpty
* returns true iff no itemid has been allocated on the page
*/
# define PageIsEmpty(page) \
( ( ( PageHeader ) ( page ) ) - > pd_lower < = SizeOfPageHeaderData )
static inline bool
PageIsEmpty ( Page page )
{
return ( ( PageHeader ) page ) - > pd_lower < = SizeOfPageHeaderData ;
}
/*
* PageIsNew
* returns true iff page has not been initialized ( by PageInit )
*/
# define PageIsNew(page) (((PageHeader) (page))->pd_upper == 0)
static inline bool
PageIsNew ( Page page )
{
return ( ( PageHeader ) page ) - > pd_upper = = 0 ;
}
/*
* PageGetItemId
* Returns an item identifier of a page .
*/
# define PageGetItemId(page, offsetNumber) \
( ( ItemId ) ( & ( ( PageHeader ) ( page ) ) - > pd_linp [ ( offsetNumber ) - 1 ] ) )
static inline ItemId
PageGetItemId ( Page page , OffsetNumber offsetNumber )
{
return & ( ( PageHeader ) page ) - > pd_linp [ offsetNumber - 1 ] ;
}
/*
* PageGetContents
@ -243,20 +251,17 @@ typedef PageHeaderData *PageHeader;
* Now it is . Beware of old code that might think the offset to the contents
* is just SizeOfPageHeaderData rather than MAXALIGN ( SizeOfPageHeaderData ) .
*/
# define PageGetContents(page) \
( ( char * ) ( page ) + MAXALIGN ( SizeOfPageHeaderData ) )
static inline char *
PageGetContents ( Page page )
{
return ( char * ) page + MAXALIGN ( SizeOfPageHeaderData ) ;
}
/* ----------------
* macros to access page size info
* function sto access page size info
* - - - - - - - - - - - - - - - -
*/
/*
* PageSizeIsValid
* True iff the page size is valid .
*/
# define PageSizeIsValid(pageSize) ((pageSize) == BLCKSZ)
/*
* PageGetPageSize
* Returns the page size of a page .
@ -265,15 +270,21 @@ typedef PageHeaderData *PageHeader;
* BufferGetPageSize , which can be called on an unformatted page ) .
* however , it can be called on a page that is not stored in a buffer .
*/
# define PageGetPageSize(page) \
( ( Size ) ( ( ( PageHeader ) ( page ) ) - > pd_pagesize_version & ( uint16 ) 0xFF00 ) )
static inline Size
PageGetPageSize ( Page page )
{
return ( Size ) ( ( ( PageHeader ) page ) - > pd_pagesize_version & ( uint16 ) 0xFF00 ) ;
}
/*
* PageGetPageLayoutVersion
* Returns the page layout version of a page .
*/
# define PageGetPageLayoutVersion(page) \
( ( ( PageHeader ) ( page ) ) - > pd_pagesize_version & 0x00FF )
static inline uint8
PageGetPageLayoutVersion ( Page page )
{
return ( ( ( PageHeader ) page ) - > pd_pagesize_version & 0x00FF ) ;
}
/*
* PageSetPageSizeAndVersion
@ -282,52 +293,52 @@ typedef PageHeaderData *PageHeader;
* We could support setting these two values separately , but there ' s
* no real need for it at the moment .
*/
# define PageSetPageSizeAndVersion(page, size, version) \
( \
AssertMacro ( ( ( size ) & 0xFF00 ) = = ( size ) ) , \
AssertMacro ( ( ( version ) & 0x00FF ) = = ( version ) ) , \
( ( PageHeader ) ( page ) ) - > pd_pagesize_version = ( size ) | ( version ) \
)
static inline void
PageSetPageSizeAndVersion ( Page page , Size size , uint8 version )
{
Assert ( ( size & 0xFF00 ) = = size ) ;
Assert ( ( version & 0x00FF ) = = version ) ;
( ( PageHeader ) page ) - > pd_pagesize_version = size | version ;
}
/* ----------------
* page special data macro s
* page special data function s
* - - - - - - - - - - - - - - - -
*/
/*
* PageGetSpecialSize
* Returns size of special space on a page .
*/
# define PageGetSpecialSize(page) \
( ( uint16 ) ( PageGetPageSize ( page ) - ( ( PageHeader ) ( page ) ) - > pd_special ) )
static inline uint16
PageGetSpecialSize ( Page page )
{
return ( PageGetPageSize ( page ) - ( ( PageHeader ) page ) - > pd_special ) ;
}
/*
* Using assertions , validate that the page special pointer is OK .
*
* This is intended to catch use of the pointer before page initialization .
* It is implemented as a function due to the limitations of the MSVC
* compiler , which choked on doing all these tests within another macro . We
* return true so that AssertMacro ( ) can be used while still getting the
* specifics from the macro failure within this function .
*/
static inline bool
static inline void
PageValidateSpecialPointer ( Page page )
{
Assert ( PageIsValid ( page ) ) ;
Assert ( ( ( PageHeader ) ( page ) ) - > pd_special < = BLCKSZ ) ;
Assert ( ( ( PageHeader ) ( page ) ) - > pd_special > = SizeOfPageHeaderData ) ;
return true ;
Assert ( page ) ;
Assert ( ( ( PageHeader ) page ) - > pd_special < = BLCKSZ ) ;
Assert ( ( ( PageHeader ) page ) - > pd_special > = SizeOfPageHeaderData ) ;
}
/*
* PageGetSpecialPointer
* Returns pointer to special space on a page .
*/
# define PageGetSpecialPointer(page) \
( \
AssertMacro ( PageValidateSpecialPointer ( page ) ) , \
( char * ) ( ( char * ) ( page ) + ( ( PageHeader ) ( page ) ) - > pd_special ) \
)
static inline char *
PageGetSpecialPointer ( Page page )
{
PageValidateSpecialPointer ( page ) ;
return ( char * ) page + ( ( PageHeader ) page ) - > pd_special ;
}
/*
* PageGetItem
@ -337,12 +348,14 @@ PageValidateSpecialPointer(Page page)
* This does not change the status of any of the resources passed .
* The semantics may change in the future .
*/
# define PageGetItem(page, itemId) \
( \
AssertMacro ( PageIsValid ( page ) ) , \
AssertMacro ( ItemIdHasStorage ( itemId ) ) , \
( Item ) ( ( ( char * ) ( page ) ) + ItemIdGetOffset ( itemId ) ) \
)
static inline Item
PageGetItem ( Page page , ItemId itemId )
{
Assert ( page ) ;
Assert ( ItemIdHasStorage ( itemId ) ) ;
return ( Item ) ( ( ( char * ) page ) + ItemIdGetOffset ( itemId ) ) ;
}
/*
* PageGetMaxOffsetNumber
@ -351,44 +364,84 @@ PageValidateSpecialPointer(Page page)
* of items on the page .
*
* NOTE : if the page is not initialized ( pd_lower = = 0 ) , we must
* return zero to ensure sane behavior . Accept double evaluation
* of the argument so that we can ensure this .
* return zero to ensure sane behavior .
*/
# define PageGetMaxOffsetNumber(page) \
( ( ( PageHeader ) ( page ) ) - > pd_lower < = SizeOfPageHeaderData ? 0 : \
( ( ( ( PageHeader ) ( page ) ) - > pd_lower - SizeOfPageHeaderData ) \
/ sizeof ( ItemIdData ) ) )
static inline OffsetNumber
PageGetMaxOffsetNumber ( Page page )
{
PageHeader pageheader = ( PageHeader ) page ;
if ( pageheader - > pd_lower < = SizeOfPageHeaderData )
return 0 ;
else
return ( pageheader - > pd_lower - SizeOfPageHeaderData ) / sizeof ( ItemIdData ) ;
}
/*
* Additional macros for access to page headers . ( Beware multiple evaluation
* of the arguments ! )
* Additional functions for access to page headers .
*/
# define PageGetLSN(page) \
PageXLogRecPtrGet ( ( ( PageHeader ) ( page ) ) - > pd_lsn )
# define PageSetLSN(page, lsn) \
PageXLogRecPtrSet ( ( ( PageHeader ) ( page ) ) - > pd_lsn , lsn )
# define PageHasFreeLinePointers(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags & PD_HAS_FREE_LINES )
# define PageSetHasFreeLinePointers(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags | = PD_HAS_FREE_LINES )
# define PageClearHasFreeLinePointers(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags & = ~ PD_HAS_FREE_LINES )
# define PageIsFull(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags & PD_PAGE_FULL )
# define PageSetFull(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags | = PD_PAGE_FULL )
# define PageClearFull(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags & = ~ PD_PAGE_FULL )
# define PageIsAllVisible(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags & PD_ALL_VISIBLE )
# define PageSetAllVisible(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags | = PD_ALL_VISIBLE )
# define PageClearAllVisible(page) \
( ( ( PageHeader ) ( page ) ) - > pd_flags & = ~ PD_ALL_VISIBLE )
static inline XLogRecPtr
PageGetLSN ( Page page )
{
return PageXLogRecPtrGet ( ( ( PageHeader ) page ) - > pd_lsn ) ;
}
static inline void
PageSetLSN ( Page page , XLogRecPtr lsn )
{
PageXLogRecPtrSet ( ( ( PageHeader ) page ) - > pd_lsn , lsn ) ;
}
static inline bool
PageHasFreeLinePointers ( Page page )
{
return ( ( PageHeader ) page ) - > pd_flags & PD_HAS_FREE_LINES ;
}
static inline void
PageSetHasFreeLinePointers ( Page page )
{
( ( PageHeader ) page ) - > pd_flags | = PD_HAS_FREE_LINES ;
}
static inline void
PageClearHasFreeLinePointers ( Page page )
{
( ( PageHeader ) page ) - > pd_flags & = ~ PD_HAS_FREE_LINES ;
}
static inline bool
PageIsFull ( Page page )
{
return ( ( PageHeader ) page ) - > pd_flags & PD_PAGE_FULL ;
}
static inline void
PageSetFull ( Page page )
{
( ( PageHeader ) page ) - > pd_flags | = PD_PAGE_FULL ;
}
static inline void
PageClearFull ( Page page )
{
( ( PageHeader ) page ) - > pd_flags & = ~ PD_PAGE_FULL ;
}
static inline bool
PageIsAllVisible ( Page page )
{
return ( ( PageHeader ) page ) - > pd_flags & PD_ALL_VISIBLE ;
}
static inline void
PageSetAllVisible ( Page page )
{
( ( PageHeader ) page ) - > pd_flags | = PD_ALL_VISIBLE ;
}
static inline void
PageClearAllVisible ( Page page )
{
( ( PageHeader ) page ) - > pd_flags & = ~ PD_ALL_VISIBLE ;
}
/*
* These two require " access/transam.h " , so left as macros .
*/
# define PageSetPrunable(page, xid) \
do { \
Assert ( TransactionIdIsNormal ( xid ) ) ; \
@ -413,15 +466,6 @@ do { \
# define PIV_LOG_WARNING (1 << 0)
# define PIV_REPORT_STAT (1 << 1)
# define PageAddItem(page, item, size, offsetNumber, overwrite, is_heap) \
PageAddItemExtended ( page , item , size , offsetNumber , \
( ( overwrite ) ? PAI_OVERWRITE : 0 ) | \
( ( is_heap ) ? PAI_IS_HEAP : 0 ) )
# define PageIsVerified(page, blkno) \
PageIsVerifiedExtended ( page , blkno , \
PIV_LOG_WARNING | PIV_REPORT_STAT )
/*
* Check that BLCKSZ is a multiple of sizeof ( size_t ) . In
* PageIsVerifiedExtended ( ) , it is much faster to check if a page is
@ -436,6 +480,21 @@ extern void PageInit(Page page, Size pageSize, Size specialSize);
extern bool PageIsVerifiedExtended ( Page page , BlockNumber blkno , int flags ) ;
extern OffsetNumber PageAddItemExtended ( Page page , Item item , Size size ,
OffsetNumber offsetNumber , int flags ) ;
static inline OffsetNumber
PageAddItem ( Page page , Item item , Size size , OffsetNumber offsetNumber , bool overwrite , bool is_heap )
{
return PageAddItemExtended ( page , item , size , offsetNumber ,
( overwrite ? PAI_OVERWRITE : 0 ) |
( is_heap ? PAI_IS_HEAP : 0 ) ) ;
}
static inline bool
PageIsVerified ( Page page , BlockNumber blkno )
{
return PageIsVerifiedExtended ( page , blkno , PIV_LOG_WARNING | PIV_REPORT_STAT ) ;
}
extern Page PageGetTempPage ( Page page ) ;
extern Page PageGetTempPageCopy ( Page page ) ;
extern Page PageGetTempPageCopySpecial ( Page page ) ;
Peter Eisentraut
3 years ago