~ubuntu-branches/ubuntu/quantal/postgresql-9.1/quantal-updates

« back to all changes in this revision

Viewing changes to doc/src/sgml/html/error-style-guide.html

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2012-06-04 06:47:45 UTC
  • mfrom: (1.1.8)
  • Revision ID: package-import@ubuntu.com-20120604064745-dvs00jnur0vgkwqs
Tags: 9.1.4-1
* Urgency medium due to security fixes.
* New upstream bug fix/security release:
  - Fix incorrect password transformation in "contrib/pgcrypto"'s DES
    crypt() function.
    If a password string contained the byte value 0x80, the remainder
    of the password was ignored, causing the password to be much weaker
    than it appeared. With this fix, the rest of the string is properly
    included in the DES hash. Any stored password values that are
    affected by this bug will thus no longer match, so the stored
    values may need to be updated. (CVE-2012-2143)
  - Ignore SECURITY DEFINER and SET attributes for a procedural
    language's call handler. Applying such attributes to a call handler
    could crash the server. (CVE-2012-2655)
  - Make "contrib/citext"'s upgrade script fix collations of citext
    arrays and domains over citext.
    Release 9.1.2 provided a fix for collations of citext columns and
    indexes in databases upgraded or reloaded from pre-9.1
    installations, but that fix was incomplete: it neglected to handle
    arrays and domains over citext. This release extends the module's
    upgrade script to handle these cases. As before, if you have
    already run the upgrade script, you'll need to run the collation
    update commands by hand instead. See the 9.1.2 release notes for
    more information about doing this.
  - Allow numeric timezone offsets in timestamp input to be up to 16
    hours away from UTC. Some historical time zones have offsets larger than
    15 hours, the previous limit. This could result in dumped data values
    being rejected during reload.
  - Fix timestamp conversion to cope when the given time is exactly the
    last DST transition time for the current timezone.
    This oversight has been there a long time, but was not noticed
    previously because most DST-using zones are presumed to have an
    indefinite sequence of future DST transitions.
  - Fix text to name and char to name casts to perform string
    truncation correctly in multibyte encodings.
  - Fix memory copying bug in to_tsquery().
  - Ensure txid_current() reports the correct epoch when executed in
    hot standby.
  - Fix planner's handling of outer PlaceHolderVars within subqueries.
    This bug concerns sub-SELECTs that reference variables coming from
    the nullable side of an outer join of the surrounding query. In
    9.1, queries affected by this bug would fail with "ERROR:
    Upper-level PlaceHolderVar found where not expected". But in 9.0
    and 8.4, you'd silently get possibly-wrong answers, since the value
    transmitted into the subquery wouldn't go to null when it should.
  - Fix planning of UNION ALL subqueries with output columns that are
    not simple variables.
    Planning of such cases got noticeably worse in 9.1 as a result of a
    misguided fix for "MergeAppend child's targetlist doesn't match
    MergeAppend" errors. Revert that fix and do it another way.
  - Fix slow session startup when pg_attribute is very large.
    If pg_attribute exceeds one-fourth of shared_buffers, cache
    rebuilding code that is sometimes needed during session start would
    trigger the synchronized-scan logic, causing it to take many times
    longer than normal. The problem was particularly acute if many new
    sessions were starting at once.
  - Ensure sequential scans check for query cancel reasonably often.
    A scan encountering many consecutive pages that contain no live
    tuples would not respond to interrupts meanwhile.
  - Ensure the Windows implementation of PGSemaphoreLock() clears
    ImmediateInterruptOK before returning.
    This oversight meant that a query-cancel interrupt received later
    in the same query could be accepted at an unsafe time, with
    unpredictable but not good consequences.
  - Show whole-row variables safely when printing views or rules.
    Corner cases involving ambiguous names (that is, the name could be
    either a table or column name of the query) were printed in an
    ambiguous way, risking that the view or rule would be interpreted
    differently after dump and reload. Avoid the ambiguous case by
    attaching a no-op cast.
  - Fix "COPY FROM" to properly handle null marker strings that
    correspond to invalid encoding.
    A null marker string such as E'\\0' should work, and did work in
    the past, but the case got broken in 8.4.
  - Fix "EXPLAIN VERBOSE" for writable CTEs containing RETURNING
    clauses.
  - Fix "PREPARE TRANSACTION" to work correctly in the presence of
    advisory locks.
    Historically, "PREPARE TRANSACTION" has simply ignored any
    session-level advisory locks the session holds, but this case was
    accidentally broken in 9.1.
  - Fix truncation of unlogged tables.
  - Ignore missing schemas during non-interactive assignments of
    search_path.
    This re-aligns 9.1's behavior with that of older branches.
    Previously 9.1 would throw an error for nonexistent schemas
    mentioned in search_path settings obtained from places such as
    "ALTER DATABASE SET".
  - Fix bugs with temporary or transient tables used in extension
    scripts.
    This includes cases such as a rewriting "ALTER TABLE" within an
    extension update script, since that uses a transient table behind
    the scenes.
  - Ensure autovacuum worker processes perform stack depth checking
    properly.
    Previously, infinite recursion in a function invoked by
    auto-"ANALYZE" could crash worker processes.
  - Fix logging collector to not lose log coherency under high load.
    The collector previously could fail to reassemble large messages if
    it got too busy.
  - Fix logging collector to ensure it will restart file rotation after
    receiving SIGHUP.
  - Fix "too many LWLocks taken" failure in GiST indexes.
  - Fix WAL replay logic for GIN indexes to not fail if the index was
    subsequently dropped.
  - Correctly detect SSI conflicts of prepared transactions after a
    crash.
  - Avoid synchronous replication delay when committing a transaction
    that only modified temporary tables.
    In such a case the transaction's commit record need not be flushed
    to standby servers, but some of the code didn't know that and
    waited for it to happen anyway.
  - Fix error handling in pg_basebackup.
  - Fix walsender to not go into a busy loop if connection is
    terminated.
  - Fix memory leak in PL/pgSQL's "RETURN NEXT" command.
  - Fix PL/pgSQL's "GET DIAGNOSTICS" command when the target is the
    function's first variable.
  - Ensure that PL/Perl package-qualifies the _TD variable.
    This bug caused trigger invocations to fail when they are nested
    within a function invocation that changes the current package.
  - Fix PL/Python functions returning composite types to accept a
    string for their result value.
    This case was accidentally broken by the 9.1 additions to allow a
    composite result value to be supplied in other formats, such as
    dictionaries.
  - Fix potential access off the end of memory in psql's expanded
    display ("\x") mode.
  - Fix several performance problems in pg_dump when the database
    contains many objects.
    pg_dump could get very slow if the database contained many schemas,
    or if many objects are in dependency loops, or if there are many
    owned sequences.
  - Fix memory and file descriptor leaks in pg_restore when reading a
    directory-format archive.
  - Fix pg_upgrade for the case that a database stored in a non-default
    tablespace contains a table in the cluster's default tablespace.
  - In ecpg, fix rare memory leaks and possible overwrite of one byte
    after the sqlca_t structure.
  - Fix "contrib/dblink"'s dblink_exec() to not leak temporary database
    connections upon error.
  - Fix "contrib/dblink" to report the correct connection name in error
    messages.
  - Fix "contrib/vacuumlo" to use multiple transactions when dropping
    many large objects.
    This change avoids exceeding max_locks_per_transaction when many
    objects need to be dropped. The behavior can be adjusted with the
    new -l (limit) option.
