postgresql/doc/src/sgml/ref
Andres Freund fc49e24fa6 Make WAL segment size configurable at initdb time.
For performance reasons a larger segment size than the default 16MB
can be useful. A larger segment size has two main benefits: Firstly,
in setups using archiving, it makes it easier to write scripts that
can keep up with higher amounts of WAL, secondly, the WAL has to be
written and synced to disk less frequently.

But at the same time large segment size are disadvantageous for
smaller databases. So far the segment size had to be configured at
compile time, often making it unrealistic to choose one fitting to a
particularly load. Therefore change it to a initdb time setting.

This includes a breaking changes to the xlogreader.h API, which now
requires the current segment size to be configured.  For that and
similar reasons a number of binaries had to be taught how to recognize
the current segment size.

Author: Beena Emerson, editorialized by Andres Freund
Reviewed-By: Andres Freund, David Steele, Kuntal Ghosh, Michael
    Paquier, Peter Eisentraut, Robert Hass, Tushar Ahuja
Discussion: https://postgr.es/m/CAOG9ApEAcQ--1ieKbhFzXSQPw_YLmepaa4hNdnY5+ZULpt81Mw@mail.gmail.com
2017-09-19 22:03:48 -07:00
..
abort.sgml
allfiles.sgml Implement multivariate n-distinct coefficients 2017-03-24 14:06:10 -03:00
alter_aggregate.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
alter_collation.sgml Doc: minor improvements for collation-related man pages. 2017-06-25 12:27:04 -04:00
alter_conversion.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_database.sgml Order some new options on man pages more sensibly, minor improvements 2015-09-17 20:57:47 -04:00
alter_default_privileges.sgml Altering default privileges on schemas 2017-03-28 18:58:55 +03:00
alter_domain.sgml doc: Add some markup 2017-04-07 22:45:39 -04:00
alter_event_trigger.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_extension.sgml Allow referring to functions without arguments when unique 2017-03-14 23:55:19 -04:00
alter_foreign_data_wrapper.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_foreign_table.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
alter_function.sgml Allow referring to functions without arguments when unique 2017-03-14 23:55:19 -04:00
alter_group.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_index.sgml Allow SET STATISTICS on expression indexes 2017-09-06 13:46:01 -07:00
alter_language.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_large_object.sgml Copy-edit the docs changes of OWNER TO CURRENT/SESSION_USER additions. 2015-07-10 14:39:29 +03:00
alter_materialized_view.sgml Fix duplication in ALTER MATERIALIZE VIEW synopsis 2016-11-14 11:14:34 -03:00
alter_opclass.sgml Copy-edit the docs changes of OWNER TO CURRENT/SESSION_USER additions. 2015-07-10 14:39:29 +03:00
alter_operator.sgml Escape < and & in SGML 2017-09-06 11:22:43 -04:00
alter_opfamily.sgml Allow referring to functions without arguments when unique 2017-03-14 23:55:19 -04:00
alter_policy.sgml Add support for restrictive RLS policies 2016-12-05 15:50:55 -05:00
alter_publication.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
alter_role.sgml Remove support for password_encryption='off' / 'plain'. 2017-05-08 11:26:07 +03:00
alter_rule.sgml
alter_schema.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_sequence.sgml doc: Fix typos and other minor issues 2017-09-01 23:34:12 -04:00
alter_server.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_statistics.sgml Change CREATE STATISTICS syntax 2017-05-12 14:59:35 -03:00
alter_subscription.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
alter_system.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
alter_table.sgml Allow a partitioned table to have a default partition. 2017-09-08 17:28:04 -04:00
alter_tablespace.sgml Add missing documentation for effective_io_concurrency tablespace option. 2016-12-17 01:25:29 +09:00
alter_trigger.sgml Support ALTER THING .. DEPENDS ON EXTENSION 2016-04-05 18:38:54 -03:00
alter_tsconfig.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_tsdictionary.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
alter_tsparser.sgml
alter_tstemplate.sgml
alter_type.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
alter_user_mapping.sgml doc: Correct ALTER USER MAPPING example 2016-09-20 12:00:00 -04:00
alter_user.sgml Further unify ROLE and USER command grammar rules 2017-08-03 20:34:45 -04:00
alter_view.sgml Allow CURRENT/SESSION_USER to be used in certain commands 2015-03-09 15:41:54 -03:00
analyze.sgml Remove duplicated word. 2017-03-07 11:18:56 -05:00
begin.sgml
checkpoint.sgml Replace "transaction log" with "write-ahead log" 2017-05-12 11:52:43 -04:00
close.sgml
cluster.sgml Add GUC and storage parameter to set the maximum size of GIN pending list. 2014-11-11 21:08:21 +09:00
clusterdb.sgml doc: Consistently use = sign in long options synopses 2016-10-19 08:48:48 -04:00
comment.sgml Add COMMENT and SECURITY LABEL support for publications and subscriptions 2017-03-24 23:44:23 -04:00
commit_prepared.sgml
commit.sgml
copy.sgml doc: Fix typos and other minor issues 2017-09-01 23:34:12 -04:00
create_access_method.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
create_aggregate.sgml Improve user-facing documentation for partial/parallel aggregation. 2016-06-22 19:14:16 -04:00
create_cast.sgml Allow referring to functions without arguments when unique 2017-03-14 23:55:19 -04:00
create_collation.sgml Doc: minor improvements for collation-related man pages. 2017-06-25 12:27:04 -04:00
create_conversion.sgml
create_database.sgml doc: Update CREATE DATABASE examples 2017-02-06 11:55:39 -05:00
create_domain.sgml doc: Spell checking 2015-09-10 21:35:06 -04:00
create_event_trigger.sgml doc: Tweak synopsis indentation for consistency 2015-09-21 23:31:43 -04:00
create_extension.sgml Doc: minor documentation improvements about extensions. 2016-09-07 13:36:08 -04:00
create_foreign_data_wrapper.sgml
create_foreign_table.sgml Remove unnecessairly duplicated gram.y productions 2017-04-27 20:14:39 -04:00
create_function.sgml Upgrade documentation connected with shared_preload_libraries et al. 2017-06-20 13:40:06 -04:00
create_group.sgml Remove support for password_encryption='off' / 'plain'. 2017-05-08 11:26:07 +03:00
create_index.sgml BRIN auto-summarization 2017-04-01 14:00:53 -03:00
create_language.sgml Remove createlang and droplang 2017-03-23 14:16:45 -04:00
create_materialized_view.sgml doc: Fix markup 2014-12-13 14:16:16 -05:00
create_opclass.sgml Replace the built-in GIN array opclasses with a single polymorphic opclass. 2016-09-26 14:52:44 -04:00
create_operator.sgml
create_opfamily.sgml
create_policy.sgml Documentation spell checking and markup improvements 2017-06-18 14:02:12 -04:00
create_publication.sgml doc: Add note that COPY commands are published as INSERTs 2017-06-16 21:04:34 -04:00
create_role.sgml doc: Update description of rolreplication column 2017-08-11 16:14:55 -04:00
create_rule.sgml Add support for INSERT ... ON CONFLICT DO NOTHING/UPDATE. 2015-05-08 05:43:10 +02:00
create_schema.sgml Use gender-neutral language in documentation 2015-09-21 22:57:29 -04:00
create_sequence.sgml doc: Fix typos and other minor issues 2017-09-01 23:34:12 -04:00
create_server.sgml Add IF NOT EXISTS for CREATE SERVER and CREATE USER MAPPING 2017-03-20 16:40:45 -04:00
create_statistics.sgml Message style fixes 2017-09-11 11:21:27 -04:00
create_subscription.sgml doc: Improve logical replication security setup info 2017-06-19 17:30:52 -04:00
create_table_as.sgml Add CINE option for CREATE TABLE AS and CREATE MATERIALIZED VIEW 2014-12-13 13:56:09 -05:00
create_table.sgml After a MINVALUE/MAXVALUE bound, allow only more of the same. 2017-09-15 21:15:55 -04:00
create_tablespace.sgml Allow per-tablespace effective_io_concurrency 2015-09-08 12:51:42 -03:00
create_transform.sgml Allow referring to functions without arguments when unique 2017-03-14 23:55:19 -04:00
create_trigger.sgml Ensure that BEFORE STATEMENT triggers fire the right number of times. 2017-09-17 12:16:38 -04:00
create_tsconfig.sgml
create_tsdictionary.sgml
create_tsparser.sgml
create_tstemplate.sgml
create_type.sgml Make UNKNOWN into an actual pseudo-type. 2017-01-25 09:27:09 -05:00
create_user_mapping.sgml Add IF NOT EXISTS for CREATE SERVER and CREATE USER MAPPING 2017-03-20 16:40:45 -04:00
create_user.sgml Remove support for password_encryption='off' / 'plain'. 2017-05-08 11:26:07 +03:00
create_view.sgml Escape < and & in SGML 2017-09-06 11:22:43 -04:00
createdb.sgml doc: improve createdb example 2017-03-20 21:23:56 -04:00
createuser.sgml Remove support for password_encryption='off' / 'plain'. 2017-05-08 11:26:07 +03:00
deallocate.sgml
declare.sgml
delete.sgml doc: Update compatibility claim 2017-03-18 14:25:41 -04:00
discard.sgml
do.sgml
drop_access_method.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_aggregate.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
drop_cast.sgml
drop_collation.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_conversion.sgml
drop_database.sgml
drop_domain.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_event_trigger.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_extension.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_foreign_data_wrapper.sgml Combine several DROP variants into generic DropStmt 2017-03-06 13:31:47 -05:00
drop_foreign_table.sgml Fix typo in comment 2017-04-14 14:07:44 -04:00
drop_function.sgml Allow referring to functions without arguments when unique 2017-03-14 23:55:19 -04:00
drop_group.sgml
drop_index.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_language.sgml Remove createlang and droplang 2017-03-23 14:16:45 -04:00
drop_materialized_view.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_opclass.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_operator.sgml Allow dropping multiple functions at once 2017-03-06 13:31:47 -05:00
drop_opfamily.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_owned.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_policy.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
drop_publication.sgml Fix copy/paste error in docs 2017-06-18 19:41:46 +02:00
drop_role.sgml Improve documentation of the role-dropping process. 2015-10-07 16:12:05 -04:00
drop_rule.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_schema.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_sequence.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_server.sgml Combine several DROP variants into generic DropStmt 2017-03-06 13:31:47 -05:00
drop_statistics.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
drop_subscription.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
drop_table.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_tablespace.sgml
drop_transform.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_trigger.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_tsconfig.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_tsdictionary.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_tsparser.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_tstemplate.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_type.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
drop_user_mapping.sgml Use gender-neutral language in documentation 2015-09-21 22:57:29 -04:00
drop_user.sgml Improve documentation of the role-dropping process. 2015-10-07 16:12:05 -04:00
drop_view.sgml Doc: clarify that DROP ... CASCADE is recursive. 2016-08-12 18:45:18 -04:00
dropdb.sgml
dropuser.sgml
ecpg-ref.sgml Fix buffer overflow on particularly named files and clarify documentation about 2016-12-22 08:28:13 +01:00
end.sgml
execute.sgml
explain.sgml Documentation spell checking and markup improvements 2017-06-18 14:02:12 -04:00
fetch.sgml
grant.sgml doc: Add some markup 2017-04-07 22:45:39 -04:00
import_foreign_schema.sgml doc: Whitespace fixes in man pages 2017-06-14 13:56:04 -04:00
initdb.sgml Make WAL segment size configurable at initdb time. 2017-09-19 22:03:48 -07:00
insert.sgml Clarify documentation 2017-08-27 21:29:54 -04:00
listen.sgml
load.sgml Upgrade documentation connected with shared_preload_libraries et al. 2017-06-20 13:40:06 -04:00
lock.sgml Allow LOCK TABLE .. ROW EXCLUSIVE MODE with INSERT 2015-05-11 15:44:12 -04:00
move.sgml
notify.sgml doc: Change recommendation to put NOTIFY into a rule 2016-08-03 12:29:15 -04:00
pg_basebackup.sgml Replace "transaction log" with "write-ahead log" 2017-05-12 11:52:43 -04:00
pg_config-ref.sgml
pg_controldata.sgml Add -D option to specify data directory to pg_controldata and pg_resetxlog. 2014-09-25 13:37:19 +03:00
pg_ctl-ref.sgml pg_ctl: Make failure to complete operation a nonzero exit 2017-07-05 13:37:08 -04:00
pg_dump.sgml pg_dump: Support using synchronized snapshots on standbys 2017-08-16 19:46:50 -04:00
pg_dumpall.sgml pg_dumpall: Add a -E flag to set the encoding, like pg_dump has. 2017-09-01 12:24:20 -04:00
pg_isready.sgml docs: Improve pg_isready details about username/dbname 2014-09-06 12:43:11 -04:00
pg_receivewal.sgml pg_receivewal: Add --endpos option 2017-09-11 16:48:30 -04:00
pg_recvlogical.sgml Put new command-line options in alphabetical order 2017-06-08 12:12:31 -04:00
pg_resetwal.sgml Prevent running pg_resetwal/pg_resetxlog against wrong-version data dirs. 2017-05-29 17:08:16 -04:00
pg_restore.sgml doc: Small wording improvement 2017-08-11 15:52:39 -04:00
pg_rewind.sgml Rename "pg_clog" directory to "pg_xact". 2017-03-17 09:48:38 -04:00
pg_waldump.sgml Standardize "WAL location" terminology 2017-05-12 13:51:27 -04:00
pgarchivecleanup.sgml doc: Remove some confusion from pg_archivecleanup doc 2016-08-16 15:33:52 -04:00
pgbench.sgml Adjust pgbench to allow non-ASCII characters in variable names. 2017-09-04 13:45:20 -04:00
pgtestfsync.sgml Replace "transaction log" with "write-ahead log" 2017-05-12 11:52:43 -04:00
pgtesttiming.sgml Escape < and & in SGML 2017-09-06 11:22:43 -04:00
pgupgrade.sgml docs: clarify pg_upgrade docs regarding standbys and rsync 2017-09-16 11:58:00 -04:00
postgres-ref.sgml Remove TZ environment-variable entry from postgres reference page. 2016-03-29 21:38:41 -04:00
postmaster.sgml
prepare_transaction.sgml
prepare.sgml doc: Remove some trailing whitespace 2016-12-17 09:35:31 -05:00
psql-ref.sgml Add psql variables to track success/failure of SQL queries. 2017-09-12 19:27:48 -04:00
reassign_owned.sgml Improve documentation of the role-dropping process. 2015-10-07 16:12:05 -04:00
refresh_materialized_view.sgml
reindex.sgml Simplify syntax diagram for REINDEX. 2016-02-04 13:58:40 -05:00
reindexdb.sgml doc: Remove some trailing whitespace 2016-12-17 09:35:31 -05:00
release_savepoint.sgml
reset.sgml
revoke.sgml Allow referring to functions without arguments when unique 2017-03-14 23:55:19 -04:00
rollback_prepared.sgml
rollback_to.sgml
rollback.sgml
savepoint.sgml
security_label.sgml Add COMMENT and SECURITY LABEL support for publications and subscriptions 2017-03-24 23:44:23 -04:00
select_into.sgml
select.sgml Doc: clarify description of degenerate NATURAL joins. 2017-07-20 12:41:26 -04:00
set_constraints.sgml
set_role.sgml doc: more replacement of <literal> with something better 2016-08-24 21:11:44 -04:00
set_session_auth.sgml doc: more replacement of <literal> with something better 2016-08-24 21:11:44 -04:00
set_transaction.sgml Don't force-assign transaction id when exporting a snapshot. 2017-06-14 11:57:21 -07:00
set.sgml
show.sgml
start_transaction.sgml
truncate.sgml doc: Update compatibility claim 2017-03-18 14:25:41 -04:00
unlisten.sgml
update.sgml doc: Improve documentation related to table partitioning feature. 2016-12-13 08:18:00 -05:00
vacuum.sgml Simplify the example of VACUUM in documentation. 2017-03-31 01:31:15 +09:00
vacuumdb.sgml doc: Consistently use = sign in long options synopses 2016-10-19 08:48:48 -04:00
values.sgml doc: add link for list-of-scalars mention 2016-06-28 16:16:06 -04:00