Fix VACUUM sgml markup.

Patch to mention cost-based delay in vacuum reference

Alvaro Herrera

Add GUC variables to control keep-alive times for idle, interval, and
count.

Oliver Jowett

Please find attached diffs for documentation and simple regression
tests for the new interval->day changes. I added tests for
justify_hours() and justify_days() to interval.sql, as they take
interval input and produce interval output. If there's a more
appropriate place for them, please let me know.

Michael Glaesemann

Fix compile for no O_SYNC, but introduced with O_DIRECT.

Add constraint exclusion items:
<
> * Allow EXPLAIN to identify tables that were skipped because of
>   enable_constraint_exclusion
> * Allow EXPLAIN output to be more easily processed by scripts
760a763
> * Allow enable_constraint_exclusion to work for UPDATE and DELETE queries

Add:

<
> * Allow enable_constraint_exclusion to work for UNIONs like it does for
>   inheritance

Add:

> * Prevent inherited tables from expanding temporary subtables of other
>   sessions

Update AIX FAQ.

Chris Browne

Add:

> * Add system view to show free space map contents
884c885
<  o Move into the backend code
>  o -Move into the backend code

Add:

> * Allow SELECT ... FOR UPDATE on inherited tables

Clarify:

< * Add TRUNCATE permission
> * Add a separate TRUNCATE permission

Add:

> * Add TRUNCATE permission
>
>   Currently only the owner can TRUNCATE a table because triggers are not
>   called, and the table is locked in exclusive mode.
>

SUNOS4_CC -> SUNOS_CC.

Add:

> * Add PQescapeIdentifier() to libpq

Fix an oversight I introduced on 2003-12-28: find_nots/push_nots should
continue to recurse after eliminating a NOT-below-a-NOT, since the
contained subexpression will now be part of the top-level AND/OR structure
and so deserves to be simplified.  The real-world impact of this is
probably minimal, since it'd require at least three levels of NOT to make
a difference, but it's still a bug.
Also remove some redundant tests for NULL subexpressions.

Remove contrib version of pg_autovacuum --- superseded by integrated
version.

Clean up a number of autovacuum loose ends.  Make the stats collector
track shared relations in a separate hashtable, so that operations done
from different databases are counted correctly.  Add proper support for
anti-XID-wraparound vacuuming, even in databases that are never connected
to and so have no stats entries.  Miscellaneous other bug fixes.
Alvaro Herrera, some additional fixes by Tom Lane.

It appears we need -DSUNOS4_CC for both solaris and sunos4 templates.
Per report from Andrew Clark.

Add detail:
>
>     If CRC check fails during recovery, remember the page in case
>     a later CRC for that page properly matches.
>

Move reindexdb from /contrib to /bin.

Euler Taveira de Oliveira

Update catversion for dbsize changes.

Remove dbsize mention.

Move dbsize functions into the backend.  New functions:

pg_tablespace_size
pg_database_size
pg_relation_size
pg_complete_relation_size
pg_size_pretty

Remove /contrib/dbsize.

Dave Page

Add mp3 entry to FAQ.

I've had this small patch in my local tree for a while.  It documents
new commands which may make an SPI call fail.

Alvaro Herrera

Fix typo.

uniware

Update O_DIRECT comment.

Done:

< * Consider use of open/fcntl(O_DIRECT) to minimize OS caching,
<   especially for WAL writes
> * -Consider use of open/fcntl(O_DIRECT) to minimize OS caching,
>   for WAL writes

Use O_DIRECT if available when using O_SYNC for wal_sync_method.

Also, write multiple WAL buffers out in one write() operation.

ITAGAKI Takahiro

---------------------------------------------------------------------------

