Incorrect description of xmax and xip in functions docs

From: Simon Riggs <simon(at)2ndQuadrant(dot)com>
To: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Incorrect description of xmax and xip in functions docs
Date: 2008-09-05 15:14:22
Message-ID: 1220627662.4371.1203.camel@ebony.2ndQuadrant
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs


http://developer.postgresql.org/pgdocs/postgres/functions-info.html

xip_list is described as

"Active txids at the time of the snapshot... "

This is incorrect. The xip_list is the list of transactions that are in
progress *and* less than xmax. There may be transactions in progress
with an xid higher than xmax. This will happen frequently in fact. This
is because xmax is defined as the highest/latest completed xid, not the
highest running xid.

Note that there is no way to discover the list of running xids at the
time of the snapshot, from the data we hold about snapshots. Nor can the
snapshot data be used to monitor the number of transactions in progress.

Anyone disagree? If not, I'll patch.

--
Simon Riggs www.2ndQuadrant.com
PostgreSQL Training, Services and Support

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Simon Riggs 2008-09-05 15:31:42 Re: Incorrect description of xmax and xip in functions docs
Previous Message Alvaro Herrera 2008-09-03 16:59:42 Re: Backslash Escape Sequences