From d83da466b59bd4523806a084b39cda90dc9c11e4 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 8edf8c88f03..c02b6addc50 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