> If we disable writeback-cache and use open_sync, the per-page writing
> behavior in WAL module will show up as bad result. O_DIRECT is similar
> to O_DSYNC (at least on linux), so that the benefit of it will disappear
> behind the slow disk revolution.
>
> In the current source, WAL is written as:
>     for (i = 0; i < N; i++) { write(&buffers[i], BLCKSZ); }
> Is this intentional? Can we rewrite it as follows?
>    write(&buffers[0], N * BLCKSZ);
>
> In order to achieve it, I wrote a 'gather-write' patch (xlog.gw.diff).
> Aside from this, I'll also send the fixed direct io patch (xlog.dio.diff).
> These two patches are independent, so they can be applied either or both.
>
>
> I tested them on my machine and the results as follows. It shows that
> direct-io and gather-write is the best choice when writeback-cache is off.
> Are these two patches worth trying if they are used together?
>
>
>             | writeback | fsync= | fdata | open_ | fsync_ | open_
> patch       | cache     |  false |  sync |  sync | direct | direct
> ------------+-----------+--------+-------+-------+--------+---------
> direct io   | off       |  124.2 | 105.7 |  48.3 |   48.3 |  48.2
> direct io   | on        |  129.1 | 112.3 | 114.1 |  142.9 | 144.5
> gather-write| off       |  124.3 | 108.7 | 105.4 |  (N/A) | (N/A)
> both        | off       |  131.5 | 115.5 | 114.4 |  145.4 | 145.2
>
> - 20runs * pgbench -s 100 -c 50 -t 200
>    - with tuning (wal_buffers=64, commit_delay=500, checkpoint_segments=8)
> - using 2 ATA disks:
>    - hda(reiserfs) includes system and wal.
>    - hdc(jfs) includes database files. writeback-cache is always on.
>
> ---
> ITAGAKI Takahiro

Thank you for applying patch --- regexp_replace.

An attached patch is a small additional improvement.

This patch use appendStringInfoText instead of appendStringInfoString.
There is an overhead of PG_TEXT_GET_STR when appendStringInfoString is
executed by text type. This can be reduced by appendStringInfoText.

Atsushi Ogawa

Make use of new list primitives list_append_unique and list_concat_unique
where applicable.

Add tab completion syntax for PREPARE 2-phase commit syntax.

There's no tab-completion for "PREPARE TRANSACTION 'xxx'" since that
would be ambigous with "PREPARE xxx AS xx".

Heikki Linnakangas

Fix a bunch of bad interactions between partial indexes and the new
planning logic for bitmap indexscans.  Partial indexes create corner
cases in which a scan might be done with no explicit index qual conditions,
and the code wasn't handling those cases nicely.  Also be a little
tenser about eliminating redundant clauses in the generated plan.
Per report from Dmitry Karasik.

Code cleanup.

