Add database page inspection /contrib module.

Simon and Heikki

contrib/Makefile

-# $PostgreSQL: pgsql/contrib/Makefile,v 1.75 2007/04/21 17:26:17 petere Exp $
+# $PostgreSQL: pgsql/contrib/Makefile,v 1.76 2007/05/17 19:11:24 momjian Exp $
 
 subdir = contrib
 top_builddir = ..
@@ -19,6 +19,7 @@ WANTED_DIRS = \
 		lo		\
 		ltree		\
 		oid2name	\
+		pageinspect	\
 		pg_buffercache	\
 		pg_freespacemap \
 		pg_standby	\

contrib/README

@@ -80,6 +80,10 @@ oid2name -
 	Maps numeric files to table names
 	by B Palmer <bpalmer@crimelabs.net>
 
+pageinspect -
+	Allows inspection of database pages
+	Heikki Linnakangas <heikki@enterprisedb.com>
+
 pg_buffercache -
 	Real time queries on the shared buffer cache
 	by Mark Kirkwood <markir@paradise.net.nz>

contrib/pageinspect/Makefile

+#-------------------------------------------------------------------------
+#
+# pageinspect Makefile
+#
+# $PostgreSQL: pgsql/contrib/pageinspect/Makefile,v 1.1 2007/05/17 19:11:24 momjian Exp $
+#
+#-------------------------------------------------------------------------
+
+MODULE_big	= pageinspect
+OBJS		= rawpage.o heapfuncs.o btreefuncs.o
+DOCS		= README.pageinspect
+DATA_built	= pageinspect.sql
+DATA      	= uninstall_pageinspect.sql
+
+ifdef USE_PGXS
+PGXS := $(shell pg_config --pgxs)
+include $(PGXS)
+else
+subdir = contrib/pageinspect
+top_builddir = ../..
+include $(top_builddir)/src/Makefile.global
+include $(top_srcdir)/contrib/contrib-global.mk
+endif
+

contrib/pageinspect/README.pageinspect

+The functions in this module allow you to inspect the contents of data pages
+at a low level, for debugging purposes.
+
+1. Installation
+
+    $ make
+    $ make install
+    $ psql -e -f /usr/local/pgsql/share/contrib/pageinspect.sql test
+
+2. Functions included:
+
+    get_raw_page
+    ------------
+    get_raw_page reads one block of the named table and returns a copy as a
+    bytea field. This allows a single time-consistent copy of the block to be
+    made. Use of this functions is restricted to superusers.
+
+    page_header
+    -----------
+    page_header shows fields which are common to all PostgreSQL heap and index
+    pages. Use of this function is restricted to superusers.
+
+    A page image obtained with get_raw_page should be passed as argument:
+
+        test=# SELECT * FROM page_header(get_raw_page('pg_class',0));
+           lsn    | tli | flags | lower | upper | special | pagesize | version
+        ----------+-----+-------+-------+-------+---------+----------+---------
+         0/3C5614 |   1 |     1 |   216 |   256 |    8192 |     8192 |       4
+        (1 row)
+
+    The returned columns correspond to the fields in the PageHeaderData-struct,
+    see src/include/storage/bufpage.h for more details.
+
+    heap_page_items
+    ---------------
+    heap_page_items shows all line pointers on a heap page.  For those line
+    pointers that are in use, tuple headers are also shown. All tuples are
+    shown, whether or not the tuples were visible to an MVCC snapshot at the
+    time the raw page was copied. Use of this function is restricted to
+    superusers.
+
+    A heap page image obtained with get_raw_page should be passed as argument:
+
+        test=# SELECT * FROM heap_page_items(get_raw_page('pg_class',0));
+
+    See src/include/storage/itemid.h and src/include/access/htup.h for
+    explanations of the fields returned.
+
+    bt_metap
+    --------
+    bt_metap() returns information about the btree index metapage:
+
+        test=> SELECT * FROM bt_metap('pg_cast_oid_index');
+        -[ RECORD 1 ]-----
+        magic     | 340322
+        version   | 2
+        root      | 1
+        level     | 0
+        fastroot  | 1
+        fastlevel | 0
+
+    bt_page_stats
+    -------------
+    bt_page_stats() shows information about single btree pages:
+
+        test=> SELECT * FROM bt_page_stats('pg_cast_oid_index', 1);
+        -[ RECORD 1 ]-+-----
+        blkno         | 1
+        type          | l
+        live_items    | 256
+        dead_items    | 0
+        avg_item_size | 12
+        page_size     | 8192
+        free_size     | 4056
+        btpo_prev     | 0
+        btpo_next     | 0
+        btpo          | 0
+        btpo_flags    | 3
+
+    bt_page_items
+    -------------
+    bt_page_items() returns information about specific items on btree pages:
+
+        test=> SELECT * FROM bt_page_items('pg_cast_oid_index', 1);
+         itemoffset |  ctid   | itemlen | nulls | vars |    data
+        ------------+---------+---------+-------+------+-------------
+                  1 | (0,1)   |      12 | f     | f    | 23 27 00 00
+                  2 | (0,2)   |      12 | f     | f    | 24 27 00 00
+                  3 | (0,3)   |      12 | f     | f    | 25 27 00 00
+                  4 | (0,4)   |      12 | f     | f    | 26 27 00 00
+                  5 | (0,5)   |      12 | f     | f    | 27 27 00 00
+                  6 | (0,6)   |      12 | f     | f    | 28 27 00 00
+                  7 | (0,7)   |      12 | f     | f    | 29 27 00 00
+                  8 | (0,8)   |      12 | f     | f    | 2a 27 00 00