* debian/control: Bump debhelper build dependency to >= 8, as it does not
  build with earlier versions.
* debian/control: Move bzr branches to alioth, so that other members of
  pkg-postgresql can commit. Update Vcs-* tags.
* debian/control: Set Maintainer: to pkg-postgresql group, and move myself
  to Uploaders:.

Show diffs side-by-side

added added

removed removed

Lines of Context:
9
9
REV="MADE"
10
10
HREF="mailto:pgsql-docs@postgresql.org"><LINK
11
11
REL="HOME"
12
 
TITLE="PostgreSQL 9.1.3 Documentation"
 
12
TITLE="PostgreSQL 9.1.4 Documentation"
13
13
HREF="index.html"><LINK
14
14
REL="UP"
15
15
TITLE="PostgreSQL Coding Conventions"
26
26
HTTP-EQUIV="Content-Type"
27
27
CONTENT="text/html; charset=ISO-8859-1"><META
28
28
NAME="creation"
29
 
CONTENT="2012-02-23T23:09:00"></HEAD
 
29
CONTENT="2012-05-31T23:22:48"></HEAD
30
30
><BODY
31
31
CLASS="SECT1"
32
32
><DIV
44
44
VALIGN="bottom"
45
45
><A
46
46
HREF="index.html"
47
 