Refactor exec_cast_value() and exec_simple_cast_value(): since they do
not ever write through the `isnull' parameter, it does not need to be
an out parameter. Therefore it can be declared a "bool" rather than a
"bool *".

Mark a static array "const" to move a few bytes from the "data" segment
to the "text" segment. It would be possible to mark the elements of the
array "const" as well, but this would require multiple API changes and
does not seem to be worth the notational inconvenience.

Remove no-longer-needed hack to add pgsleep.c to regress.so.

Put libpgport into OBJS instead of LIBS, so that it gets included
into .def and .exp files automatically on Windows, AIX, and the like.
An additional benefit is that changes in libpgport files correctly
propagate to force rebuild of the backend executable.  This is my
reworking of Rocco Altier's idea, and if it breaks anything it's
definitely my fault.

Fix a whole bunch of #includes that were either wrong or redundant.
The first rule of portability for us is 'thou shalt have no other gods
before c.h', and a whole lot of these files were either not including
c.h at all, or including random system headers beforehand, either of
which sins can mess up largefile support nicely.  Once you have
included c.h, there is no need to re-include what it includes, either.

Remove some long-dead support for libpgtcl with Tk.

Fix breakage introduced in plpgsql CONTINUE patch.
Per Kevin McArthur.

Add some missing SGML markup.

Fix a few macro definitions to ensure that unary minus is enclosed in
parentheses. This avoids possible operator precedence problems, and
is consistent with most of the macro definitions in the tree.

Remove MMCacheLock -- it is no longer used. Per ITAGAKI Takahiro.

Avoid crashing pg_dump if we can't connect to the database server, and
no database has been explicitly specified. Per gripe from Omar Kilani.

Basic documentation for ROLEs.  The user-manag chapter still needs to
be rewritten, but at least the reference pages are reasonably sane.

Minor correction: cause ALTER ROLE role ROLE rolenames to behave
sensibly, even though we don't document it.

Add a role property 'rolinherit' which, when false, denotes that the role
doesn't automatically inherit the privileges of roles it is a member of;
for such a role, membership in another role can be exploited only by doing
explicit SET ROLE.  The default inherit setting is TRUE, so by default
the behavior doesn't change, but creating a user with NOINHERIT gives closer
adherence to our current reading of SQL99.  Documentation still lacking,
and I think the information schema needs another look.

Add pg_has_role() family of privilege inquiry functions modeled after the
existing ones for object privileges.  Update the information_schema for
roles --- pg_has_role() makes this a whole lot easier, removing the need
for most of the explicit joins with pg_user.  The views should be a tad
faster now, too.  Stephen Frost and Tom Lane.

Add SET ROLE.  This is a partial commit of Stephen Frost's recent patch;
I'm still working on the has_role function and information_schema changes.

Add username for psql password prompt, if the username was specified.

Adrian Maier

Add:

>  o Allow postgresql.conf file values to be changed via an SQL API
>  o Allow the server to be stopped/restarted via an SQL API

Awhile back we replaced all uses of strcasecmp and strncasecmp with
pg_strcasecmp and pg_strncasecmp ... but I see some of the former have
crept back in.
Eternal vigilance is the price of locale independence, apparently.

Change build of regress.so to use Makefile.shlib instead of depending
on the not-very-good .so pattern rules in the port-specific Makefiles.
(This leaves only pgxs' MODULES case needing those rules.)  Also,
compile pgsleep.c locally and add it to regress.so to avoid failure
on AIX.

Partial fixes for contrib build on AIX: include -lm where needed.
Per Rocco Altier.

Regenerate badly-obsolete README file.

With the interval/day patch, the horology regression test no longer
fails near DST transition days, so remove the advice about that testing
problem.  Also improve the description of variant-comparison-file
selection.

Add variant expected file to cope with different spelling of a Python
error message in Python 2.3 and before.  Per Michael Fuhr and buildfarm
results.

Fix rounding problem in interval_div by using rint(), and improve
interval_mul function.

Fix logic error in tbm_intersect: the intersection of a normal page and
a lossy page has to be lossy, because we don't know exactly which tuples
on the page should remain part of the bitmap.  Per Jie Zhang.

Fix some failures to initialize table entries induced by recent autovacuum
integration.  Not clear this explains recent stats problems, but it's
definitely wrong.

Simple constraint exclusion.  For now, only child tables of inheritance
scans are candidates for exclusion; this should be fixed eventually.
Simon Riggs, with some help from Tom Lane.

Remove unintended code addition.

Macro alignment cleanup.

Improve computations of interval_div to prevent rounding problem on AIX.

Andrew pointed out that the current fix didn't handle dates that were
near daylight savings time boudaries.  This handles it properly, e.g.

        test=> select '2005-04-03 04:00:00'::timestamp at time zone
        'America/Los_Angeles';
                timezone
        ------------------------
         2005-04-03 07:00:00-04
        (1 row)

In the stats test, delay for the stats collector to catch up using a
function that actually sleeps, instead of busy-waiting.  Perhaps this
will resolve some of the intermittent stats failures we keep seeing.

Fix AT TIME ZONE for timestamps without time zones:

test=> select (CURRENT_DATE + '05:00'::time)::timestamp at time zone
'Canada/Pacific';
        timezone
------------------------
 2005-07-22 08:00:00-04
(1 row)

Fix AT TIME ZONE for timestamps without time zones:

test=> select ('2005-07-20 00:00:00'::timestamp without time zone) at
time zone 'Europe/Paris';
        timezone
------------------------
 2005-07-19 22:00:00-04

Udpate documentation.

Fix insufficient check for overflow in tm2abstime(), per report from jw.

Fix compare_fuzzy_path_costs() to behave a bit more sanely.  The original
coding would ignore startup cost differences of less than 1% of the
estimated total cost; which was OK for normal planning but highly not OK
if a very small LIMIT was applied afterwards, so that startup cost becomes
the name of the game.  Instead, compare startup and total costs fuzzily
but independently.  This changes the plan selected for two queries in the
regression tests; adjust expected-output files for resulting changes in
row order.  Per reports from Dawid Kuroczko and Sam Mason.

More removal of unneeded parentheses.

More spacing adjustments

Update date/time comments.

More minor spacing improvements.

Code spacing improvement, particularly *tm spacing.

More comment update of time macros.

Update DAYS_PER_MONTH comment.

Add SECS_PER_YEAR and MINS_PER_HOUR macros.

Add comment about void* use in MemSet.

Add:

<
> * Research storing disk pages with no alignment/padding

Fix integer timestamp build for macro changes.

Add comment marking non-exact time conversion macros.

Remove unnecessary parentheses in assignments.
Add spaces where needed.
Reference time interval variables as tinterval.

Fix storage size for btree_gist interval indexes.  Fix penalty
calculations for interval and time/timetz to behave sanely for both
integer and float timestamps; up to now I think it's been doing
something pretty strange...

Add time/date macros for code clarity:

#define DAYS_PER_YEAR   365.25
#define MONTHS_PER_YEAR 12
#define DAYS_PER_MONTH  30
#define HOURS_PER_DAY   24

Fix breakage of INSTALL document build.

/contrib/btree_gist adjustments for new 'day' interval value.

Update catalog version for INTERVAL day addition.

Add 'day' field to INTERVAL so 1 day interval can be distinguished from
24 hours. This is very helpful for daylight savings time:

select '2005-05-03 00:00:00 EST'::timestamp with time zone + '24 hours';
      ?column?
----------------------
2005-05-04 01:00:00-04

select '2005-05-03 00:00:00 EST'::timestamp with time zone + '1 day';
      ?column?
----------------------
2005-05-04 01:00:00-04

Michael Glaesemann

Fix interval division and multiplication, before:

test=> select '4 months'::interval / 5;
   ?column?
---------------
 1 mon -6 days
(1 row)

after:

test=> select '4 months'::interval / 5;
 ?column?
----------
 24 days
(1 row)

The problem was the use of rint() to round, and then find the remainder,
causing the negative values.

Documentation tweak: make <command>CREATE OPERATOR CLASS</command> into
an <xref/>.

Fix some bogosities in geometric-function documentation: add an entry
for circle(polygon), which was missing; remove bogus entry for
point(lseg, lseg), which does not exist, and the documentation seemed to
describe lseg_interpt, which we already document as an operator not a
function.  Also remove entry for box_intersect, which likewise is
preferentially used via the operator #.

\pset numericsep -> numericlocale.

Fix len so decimal length is only added when a period appears in the output.

Avoid use of E'', and thereby creating an unnecessary version-dependency,
by using LIKE...ESCAPE instead.  Per suggestion by andrew@supernews.

Avoid need for E'' construct by using regexp instead of LIKE.  More
readable, and more like the other places in this file.

Fix numiericsep length computations.

Eugen Nedelcu

Adjust psql describe queries so that any pg_foo_is_visible() condition
is applied last, after other constraints such as name patterns.  This
is useful first because the pg_foo_is_visible() functions are relatively
expensive, and second because it minimizes the prospects for race
conditions.  The change is fragile though since it makes unwarranted
assumptions about planner behavior, ie, that WHERE clauses will be
executed in the original order if there's not reason to change it.
This should fix ... or at least hide ... an intermittent failure in the
prepared_xacts regression test, while we think about what else to do.

pgcrypto documentation update.  Marko Kreen