diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 1320875b5b..47b12c6a8f 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -883,9 +883,9 @@ include_dir 'conf.d' - Specifies the number of seconds of inactivity after which TCP - should send a keepalive message to the client. A value of 0 uses - the system default. + Specifies the duration of inactivity after which TCP should + send a keepalive message to the client (defaults to seconds). + A value of 0 uses the system default. This parameter is supported only on systems that support TCP_KEEPIDLE or an equivalent socket option, and on Windows; on other systems, it must be zero. @@ -909,8 +909,9 @@ include_dir 'conf.d' - Specifies the number of seconds after which a TCP keepalive message - that is not acknowledged by the client should be retransmitted. + Specifies the duration after which a TCP keepalive message + that is not acknowledged by the client should be retransmitted + (defaults to seconds). A value of 0 uses the system default. This parameter is supported only on systems that support TCP_KEEPINTVL or an equivalent socket option, and on @@ -960,7 +961,7 @@ include_dir 'conf.d' - Specifies the number of milliseconds that transmitted data may + Specifies duration (defaults to milliseconds) that transmitted data may remain unacknowledged before a connection is forcibly closed. A value of 0 uses the system default. This parameter is supported only on systems that support @@ -995,7 +996,7 @@ include_dir 'conf.d' - Maximum time to complete client authentication, in seconds. If a + Maximum duration to complete client authentication (defaults to seconds). If a would-be client has not completed the authentication protocol in this much time, the server closes the connection. This prevents hung clients from occupying a connection indefinitely. @@ -1818,7 +1819,7 @@ include_dir 'conf.d' for temporary files, such as sort and hash temporary files, or the storage file for a held cursor. A transaction attempting to exceed this limit will be canceled. - The value is specified in kilobytes, and -1 (the + The default unit is kilobytes, and -1 (the default) means no limit. Only superusers can change this setting. @@ -1906,7 +1907,7 @@ include_dir 'conf.d' - The length of time, in milliseconds, that the process will sleep + The duration (defaults to milliseconds) that the process will sleep when the cost limit has been exceeded. The default value is zero, which disables the cost-based vacuum delay feature. Positive values enable cost-based vacuuming. @@ -2031,11 +2032,11 @@ include_dir 'conf.d' - Specifies the delay between activity rounds for the + Specifies the delay (defaults to milliseconds) between activity rounds for the background writer. In each round the writer issues writes for some number of dirty buffers (controllable by the following parameters). It then sleeps for bgwriter_delay - milliseconds, and repeats. When there are no dirty buffers in the + duration, and repeats. When there are no dirty buffers in the buffer pool, though, it goes into a longer sleep regardless of bgwriter_delay. The default value is 200 milliseconds (200ms). Note that on many systems, the @@ -2794,9 +2795,10 @@ include_dir 'conf.d' Specifies how often the WAL writer flushes WAL. After flushing WAL it - sleeps for wal_writer_delay milliseconds, unless woken up + sleeps for wal_writer_delay duration (defaults + to milliseconds), unless woken up by an asynchronously committing transaction. If the last flush - happened less than wal_writer_delay milliseconds ago and + happened less than wal_writer_delay duration ago and less than wal_writer_flush_after bytes of WAL have been produced since, then WAL is only written to the operating system, not flushed to disk. @@ -2819,7 +2821,8 @@ include_dir 'conf.d' Specifies how often the WAL writer flushes WAL. If the last flush - happened less than wal_writer_delay milliseconds ago and + happened less than wal_writer_delay duration ago + (defaults to milliseconds) and less than wal_writer_flush_after bytes of WAL have been produced since, then WAL is only written to the operating system, not flushed to disk. If wal_writer_flush_after is set @@ -2897,7 +2900,7 @@ include_dir 'conf.d' - Maximum time between automatic WAL checkpoints, in seconds. + Maximum duration between automatic WAL checkpoints (defaults to seconds). The valid range is between 30 seconds and one day. The default is five minutes (5min). Increasing this parameter can increase the amount of time needed @@ -3672,7 +3675,7 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows Terminate replication connections that are inactive longer - than the specified number of milliseconds. This is useful for + than the specified duration (defaults to milliseconds). This is useful for the sending server to detect a standby crash or network outage. A value of zero disables the timeout mechanism. The default value is 60 seconds. With a cluster distributed across multiple geographic @@ -4124,7 +4127,7 @@ ANY num_sync ( for more details about this. @@ -8484,7 +8487,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' - This is the amount of time, in milliseconds, to wait on a lock + This is the duration (defaults to milliseconds), to wait on a lock before checking to see if there is a deadlock condition. The check for deadlock is relatively expensive, so the server doesn't run it every time it waits for a lock. We optimistically assume @@ -8503,7 +8506,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' When is set, - this parameter also determines the length of time to wait before + this parameter also determines the duration to wait before a log message is issued about the lock wait. If you are trying to investigate locking delays you might want to set a shorter than normal deadlock_timeout. @@ -9321,11 +9324,12 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' - If nonzero, a delay of this many seconds occurs when a new + If nonzero, a delay of this duration occurs when a new server process is started, after it conducts the authentication procedure. This is intended to give developers an opportunity to attach to the server process with a debugger. - This parameter cannot be changed after session start. + This parameter defaults to seconds and cannot be changed after + session start. @@ -9338,13 +9342,14 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' - If nonzero, a delay of this many seconds occurs just after a + If nonzero, a delay of this duration occurs just after a new server process is forked, before it conducts the authentication procedure. This is intended to give developers an opportunity to attach to the server process with a debugger to trace down misbehavior in authentication. - This parameter can only be set in the postgresql.conf - file or on the server command line. + This parameter defaults to seconds and can only be set in the + postgresql.conf file or on the server + command line.