>PostgreSQL 9.1.3 Documentation</A
 
47
>PostgreSQL 9.1.4 Documentation</A
48
48
></TH
49
49
></TR
50
50
><TR
108
108
><H2
109
109
CLASS="SIMPLESECT"
110
110
><A
111
 
NAME="AEN93235"
 
111
NAME="AEN93259"
112
112
>47.3.1. What Goes Where</A
113
113
></H2
114
114
><P
158
158
><H2
159
159
CLASS="SIMPLESECT"
160
160
><A
161
 
NAME="AEN93244"
 
161
NAME="AEN93268"
162
162
>47.3.2. Formatting</A
163
163
></H2
164
164
><P
181
181
><H2
182
182
CLASS="SIMPLESECT"
183
183
><A
184
 
NAME="AEN93248"
 
184
NAME="AEN93272"
185
185
>47.3.3. Quotation Marks</A
186
186
></H2
187
187
><P
204
204
><H2
205
205
CLASS="SIMPLESECT"
206
206
><A
207
 
NAME="AEN93252"
 
207
NAME="AEN93276"
208
208
>47.3.4. Use of Quotes</A
209
209
></H2
210
210
><P
232
232
><H2
233
233
CLASS="SIMPLESECT"
234
234
><A
235
 
NAME="AEN93258"
 
235
NAME="AEN93282"
236
236
>47.3.5. Grammar and Punctuation</A
237
237
></H2
238
238
><P
270
270
><H2
271
271
CLASS="SIMPLESECT"
272
272
><A
273
 
NAME="AEN93265"
 
273
NAME="AEN93289"
274
274
>47.3.6. Upper Case vs. Lower Case</A
275
275
></H2
276
276
><P
288
288
><H2
289
289
CLASS="SIMPLESECT"
290
290
><A
291
 
NAME="AEN93269"
 
291
NAME="AEN93293"
292
292
>47.3.7. Avoid Passive Voice</A
293
293
></H2
294
294
><P
312
312
><H2
313
313
CLASS="SIMPLESECT"
314
314
><A
315
 
NAME="AEN93275"
 
315
NAME="AEN93299"
316
316
>47.3.8. Present vs. Past Tense</A
317
317
></H2
318
318
><P
360
360
><H2
361
361
CLASS="SIMPLESECT"
362
362
><A
363
 
NAME="AEN93285"
 
363
NAME="AEN93309"
364
364
>47.3.9. Type of the Object</A
365
365
></H2
366
366
><P
379
379
><H2
380
380
CLASS="SIMPLESECT"
381
381
><A
382
 
NAME="AEN93290"
 
382
NAME="AEN93314"
383
383
>47.3.10. Brackets</A
384
384
></H2
385
385
><P
396
396
><H2
397
397
CLASS="SIMPLESECT"
398
398
><A
399
 
NAME="AEN93294"
 
399
NAME="AEN93318"
400
400
>47.3.11. Assembling Error Messages</A
401
401
></H2
402
402
><P
420
420
><H2
421
421
CLASS="SIMPLESECT"
422
422
><A
423
 
NAME="AEN93299"
 
423
NAME="AEN93323"
424
424
>47.3.12. Reasons for Errors</A
425
425
></H2
426
426
><P
439
439
><H2
440
440
CLASS="SIMPLESECT"
441
441
><A
442
 
NAME="AEN93303"
 
442
NAME="AEN93327"
443
443
>47.3.13. Function Names</A
444
444
></H2
445
445
><P
474
474
><H2
475
475
CLASS="SIMPLESECT"
476
476
><A
477
 
NAME="AEN93310"
 
477
NAME="AEN93334"
478
478
>47.3.14. Tricky Words to Avoid</A
479
479
></H2
480
480
><DIV
619
619
><H2
620
620
CLASS="SIMPLESECT"
621
621
><A
622
 
NAME="AEN93353"
 
622
NAME="AEN93377"
623
623
>47.3.15. Proper Spelling</A
624
624
></H2
625
625
><P
664
664
><H2
665
665
CLASS="SIMPLESECT"
666
666
><A
667
 
NAME="AEN93368"
 
667
NAME="AEN93392"
668
668
>47.3.16. Localization</A
669
669
></H2
670
670
><P