contrib/pageinspect/heapfuncs.c

+/*-------------------------------------------------------------------------
+ *
+ * heapfuncs.c
+ *	  Functions to investigate heap pages
+ *
+ * We check the input to these functions for corrupt pointers etc. that
+ * might cause crashes, but at the same time we try to print out as much
+ * information as possible, even if it's nonsense. That's because if a
+ * page is corrupt, we don't know why and how exactly it is corrupt, so we
+ * let the user to judge it.
+ * 
+ * These functions are restricted to superusers for the fear of introducing
+ * security holes if the input checking isn't as water-tight as it should. 
+ * You'd need to be superuser to obtain a raw page image anyway, so 
+ * there's hardly any use case for using these without superuser-rights
+ * anyway.
+ *
+ * Copyright (c) 2007, PostgreSQL Global Development Group
+ *
+ * IDENTIFICATION
+ *	  $PostgreSQL: pgsql/contrib/pageinspect/heapfuncs.c,v 1.1 2007/05/17 19:11:24 momjian Exp $
+ *
+ *-------------------------------------------------------------------------
+ */
+
+#include "postgres.h"
+
+#include "fmgr.h"
+#include "funcapi.h"
+#include "access/heapam.h"
+#include "access/transam.h"
+#include "catalog/namespace.h"
+#include "catalog/pg_type.h"
+#include "utils/builtins.h"
+#include "miscadmin.h"
+
+Datum heap_page_items(PG_FUNCTION_ARGS);
+
+#define GET_TEXT(str_) \
+        DirectFunctionCall1(textin, CStringGetDatum(str_))
+
+/*
+ * bits_to_text
+ *
+ * Converts a bits8-array of 'len' bits to a human-readable
+ * c-string representation.
+ */
+static char *
+bits_to_text(bits8 *bits, int len)
+{
+	int i;
+	char *str;
+
+	str = palloc(len + 1);
+	
+	for(i = 0; i < len; i++)
+		str[i] = (bits[(i / 8)] & (1 << (i % 8))) ? '1' : '0';
+
+	str[i] = '\0';
+
+	return str;
+}
+
+
+/*
+ * heap_page_items
+ *
+ * Allows inspection of line pointers and tuple headers of a heap page.
+ */
+PG_FUNCTION_INFO_V1(heap_page_items);
+
+typedef struct heap_page_items_state
+{
+	TupleDesc	tupd;
+	Page		page;
+	uint16		offset;
+} heap_page_items_state;
+
+Datum
+heap_page_items(PG_FUNCTION_ARGS)
+{
+	bytea  *raw_page = PG_GETARG_BYTEA_P(0);
+	heap_page_items_state *inter_call_data = NULL;
+	FuncCallContext *fctx;
+	int		raw_page_size;
+
+	if (!superuser())
+		ereport(ERROR,
+				(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
+				 (errmsg("must be superuser to use raw page functions"))));
+
+	raw_page_size = VARSIZE(raw_page) - VARHDRSZ;
+
+	if (SRF_IS_FIRSTCALL())
+	{
+		TupleDesc	tupdesc;
+		MemoryContext mctx;
+
+		if(raw_page_size < SizeOfPageHeaderData)
+			ereport(ERROR, 
+					(errcode(ERRCODE_INVALID_PARAMETER_VALUE),
+					 errmsg("input page too small (%d bytes)", raw_page_size)));
+
+		fctx = SRF_FIRSTCALL_INIT();
+		mctx = MemoryContextSwitchTo(fctx->multi_call_memory_ctx);
+
+		inter_call_data = palloc(sizeof(heap_page_items_state));
+
+		/* Build a tuple descriptor for our result type */
+		if (get_call_result_type(fcinfo, NULL, &tupdesc) != TYPEFUNC_COMPOSITE)
+			elog(ERROR, "return type must be a row type");
+
+		inter_call_data->tupd = tupdesc;
+
+		inter_call_data->offset = FirstOffsetNumber;
+		inter_call_data->page = VARDATA(raw_page);
+
+		fctx->max_calls = PageGetMaxOffsetNumber(inter_call_data->page);
+		fctx->user_fctx = inter_call_data;
+
+		MemoryContextSwitchTo(mctx);
+	}
+
+	fctx = SRF_PERCALL_SETUP();
+	inter_call_data = fctx->user_fctx;
+
+	if (fctx->call_cntr < fctx->max_calls)
+	{
+		Page		page = inter_call_data->page;
+		HeapTuple	resultTuple;
+		Datum		result;
+		ItemId		id;
+		Datum		values[13];
+		bool		nulls[13];
+		uint16 		lp_offset;
+		uint16		lp_flags;
+		uint16		lp_len;
+
+		memset(nulls, 0, sizeof(nulls));
+
+		/* Extract information from the line pointer */
+		
+		id = PageGetItemId(page, inter_call_data->offset);
+
+		lp_offset	= ItemIdGetOffset(id);
+		lp_flags	= ItemIdGetFlags(id);
+		lp_len		= ItemIdGetLength(id);
+
+		values[0] = UInt16GetDatum(inter_call_data->offset);
+		values[1] = UInt16GetDatum(lp_offset);
+		values[2] = UInt16GetDatum(lp_flags);
+		values[3] = UInt16GetDatum(lp_len);
+
+		/* We do just enough validity checking to make sure we don't 
+		 * reference data outside the page passed to us. The page
+		 * could be corrupt in many other ways, but at least we won't 
+		 * crash.
+		 */
+		if ((lp_len >= sizeof(HeapTupleHeader)) &&
+			(lp_offset == MAXALIGN(lp_offset)) &&
+			(lp_offset + lp_len <= raw_page_size) &&
+			ItemIdIsUsed(id))
+		{
+			HeapTupleHeader	tuphdr;
+			int				bits_len;
+
+			/* Extract infromation from the tuple header */
+
+			tuphdr = (HeapTupleHeader) PageGetItem(page, id);
+		
+			values[4] = UInt32GetDatum(HeapTupleHeaderGetXmin(tuphdr));
+			values[5] = UInt32GetDatum(HeapTupleHeaderGetXmax(tuphdr));
+			values[6] = UInt32GetDatum(HeapTupleHeaderGetRawCommandId(tuphdr)); /* shared with xvac */
+			values[7] = PointerGetDatum(&tuphdr->t_ctid);
+			values[8] = UInt16GetDatum(tuphdr->t_infomask2);
+			values[9] = UInt16GetDatum(tuphdr->t_infomask);
+			values[10] = UInt8GetDatum(tuphdr->t_hoff);
+
+			/* We already checked that the item as is completely within
+			 * the raw page passed to us, with the length given in the line
+			 * pointer.. Let's check that t_hoff doesn't point over lp_len,
+			 * before using it to access t_bits and oid.
+			 */
+			if (tuphdr->t_hoff >= sizeof(HeapTupleHeader) && 
+				tuphdr->t_hoff <= lp_len)
+			{
+				if (tuphdr->t_infomask & HEAP_HASNULL)
+				{
+					bits_len = tuphdr->t_hoff - 
+						(((char *)tuphdr->t_bits) - ((char *)tuphdr));
+
+					values[11] = GET_TEXT(
+						bits_to_text(tuphdr->t_bits, bits_len * 8));
+				} 
+				else
+					nulls[11] = true;
+
+				if (tuphdr->t_infomask & HEAP_HASOID)
+					values[12] = HeapTupleHeaderGetOid(tuphdr);
+				else
+					nulls[12] = true;
+			}
+			else
+			{
+				nulls[11] = true;
+				nulls[12] = true;
+			}
+		}
+		else
+		{
+			/* The line pointer is not used, or it's invalid. Set the rest of
+			 * the fields to NULL */
+			int i;
+
+			for(i = 4; i <= 12; i++)
+				nulls[i] = true;
+		}
+
+        /* Build and return the result tuple. */
+        resultTuple = heap_form_tuple(inter_call_data->tupd, values, nulls);
+        result = HeapTupleGetDatum(resultTuple);
+
+		inter_call_data->offset++;
+
+		SRF_RETURN_NEXT(fctx, result);
+	}
+	else
+		SRF_RETURN_DONE(fctx);
+}

