From 6fba6cb05ddfb177ac1c4efa508707e879fb8bd3 Mon Sep 17 00:00:00 2001 From: Fujii Masao Date: Fri, 7 Nov 2025 14:42:17 +0900 Subject: [PATCH] doc: Clarify units for io_combine_limit and io_max_combine_limit. If these parameters are set without units, the values are interpreted as blocks. This detail was previously missing from the documentation, so this commit adds it. Backpatch to v17 where io_combine_limit was added. Author: Karina Litskevich Reviewed-by: Chao Li Reviewed-by: Xuneng Zhou Reviewed-by: Fujii Masao Discussion: https://postgr.es/m/CACiT8iZCDkz1bNYQNQyvGhXWJExSnJULRTYT894u4-Ti7Yh6jw@mail.gmail.com Backpatch-through: 17 --- doc/src/sgml/config.sgml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index d8a9f14b618..5fbe6c6794c 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -2697,6 +2697,8 @@ include_dir 'conf.d' This parameter can only be set in the postgresql.conf file or on the server command line. + If this value is specified without units, it is taken as blocks, + that is BLCKSZ bytes, typically 8kB. The maximum possible size depends on the operating system and block size, but is typically 1MB on Unix and 128kB on Windows. The default is 128kB. @@ -2716,6 +2718,8 @@ include_dir 'conf.d' higher than the io_max_combine_limit parameter, the lower value will silently be used instead, so both may need to be raised to increase the I/O size. + If this value is specified without units, it is taken as blocks, + that is BLCKSZ bytes, typically 8kB. The maximum possible size depends on the operating system and block size, but is typically 1MB on Unix and 128kB on Windows. The default is 128kB. -- 2.47.3