Introduce io_max_combine_limit.
authorThomas Munro <tmunro@postgresql.org>
Tue, 18 Mar 2025 22:40:56 +0000 (11:40 +1300)
committerThomas Munro <tmunro@postgresql.org>
Wed, 19 Mar 2025 02:23:54 +0000 (15:23 +1300)
commit10f6646847515b1ab02735c24b04abaf1996f65f
treee49ca63aec12d99997f4fa91a6d4e3a11dbbe858
parent17d8bba6dad12e14a7cafca9ef5eef21e577e9c3
Introduce io_max_combine_limit.

The existing io_combine_limit can be changed by users.  The new
io_max_combine_limit is fixed at server startup time, and functions as a
silent clamp on the user setting.  That in itself is probably quite
useful, but the primary motivation is:

aio_init.c allocates shared memory for all asynchronous IOs including
some per-block data, and we didn't want to waste memory you'd never used
by assuming they could be up to PG_IOV_MAX.  This commit already halves
the size of 'AioHandleIov' and 'AioHandleData'.  A follow-up commit can
now expand PG_IOV_MAX without affecting that.

Since our GUC system doesn't support dependencies or cross-checks
between GUCs, the user-settable one now assigns a "raw" value to
io_combine_limit_guc, and the lower of io_combine_limit_guc and
io_max_combine_limit is maintained in io_combine_limit.

Reviewed-by: Andres Freund <andres@anarazel.de> (earlier version)
Discussion: https://postgr.es/m/CA%2BhUKG%2B2T9p-%2BzM6Eeou-RAJjTML6eit1qn26f9twznX59qtCA%40mail.gmail.com
doc/src/sgml/config.sgml
src/backend/commands/variable.c
src/backend/storage/aio/aio_init.c
src/backend/storage/buffer/bufmgr.c
src/backend/utils/misc/guc_tables.c
src/backend/utils/misc/postgresql.conf.sample
src/include/storage/bufmgr.h
src/include/utils/guc_hooks.h