contrib/pageinspect/pageinspect.sql.in

+-- Adjust this setting to control where the objects get created.
+SET search_path = public;
+
+--
+-- get_raw_page()
+--
+CREATE OR REPLACE FUNCTION get_raw_page(text, int4)
+RETURNS bytea
+AS 'MODULE_PATHNAME', 'get_raw_page'
+LANGUAGE C STRICT;
+
+--
+-- page_header()
+--
+CREATE TYPE page_header_type AS (
+	lsn text,
+	tli smallint,
+	flags smallint,
+	lower smallint,
+	upper smallint,
+	special smallint,
+	pagesize smallint,
+	version smallint
+);
+
+CREATE OR REPLACE FUNCTION page_header(bytea)
+RETURNS page_header_type
+AS 'MODULE_PATHNAME', 'page_header'
+LANGUAGE C STRICT;
+
+--
+-- heap_page_items()
+--
+CREATE TYPE heap_page_items_type AS (
+	lp smallint,
+	lp_off smallint,
+	lp_flags smallint,
+	lp_len smallint,
+	t_xmin xid,
+	t_xmax xid,
+	t_field3 int4,
+	t_ctid tid,
+	t_infomask2 smallint,
+	t_infomask smallint,
+	t_hoff smallint,
+	t_bits text,
+	t_oid oid
+);
+
+CREATE OR REPLACE FUNCTION heap_page_items(bytea)
+RETURNS SETOF heap_page_items_type
+AS 'MODULE_PATHNAME', 'heap_page_items'
+LANGUAGE C STRICT;
+
+--
+-- bt_metap()
+--
+CREATE TYPE bt_metap_type AS (
+  magic int4,
+  version int4,
+  root int4,
+  level int4,
+  fastroot int4,
+  fastlevel int4
+);
+
+CREATE OR REPLACE FUNCTION bt_metap(text)
+RETURNS bt_metap_type
+AS 'MODULE_PATHNAME', 'bt_metap'
+LANGUAGE 'C' STRICT;
+
+--
+-- bt_page_stats()
+--
+CREATE TYPE bt_page_stats_type AS (
+  blkno int4,
+  type char,
+  live_items int4,
+  dead_items int4,
+  avg_item_size float,
+  page_size int4,
+  free_size int4,
+  btpo_prev int4,
+  btpo_next int4,
+  btpo int4,
+  btpo_flags int4
+);
+
+CREATE OR REPLACE FUNCTION bt_page_stats(text, int4)
+RETURNS bt_page_stats_type
+AS 'MODULE_PATHNAME', 'bt_page_stats'
+LANGUAGE 'C' STRICT;
+
+--
+-- bt_page_items()
+--
+CREATE TYPE bt_page_items_type AS (
+  itemoffset smallint,
+  ctid tid,
+  itemlen smallint,
+  nulls bool,
+  vars bool,
+  data text
+);
+
+CREATE OR REPLACE FUNCTION bt_page_items(text, int4)
+RETURNS SETOF bt_page_items_type
+AS 'MODULE_PATHNAME', 'bt_page_items'
+LANGUAGE 'C' STRICT;

