summaryrefslogtreecommitdiff
path: root/doc/src
AgeCommit message (Collapse)Author
2015-09-26doc: Tweak "cube" index entryPeter Eisentraut
With the arrival of the CUBE key word/feature, the index entries for the cube extension and the CUBE feature were collapsed into one. Tweak the entry for the cube extension so they are separate entries.
2015-09-22Docs: fix typo in to_char() example.Tom Lane
Per bug #13631 from KOIZUMI Satoru.
2015-09-21doc: Tweak synopsis indentation for consistencyPeter Eisentraut
2015-09-20Remove the row_security=force GUC value.Noah Misch
Every query of a single ENABLE ROW SECURITY table has two meanings, with the row_security GUC selecting between them. With row_security=force available, every function author would have been advised to either set the GUC locally or test both meanings. Non-compliance would have threatened reliability and, for SECURITY DEFINER functions, security. Authors already face an obligation to account for search_path, and we should not mimic that example. With this change, only BYPASSRLS roles need exercise the aforementioned care. Back-patch to 9.5, where the row_security GUC was introduced. Since this narrows the domain of pg_db_role_setting.setconfig and pg_proc.proconfig, one might bump catversion. A row_security=force setting in one of those columns will elicit a clear message, so don't.
2015-09-17Order some new options on man pages more sensibly, minor improvementsPeter Eisentraut
2015-09-16Fix documentation of regular expression character-entry escapes.Tom Lane
The docs claimed that \uhhhh would be interpreted as a Unicode value regardless of the database encoding, but it's never been implemented that way: \uhhhh and \xhhhh actually mean exactly the same thing, namely the character that pg_mb2wchar translates to 0xhhhh. Moreover we were falsely dismissive of the usefulness of Unicode code points above FFFF. Fix that. It's been like this for ages, so back-patch to all supported branches.
2015-09-15Add POLICY to COMMENT documentationStephen Frost
COMMENT supports POLICY but the documentation hadn't caught up with that fact. Patch by Charles Clavadetscher Back-patch to 9.5 where POLICY was added.
2015-09-12doc: Remove dead linksPeter Eisentraut
The web pages of Andy Dong at Berkeley don't exist anymore, and he is no longer there.
2015-09-12Fix typo in create_policy.sgmlStephen Frost
WTIH -> WITH Pointed out by Dmitriy Olshevskiy Backpatch to 9.5 where create_policy.sgml was added.
2015-09-11Correct description of PageHeaderData layout in documentationFujii Masao
Back-patch to 9.3 where PageHeaderData layout was changed. Michael Paquier
2015-09-10doc: Spell checkingPeter Eisentraut
2015-09-07Update site address of Snowball projectTeodor Sigaev
2015-09-05Fix misc typos.Heikki Linnakangas
Oskari Saarenmaa. Backpatch to stable branches where applicable.
2015-09-03Document that max_worker_processes must be high enough in standby.Fujii Masao
The setting values of some parameters including max_worker_processes must be equal to or higher than the values on the master. However, previously max_worker_processes was not listed as such parameter in the document. So this commit adds it to that list. Back-patch to 9.4 where max_worker_processes was added.
2015-09-01Document that PL/Python now returns floats using repr() not str().Tom Lane
Commit 1ce7a57ca neglected to update the user-facing documentation, which described the old behavior precisely.
2015-09-01pg_upgrade docs: clarify rsync and move verification stepBruce Momjian
These are adjustments based on someone using the new standby upgrade steps. Report by Andy Colson Backpatch through 9.5
2015-09-01Use <substeps> in pg_upgrade's procedureAlvaro Herrera
For clarity, so that the substeps are not numbered identically to the outer procedure's steps. Per report from Andy Colson in http://www.postgresql.org/message-id/55D789B5.7040308@squeakycode.net
2015-08-31docs: remove outdated note about unique indexesBruce Momjian
Patch by Josh Kupershmidt Backpatch through 9.5
2015-08-31Small grammar fixMagnus Hagander
Josh Kupershmidt
2015-08-27dblink docs: fix typo to use "connname" (3 n's), not "conname"Bruce Momjian
This makes the parameter names match the documented prototype names. Report by Erwin Brandstetter Backpatch through 9.0
2015-08-26release notes: abbreviated key speedup only for varchar/textBruce Momjian
Report by Peter Geoghegan Backpatch through 9.5
2015-08-26release notes: backpatch removal of xpath item to 9.5 treeBruce Momjian
Backpatch a93545e13f832d457e00420d44ccce1f88f899d4 to the 9.5 tree Backpatch to 9.5 only
2015-08-269.5 release notes: mention lack of char() sort improvementsBruce Momjian
Report by Peter Geoghegan Backpatch through 9.5
2015-08-25Docs: be explicit about datatype matching for lead/lag functions.Tom Lane
The default argument, if given, has to be of exactly the same datatype as the first argument; but this was not stated in so many words, and the error message you get about it might not lead your thought in the right direction. Per bug #13587 from Robert McGehee. A quick scan says that these are the only two built-in functions with two anyelement arguments and no other polymorphic arguments. There are plenty of cases of, eg, anyarray and anyelement, but those seem less likely to confuse. For instance this doesn't seem terribly hard to figure out: "function array_remove(integer[], numeric) does not exist". So I've contented myself with fixing these two cases.
2015-08-20doc: Whitespace and formatting fixesPeter Eisentraut
2015-08-15Add docs about postgres_fdw's setting of search_path and other GUCs.Tom Lane
This behavior wasn't documented, but it should be because it's user-visible in triggers and other functions executed on the remote server. Per question from Adam Fuchs. Back-patch to 9.3 where postgres_fdw was added.
2015-08-15Improve documentation about MVCC-unsafe utility commands.Tom Lane
The table-rewriting forms of ALTER TABLE are MVCC-unsafe, in much the same way as TRUNCATE, because they replace all rows of the table with newly-made rows with a new xmin. (Ideally, concurrent transactions with old snapshots would continue to see the old table contents, but the data is not there anymore --- and if it were there, it would be inconsistent with the table's updated rowtype, so there would be serious implementation problems to fix.) This was nowhere documented though, and the problem was only documented for TRUNCATE in a note in the TRUNCATE reference page. Create a new "Caveats" section in the MVCC chapter that can be home to this and other limitations on serializable consistency. In passing, fix a mistaken statement that VACUUM and CLUSTER would reclaim space occupied by a dropped column. They don't reconstruct existing tuples so they couldn't do that. Back-patch to all supported branches.
2015-08-14Update key words table for 9.5Peter Eisentraut
2015-08-10Don't start to stream after pg_receivexlog --create-slot.Andres Freund
Immediately starting to stream after --create-slot is inconvenient in a number of situations (e.g. when configuring a slot for use in recovery.conf) and it's easy to just call pg_receivexlog twice in the rest of the cases. Author: Michael Paquier Discussion: CAB7nPqQ9qEtuDiKY3OpNzHcz5iUA+DUX9FcN9K8GUkCZvG7+Ew@mail.gmail.com Backpatch: 9.5, where the option was introduced
2015-08-09Remove gram.y's precedence declaration for OVERLAPS.Tom Lane
The allowed syntax for OVERLAPS, viz "row OVERLAPS row", is sufficiently constrained that we don't actually need a precedence declaration for OVERLAPS; indeed removing this declaration does not change the generated gram.c file at all. Let's remove it to avoid confusion about whether OVERLAPS has precedence or not. If we ever generalize what we allow for OVERLAPS, we might need to put back a precedence declaration for it, but we might want some other level than what it has today --- and leaving the declaration there would just risk confusion about whether that would be an incompatible change. Likewise, remove OVERLAPS from the documentation's precedence table. Per discussion with Noah Misch. Back-patch to 9.5 where we hacked up some nearby precedence decisions.
2015-08-09Fix typo in LDAP exampleMagnus Hagander
Reported by William Meitzen
2015-08-08docs: fix typo in rules.sgmlBruce Momjian
Report by Dean Rasheed Patch by Dean Rasheed Backpatch through 9.5
2015-08-089.5 release notes: add increase buffer mapping partitions itemBruce Momjian
Report by Robert Haas, Andres Freund Backpatch through 9.5
2015-08-07Address points made in post-commit review of replication origins.Andres Freund
Amit reviewed the replication origins patch and made some good points. Address them. This fixes typos in error messages, docs and comments and adds a missing error check (although in a should-never-happen scenario). Discussion: CAA4eK1JqUBVeWWKwUmBPryFaje4190ug0y-OAUHWQ6tD83V4xg@mail.gmail.com Backpatch: 9.5, where replication origins were introduced.
2015-08-069.5 release notes: updates from Andres Freund and Jeff JanesBruce Momjian
Report by Andres Freund and Jeff Janes Backpatch through 9.5
2015-08-069.5 release notes: mention ON CONFLICT DO NOTHING for FDWsBruce Momjian
Report by Peter Geoghegan Backpatch through 9.5
2015-08-069.5 release notes: mention change to CRC-32CBruce Momjian
Report by Andres Freund Backpatch through 9.5
2015-08-069.5 release notes: adjustments suggested by Andres FreundBruce Momjian
Report by Andres Freund Backpatch through 9.5
2015-08-069.5 release notes: add non-LEAKPROOF view pushdown mentionBruce Momjian
Report by Dean Rasheed Backpatch through 9.5
2015-08-04Docs: add an explicit example about controlling overall greediness of REs.Tom Lane
Per discussion of bug #13538.
2015-08-03Update 9.5 release notes through today.Tom Lane
2015-07-30Improve CREATE FUNCTION doc WRT to LEAKPROOF RLS interaction.Joe Conway
Patch by Dean Rasheed. Back-patched to 9.5 where RLS was introduced.
2015-07-28Create a pg_shdepend entry for each role in TO clause of policies.Joe Conway
CreatePolicy() and AlterPolicy() omit to create a pg_shdepend entry for each role in the TO clause. Fix this by creating a new shared dependency type called SHARED_DEPENDENCY_POLICY and assigning it to each role. Reported by Noah Misch. Patch by me, reviewed by Alvaro Herrera. Back-patch to 9.5 where RLS was introduced.
2015-07-28Update our documentation concerning where to create data directories.Tom Lane
Although initdb has long discouraged use of a filesystem mount-point directory as a PG data directory, this point was covered nowhere in the user-facing documentation. Also, with the popularity of pg_upgrade, we really need to recommend that the PG user own not only the data directory but its parent directory too. (Without a writable parent directory, operations such as "mv data data.old" fail immediately. pg_upgrade itself doesn't do that, but wrapper scripts for it often do.) Hence, adjust the "Creating a Database Cluster" section to address these points. I also took the liberty of wordsmithing the discussion of NFS a bit. These considerations aren't by any means new, so back-patch to all supported branches.
2015-07-28Plug RLS related information leak in pg_stats view.Joe Conway
The pg_stats view is supposed to be restricted to only show rows about tables the user can read. However, it sometimes can leak information which could not otherwise be seen when row level security is enabled. Fix that by not showing pg_stats rows to users that would be subject to RLS on the table the row is related to. This is done by creating/using the newly introduced SQL visible function, row_security_active(). Along the way, clean up three call sites of check_enable_rls(). The second argument of that function should only be specified as other than InvalidOid when we are checking as a different user than the current one, as in when querying through a view. These sites were passing GetUserId() instead of InvalidOid, which can cause the function to return incorrect results if the current user has the BYPASSRLS privilege and row_security has been set to OFF. Additionally fix a bug causing RI Trigger error messages to unintentionally leak information when RLS is enabled, and other minor cleanup and improvements. Also add WITH (security_barrier) to the definition of pg_stats. Bumped CATVERSION due to new SQL functions and pg_stats view definition. Back-patch to 9.5 where RLS was introduced. Reported by Yaroslav. Patch by Joe Conway and Dean Rasheed with review and input by Michael Paquier and Stephen Frost.
2015-07-28Remove ssl renegotiation support.Andres Freund
While postgres' use of SSL renegotiation is a good idea in theory, it turned out to not work well in practice. The specification and openssl's implementation of it have lead to several security issues. Postgres' use of renegotiation also had its share of bugs. Additionally OpenSSL has a bunch of bugs around renegotiation, reported and open for years, that regularly lead to connections breaking with obscure error messages. We tried increasingly complex workarounds to get around these bugs, but we didn't find anything complete. Since these connection breakages often lead to hard to debug problems, e.g. spuriously failing base backups and significant latency spikes when synchronous replication is used, we have decided to change the default setting for ssl renegotiation to 0 (disabled) in the released backbranches and remove it entirely in 9.5 and master. Author: Andres Freund Discussion: 20150624144148.GQ4797@alap3.anarazel.de Backpatch: 9.5 and master, 9.0-9.4 get a different patch
2015-07-25Improve markup for row_security.Joe Conway
Wrap the literals on, off, force, and BYPASSRLS with appropriate markup. Per Kevin Grittner.
2015-07-25Redesign tablesample method API, and do extensive code review.Tom Lane
The original implementation of TABLESAMPLE modeled the tablesample method API on index access methods, which wasn't a good choice because, without specialized DDL commands, there's no way to build an extension that can implement a TSM. (Raw inserts into system catalogs are not an acceptable thing to do, because we can't undo them during DROP EXTENSION, nor will pg_upgrade behave sanely.) Instead adopt an API more like procedural language handlers or foreign data wrappers, wherein the only SQL-level support object needed is a single handler function identified by having a special return type. This lets us get rid of the supporting catalog altogether, so that no custom DDL support is needed for the feature. Adjust the API so that it can support non-constant tablesample arguments (the original coding assumed we could evaluate the argument expressions at ExecInitSampleScan time, which is undesirable even if it weren't outright unsafe), and discourage sampling methods from looking at invisible tuples. Make sure that the BERNOULLI and SYSTEM methods are genuinely repeatable within and across queries, as required by the SQL standard, and deal more honestly with methods that can't support that requirement. Make a full code-review pass over the tablesample additions, and fix assorted bugs, omissions, infelicities, and cosmetic issues (such as failure to put the added code stanzas in a consistent ordering). Improve EXPLAIN's output of tablesample plans, too. Back-patch to 9.5 so that we don't have to support the original API in production.
2015-07-20Improve BRIN documentation somewhatAlvaro Herrera
This removes some info about support procedures being used, which was obsoleted by commit db5f98ab4f, as well as add some more documentation on how to create new opclasses using the Minmax infrastructure. (Hopefully we can get something similar for Inclusion as well.) In passing, fix some obsolete mentions of "mmtuples" in source code comments. Backpatch to 9.5, where BRIN was introduced.
2015-07-17Release note compatibility itemAndrew Dunstan
Note that json and jsonb extraction operators no longer consider a negative subscript to be invalid.