summaryrefslogtreecommitdiff
path: root/doc/src
AgeCommit message (Collapse)Author
2014-03-08docs: small adjustements to recent SELECT and pg_upgrade improvementsBruce Momjian
2014-03-07pg_upgrade: document delete problems with tablespaces inside the cluster ↵Bruce Momjian
directory Per report by Marc Mamin
2014-03-07doc: improve server's keepalive descriptionBruce Momjian
Use superior libpq keepalive description for the server-level parameters. Per report by Tatsuo Ishii and Marko Tiikkaja
2014-03-07docs: improve TABLE command by showing supported clausesBruce Momjian
Initial patch by Colin 't Hart
2014-03-07release notes: add item missed in 9.2.5 releaseBruce Momjian
Item is "Prevent errors in WAL replay due to references to uninitialized empty pages". Report and text by Andres Freund Backpatch through 9.2.
2014-03-07Fix name of syslog_ident GUC in docs.Heikki Linnakangas
Michael Paquier
2014-03-05docs: to_timestamp and to_date do minimal range checkingBruce Momjian
Initial patch from Steve Crawford
2014-03-04Provide a FORCE NULL option to COPY in CSV mode.Andrew Dunstan
This forces an input field containing the quoted null string to be returned as a NULL. Without this option, only unquoted null strings behave this way. This helps where some CSV producers insist on quoting every field, whether or not it is needed. The option takes a list of fields, and only applies to those columns. There is an equivalent column-level option added to file_fdw. Ian Barwick, with some tweaking by Andrew Dunstan, reviewed by Payal Singh.
2014-03-04auto_explain: Add logging of trigger executionAlvaro Herrera
Author: Kyotaro HORIGUCHI Reviewed-by: Jaime Casanova
2014-03-04Constructors for interval, timestamp, timestamptzAlvaro Herrera
Author: Pavel Stěhule, editorialized somewhat by Álvaro Herrera Reviewed-by: Tomáš Vondra, Marko Tiikkaja With input from Fabrízio de Royes Mello, Jim Nasby
2014-03-03Introduce logical decoding.Robert Haas
This feature, building on previous commits, allows the write-ahead log stream to be decoded into a series of logical changes; that is, inserts, updates, and deletes and the transactions which contain them. It is capable of handling decoding even across changes to the schema of the effected tables. The output format is controlled by a so-called "output plugin"; an example is included. To make use of this in a real replication system, the output plugin will need to be modified to produce output in the format appropriate to that system, and to perform filtering. Currently, information can be extracted from the logical decoding system only via SQL; future commits will add the ability to stream changes via walsender. Andres Freund, with review and other contributions from many other people, including Álvaro Herrera, Abhijit Menon-Sen, Peter Gheogegan, Kevin Grittner, Robert Haas, Heikki Linnakangas, Fujii Masao, Abhijit Menon-Sen, Michael Paquier, Simon Riggs, Craig Ringer, and Steve Singer.
2014-03-03Rename huge_tlb_pages to huge_pages, and improve docs.Heikki Linnakangas
Christian Kruse
2014-03-03pg_dump et al: Add --if-exists optionAlvaro Herrera
This option makes pg_dump, pg_dumpall and pg_restore inject an IF EXISTS clause to each DROP command they emit. (In pg_dumpall, the clause is not added to individual objects drops, but rather to the CREATE DATABASE commands, as well as CREATE ROLE and CREATE TABLESPACE.) This allows for a better user dump experience when using --clean in case some objects do not already exist. Per bug #7873 by Dave Rolsky. Author: Pavel Stěhule Reviewed-by: Jeevan Chalke, Álvaro Herrera, Josh Kupershmidt
2014-03-03Corrections to replication slots code and documentation.Robert Haas
Andres Freund, per a report from Vik Faering
2014-02-27Allow BASE_BACKUP to be throttledAlvaro Herrera
A new MAX_RATE option allows imposing a limit to the network transfer rate from the server side. This is useful to limit the stress that taking a base backup has on the server. pg_basebackup is now able to specify a value to the server, too. Author: Antonin Houska Patch reviewed by Stefan Radomski, Andres Freund, Zoltán Böszörményi, Fujii Masao, and Álvaro Herrera.
2014-02-27doc: bgw_main takes a Datum argument, not void *.Alvaro Herrera
Per report from James Harper.
2014-02-25Show xid and xmin in pg_stat_activity and pg_stat_replication.Robert Haas
Christian Kruse, reviewed by Andres Freund and myself, with further minor adjustments by me.
2014-02-24Update and clarify ssl_ciphers defaultPeter Eisentraut
- Write HIGH:MEDIUM instead of DEFAULT:!LOW:!EXP for clarity. - Order 3DES last to work around inappropriate OpenSSL default. - Remove !MD5 and @STRENGTH, because they are irrelevant. - Add clarifying documentation. Effectively, the new default is almost the same as the old one, but it is arguably easier to understand and modify. Author: Marko Kreen <markokr@gmail.com>
2014-02-24Increase work_mem and maintenance_work_mem defaults by 4xBruce Momjian
New defaults are 4MB and 64MB.
2014-02-24docs: remove unnecessary references to old PG versionsBruce Momjian
2014-02-24Fix markup for CHAR() doc patchBruce Momjian
2014-02-24docs: document behavior of CHAR() comparisons with chars < spaceBruce Momjian
Space trimming rather than space-padding causes unusual behavior, which might not be standards-compliant. Also remove recently-added now-redundant C comment.
2014-02-24Use pg_lsn data type in pg_stat_replication, too.Robert Haas
Michael Paquier, per a suggestion from Andres Freund
2014-02-23doc: Improve DocBook XML validityPeter Eisentraut
DocBook XML is superficially compatible with DocBook SGML but has a slightly stricter DTD that we have been violating in a few cases. Although XSLT doesn't care whether the document is valid, the style sheets don't necessarily process invalid documents correctly, so we need to work toward fixing this. This first commit moves the indexterms in refentry elements to an allowed position. It has no impact on the output.
2014-02-22pg_basebackup: Add support for relocating tablespacesPeter Eisentraut
Tablespaces can be relocated in plain backup mode by specifying one or more -T olddir=newdir options. Author: Steeve Lennmark <steevel@handeldsbanken.se> Reviewed-by: Peter Eisentraut <peter_e@gmx.net>
2014-02-20doc: Clarify documentation page header customization codePeter Eisentraut
The customization overrode the fast-forward code with its custom Up link. So this is no longer really the fast-forward feature, so we might as well turn that off and override the non-ff template instead, thus removing one mental indirection. Fix the wrong column span declaration. Clarify and update the documentation.
2014-02-19Document pg_replslot in storage.sgml.Robert Haas
Per an observation from Amit Kapila.
2014-02-19Switch various builtin functions to use pg_lsn instead of text.Robert Haas
The functions in slotfuncs.c don't exist in any released version, but the changes to xlogfuncs.c represent backward-incompatibilities. Per discussion, we're hoping that the queries using these functions are few enough and simple enough that this won't cause too much breakage for users. Michael Paquier, reviewed by Andres Freund and further modified by me.
2014-02-19Add a pg_lsn data type, to represent an LSN.Robert Haas
Robert Haas and Michael Paquier
2014-02-17Last-minute updates for release notes.Tom Lane
Add entries for security issues. Security: CVE-2014-0060 through CVE-2014-0067
2014-02-17Improve documentation about multixact IDs.Tom Lane
Per gripe from Josh Berkus.
2014-02-17Document risks of "make check" in the regression testing instructions.Tom Lane
Since the temporary server started by "make check" uses "trust" authentication, another user on the same machine could connect to it as database superuser, and then potentially exploit the privileges of the operating-system user who started the tests. We should change the testing procedures to prevent this risk; but discussion is required about the best way to do that, as well as more testing than is practical for an undisclosed security problem. Besides, the same issue probably affects some user-written test harnesses. So for the moment, we'll just warn people against using "make check" when there are untrusted users on the same machine. In passing, remove some ancient advice that suggested making the regression testing subtree world-writable if you'd built as root. That looks dangerously insecure in modern contexts, and anyway we should not be encouraging people to build Postgres as root. Security: CVE-2014-0067
2014-02-17Document security implications of check_function_bodies.Noah Misch
Back-patch to 8.4 (all supported versions).
2014-02-17Prevent privilege escalation in explicit calls to PL validators.Noah Misch
The primary role of PL validators is to be called implicitly during CREATE FUNCTION, but they are also normal functions that a user can call explicitly. Add a permissions check to each validator to ensure that a user cannot use explicit validator calls to achieve things he could not otherwise achieve. Back-patch to 8.4 (all supported versions). Non-core procedural language extensions ought to make the same two-line change to their own validators. Andres Freund, reviewed by Tom Lane and Noah Misch. Security: CVE-2014-0061
2014-02-17Shore up ADMIN OPTION restrictions.Noah Misch
Granting a role without ADMIN OPTION is supposed to prevent the grantee from adding or removing members from the granted role. Issuing SET ROLE before the GRANT bypassed that, because the role itself had an implicit right to add or remove members. Plug that hole by recognizing that implicit right only when the session user matches the current role. Additionally, do not recognize it during a security-restricted operation or during execution of a SECURITY DEFINER function. The restriction on SECURITY DEFINER is not security-critical. However, it seems best for a user testing his own SECURITY DEFINER function to see the same behavior others will see. Back-patch to 8.4 (all supported versions). The SQL standards do not conflate roles and users as PostgreSQL does; only SQL roles have members, and only SQL users initiate sessions. An application using PostgreSQL users and roles as SQL users and roles will never attempt to grant membership in the role that is the session user, so the implicit right to add or remove members will never arise. The security impact was mostly that a role member could revoke access from others, contrary to the wishes of his own grantor. Unapproved role member additions are less notable, because the member can still largely achieve that by creating a view or a SECURITY DEFINER function. Reviewed by Andres Freund and Tom Lane. Reported, independently, by Jonas Sundman and Noah Misch. Security: CVE-2014-0060
2014-02-16Release notes for 9.3.3, 9.2.7, 9.1.12, 9.0.16, 8.4.20.Tom Lane
2014-02-16Further wordsmithing on 9.3.3 release notes.Tom Lane
No substantive changes, but reorder some items and improve some descriptions.
2014-02-16Improve release notes per comments from Andres Freund.Tom Lane
Make a bit more noise about the timeout-interrupt bug. Also, remove the release note entry for commit 423e1211a; that patch fixed a problem introduced post-9.3.2, so there's no need to document it in the release notes.
2014-02-16First-draft release notes for 9.3.3.Tom Lane
As usual, the release notes for older branches will be made by cutting these down, but put them up for community review first.
2014-02-14Update regression testing instructions.Tom Lane
This documentation never got the word about the existence of check-world or installcheck-world. Revise to recommend use of those, and document all the subsidiary test suites. Do some minor wordsmithing elsewhere, too. In passing, remove markup related to generation of plain-text regression test instructions, since we don't do that anymore. Back-patch to 9.1 where check-world was added. (installcheck-world exists in 9.0; but since check-world doesn't, this patch would need additional work to cover that branch, and it doesn't seem worth the effort.)
2014-02-14Suggest shell here-documents instead of psql -c for multiple commands.Tom Lane
The documentation suggested using "echo | psql", but not the often-superior alternative of a here-document. Also, be more direct about suggesting that people avoid -c for multiple commands. Per discussion.
2014-02-13Separate multixact freezing parameters from xid'sAlvaro Herrera
Previously we were piggybacking on transaction ID parameters to freeze multixacts; but since there isn't necessarily any relationship between rates of Xid and multixact consumption, this turns out not to be a good idea. Therefore, we now have multixact-specific freezing parameters: vacuum_multixact_freeze_min_age: when to remove multis as we come across them in vacuum (default to 5 million, i.e. early in comparison to Xid's default of 50 million) vacuum_multixact_freeze_table_age: when to force whole-table scans instead of scanning only the pages marked as not all visible in visibility map (default to 150 million, same as for Xids). Whichever of both which reaches the 150 million mark earlier will cause a whole-table scan. autovacuum_multixact_freeze_max_age: when for cause emergency, uninterruptible whole-table scans (default to 400 million, double as that for Xids). This means there shouldn't be more frequent emergency vacuuming than previously, unless multixacts are being used very rapidly. Backpatch to 9.3 where multixacts were made to persist enough to require freezing. To avoid an ABI break in 9.3, VacuumStmt has a couple of fields in an unnatural place, and StdRdOptions is split in two so that the newly added fields can go at the end. Patch by me, reviewed by Robert Haas, with additional input from Andres Freund and Tom Lane.
2014-02-13docs: improve CREATE FUNCTION docs about language case and quotingBruce Momjian
Report from Marc Mamin
2014-02-13pgcrypto: clarify 'md5' (hash) table entryBruce Momjian
Per suggestion from Peter Eisentraut
2014-02-13pg_upgrade: mention the need for tablespace snapshots in docsBruce Momjian
2014-02-12pg_upgrade: document use of file system and COW snapshotsBruce Momjian
2014-02-12Improve cross-references between minor version release notes.Tom Lane
We have a practice of providing a "bread crumb" trail between the minor versions where the migration section actually tells you to do something. Historically that was just plain text, eg, "see the release notes for 9.2.4"; but if you're using a browser or PDF reader, it's a lot nicer if it's a live hyperlink. So use "<xref>" instead. Any argument against doing this vanished with the recent decommissioning of plain-text release notes. Vik Fearing
2014-02-12Revert gmake/make release note changesBruce Momjian
Backbranch release note changes cause merge conflicts.
2014-02-12Rename 'gmake' to 'make' in docs and recommended commandsBruce Momjian
This simplifies the docs and makes it easier to cut/paste command lines.
2014-02-12doc: Postgres date-style date-only output is ISOBruce Momjian
Backpatch to 9.3 Report from MauMau