contrib/pageinspect/rawpage.c

+/*-------------------------------------------------------------------------
+ *
+ * rawpage.c
+ *	  Functions to extract a raw page as bytea and inspect it
+ *
+ * Access-method specific inspection functions are in separate files.
+ *
+ * Copyright (c) 2007, PostgreSQL Global Development Group
+ *
+ * IDENTIFICATION
+ *	  $PostgreSQL: pgsql/contrib/pageinspect/rawpage.c,v 1.1 2007/05/17 19:11:24 momjian Exp $
+ *
+ *-------------------------------------------------------------------------
+ */
+
+#include "postgres.h"
+
+#include "fmgr.h"
+#include "funcapi.h"
+#include "access/heapam.h"
+#include "access/transam.h"
+#include "catalog/namespace.h"
+#include "catalog/pg_type.h"
+#include "utils/builtins.h"
+#include "miscadmin.h"
+
+PG_MODULE_MAGIC;
+
+Datum get_raw_page(PG_FUNCTION_ARGS);
+Datum page_header(PG_FUNCTION_ARGS);
+
+/*
+ * get_raw_page
+ *
+ * Returns a copy of a page from shared buffers as a bytea
+ */
+PG_FUNCTION_INFO_V1(get_raw_page);
+
+Datum
+get_raw_page(PG_FUNCTION_ARGS)
+{
+	text	   *relname = PG_GETARG_TEXT_P(0);
+	uint32		blkno = PG_GETARG_UINT32(1);
+
+	Relation	rel;
+	RangeVar	*relrv;
+	bytea		*raw_page;
+	char		*raw_page_data;
+	Buffer		buf;
+
+	if (!superuser())
+		ereport(ERROR,
+				(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
+				 (errmsg("must be superuser to use raw functions"))));
+
+	relrv = makeRangeVarFromNameList(textToQualifiedNameList(relname));
+	rel = relation_openrv(relrv, AccessShareLock);
+
+	/* Check that this relation has storage */
+	if (rel->rd_rel->relkind == RELKIND_VIEW)
+		ereport(ERROR,
+				(errcode(ERRCODE_WRONG_OBJECT_TYPE),
+				 errmsg("cannot get raw page from view \"%s\"",
+							RelationGetRelationName(rel))));
+	if (rel->rd_rel->relkind == RELKIND_COMPOSITE_TYPE)
+		ereport(ERROR,
+				(errcode(ERRCODE_WRONG_OBJECT_TYPE),
+				 errmsg("cannot get raw page from composite type \"%s\"",
+							RelationGetRelationName(rel))));
+
+	if (blkno >= RelationGetNumberOfBlocks(rel))
+		elog(ERROR, "block number %u is out of range for relation \"%s\"",
+			 blkno, RelationGetRelationName(rel));
+
+	/* Initialize buffer to copy to */
+	raw_page = (bytea *) palloc(BLCKSZ + VARHDRSZ);
+	SET_VARSIZE(raw_page, BLCKSZ + VARHDRSZ);
+	raw_page_data = VARDATA(raw_page);
+
+	/* Take a verbatim copy of the page */
+
+	buf = ReadBuffer(rel, blkno);
+	LockBuffer(buf, BUFFER_LOCK_SHARE);
+
+	memcpy(raw_page_data, BufferGetPage(buf), BLCKSZ);
+
+	LockBuffer(buf, BUFFER_LOCK_UNLOCK);
+	ReleaseBuffer(buf);
+
+	relation_close(rel, AccessShareLock);
+
+	PG_RETURN_BYTEA_P(raw_page);
+}
+
+/*
+ * page_header
+ *
+ * Allows inspection of page header fields of a raw page
+ */
+
+PG_FUNCTION_INFO_V1(page_header);
+
+Datum
+page_header(PG_FUNCTION_ARGS)
+{
+	bytea	   *raw_page = PG_GETARG_BYTEA_P(0);
+	int			raw_page_size;
+
+	TupleDesc	tupdesc;
+
+	Datum		result;
+	HeapTuple	tuple;
+	Datum		values[8];
+	bool		nulls[8];
+
+	PageHeader	page;
+	XLogRecPtr	lsn;
+	char		lsnchar[64];
+
+	if (!superuser())
+		ereport(ERROR,
+				(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE),
+				 (errmsg("must be superuser to use raw page functions"))));
+
+	raw_page_size = VARSIZE(raw_page) - VARHDRSZ;
+
+	/*
+	 * Check that enough data was supplied, so that we don't try to access 
+	 * fields outside the supplied buffer. 
+	 */
+	if(raw_page_size < sizeof(PageHeaderData))
+		ereport(ERROR, 
+			 (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
+			  errmsg("input page too small (%d bytes)", raw_page_size)));
+
+	page = (PageHeader) VARDATA(raw_page);
+
+	/* Build a tuple descriptor for our result type */
+	if (get_call_result_type(fcinfo, NULL, &tupdesc) != TYPEFUNC_COMPOSITE)
+		elog(ERROR, "return type must be a row type");
+
+	/* Extract information from the page header */
+
+	lsn = PageGetLSN(page);
+	snprintf(lsnchar, sizeof(lsnchar), "%X/%X", lsn.xlogid, lsn.xrecoff);
+
+	values[0] = DirectFunctionCall1(textin, CStringGetDatum(lsnchar));
+	values[1] = UInt16GetDatum(PageGetTLI(page));
+	values[2] = UInt16GetDatum(page->pd_flags);
+	values[3] = UInt16GetDatum(page->pd_lower);
+	values[4] = UInt16GetDatum(page->pd_upper);
+	values[5] = UInt16GetDatum(page->pd_special);
+	values[6] = UInt16GetDatum(PageGetPageSize(page));
+	values[7] = UInt16GetDatum(PageGetPageLayoutVersion(page));
+
+    /* Build and return the tuple. */
+
+	memset(nulls, 0, sizeof(nulls));
+
+    tuple = heap_form_tuple(tupdesc, values, nulls);
+    result = HeapTupleGetDatum(tuple);
+
+	PG_RETURN_DATUM(result);
+}

contrib/pageinspect/uninstall_pageinspect.sql

+-- Adjust this setting to control where the objects get created.
+SET search_path = public;
+
+DROP FUNCTION get_raw_page(text, int4);
+
+DROP FUNCTION page_header(bytea);
+DROP TYPE page_header_type;
+
+DROP FUNCTION heap_page_items(bytea);
+DROP TYPE heap_page_items_type;
+
+DROP FUNCTION bt_metap(text);
+DROP TYPE bt_metap_type;
+
+DROP FUNCTION bt_page_stats(text, int4);
+DROP TYPE bt_page_stats_type;
+
+DROP FUNCTION bt_page_items(text, int4);
+DROP TYPE bt_page_items_type;
+

contrib/pgstattuple/README.pgstattuple

@@ -56,53 +56,6 @@ pgstattuple README			2002/08/29 Tatsuo Ishii
         avg_leaf_density   | 50.27
         leaf_fragmentation | 0
 
-    bt_metap
-    --------
-    bt_metap() returns information about the btree index metapage:
-
-        test=> SELECT * FROM bt_metap('pg_cast_oid_index');
-        -[ RECORD 1 ]-----
-        magic     | 340322
-        version   | 2
-        root      | 1
-        level     | 0
-        fastroot  | 1
-        fastlevel | 0
-
-    bt_page_stats
-    -------------
-    bt_page_stats() shows information about single btree pages:
-
-        test=> SELECT * FROM bt_page_stats('pg_cast_oid_index', 1);
-        -[ RECORD 1 ]-+-----
-        blkno         | 1
-        type          | l
-        live_items    | 256
-        dead_items    | 0
-        avg_item_size | 12
-        page_size     | 8192
-        free_size     | 4056
-        btpo_prev     | 0
-        btpo_next     | 0
-        btpo          | 0
-        btpo_flags    | 3
-
-    bt_page_items
-    -------------
-    bt_page_items() returns information about specific items on btree pages:
-
-        test=> SELECT * FROM bt_page_items('pg_cast_oid_index', 1);
-         itemoffset |  ctid   | itemlen | nulls | vars |    data
-        ------------+---------+---------+-------+------+-------------
-                  1 | (0,1)   |      12 | f     | f    | 23 27 00 00
-                  2 | (0,2)   |      12 | f     | f    | 24 27 00 00
-                  3 | (0,3)   |      12 | f     | f    | 25 27 00 00
-                  4 | (0,4)   |      12 | f     | f    | 26 27 00 00
-                  5 | (0,5)   |      12 | f     | f    | 27 27 00 00
-                  6 | (0,6)   |      12 | f     | f    | 28 27 00 00
-                  7 | (0,7)   |      12 | f     | f    | 29 27 00 00
-                  8 | (0,8)   |      12 | f     | f    | 2a 27 00 00
-
 
 2. Installing pgstattuple
 
@@ -140,6 +93,10 @@ pgstattuple README			2002/08/29 Tatsuo Ishii
 
 5. History
 
+    2007/05/17
+
+	Moved page-level functions to contrib/pageinspect
+
     2006/06/28
 
 	Extended to work against indexes.

contrib/pgstattuple/pgstattuple.sql.in

@@ -44,62 +44,6 @@ RETURNS pgstatindex_type
 AS 'MODULE_PATHNAME', 'pgstatindex'
 LANGUAGE 'C' STRICT;
 
---
--- bt_metap()
---
-CREATE TYPE bt_metap_type AS (
-  magic int4,
-  version int4,
-  root int4,
-  level int4,
-  fastroot int4,
-  fastlevel int4
-);
-
-CREATE OR REPLACE FUNCTION bt_metap(text)
-RETURNS bt_metap_type
-AS 'MODULE_PATHNAME', 'bt_metap'
-LANGUAGE 'C' STRICT;
-
---
--- bt_page_stats()
---
-CREATE TYPE bt_page_stats_type AS (
-  blkno int4,
-  type char,
-  live_items int4,
-  dead_items int4,
-  avg_item_size float,
-  page_size int4,
-  free_size int4,
-  btpo_prev int4,
-  btpo_next int4,
-  btpo int4,
-  btpo_flags int4
-);
-
-CREATE OR REPLACE FUNCTION bt_page_stats(text, int4)
-RETURNS bt_page_stats_type
-AS 'MODULE_PATHNAME', 'bt_page_stats'
-LANGUAGE 'C' STRICT;
-
---
--- bt_page_items()
---
-CREATE TYPE bt_page_items_type AS (
-  itemoffset int4,
-  ctid tid,
-  itemlen int4,
-  nulls bool,
-  vars bool,
-  data text
-);
-
-CREATE OR REPLACE FUNCTION bt_page_items(text, int4)
-RETURNS SETOF bt_page_items_type
-AS 'MODULE_PATHNAME', 'bt_page_items'
-LANGUAGE 'C' STRICT;
-
 --
 -- pg_relpages()
 --

contrib/pgstattuple/uninstall_pgstattuple.sql

@@ -8,13 +8,4 @@ DROP TYPE pgstattuple_type;
 DROP FUNCTION pgstatindex(text);
 DROP TYPE pgstatindex_type;
 
-DROP FUNCTION bt_metap(text);
-DROP TYPE bt_metap_type;
-
-DROP FUNCTION bt_page_stats(text, int4);
-DROP TYPE bt_page_stats_type;
-
-DROP FUNCTION bt_page_items(text, int4);
-DROP TYPE bt_page_items_type;
-
 DROP FUNCTION pg_relpages(text);