Add support for basic NUMA awareness
authorTomas Vondra <tomas.vondra@postgresql.org>
Mon, 7 Apr 2025 20:51:49 +0000 (22:51 +0200)
committerTomas Vondra <tomas.vondra@postgresql.org>
Mon, 7 Apr 2025 21:08:17 +0000 (23:08 +0200)
commit65c298f61fc70f2f960437c05649f71b862e2c48
treec6f990de6bee1ab4c8b01f18c9e9b8f44e9dcc7c
parent17bcf4f5450430f67b744c225566c9e0e6413e95
Add support for basic NUMA awareness

Add basic NUMA awareness routines, using a minimal src/port/pg_numa.c
portability wrapper and an optional build dependency, enabled by
--with-libnuma configure option. For now this is Linux-only, other
platforms may be supported later.

A built-in SQL function pg_numa_available() allows checking NUMA
support, i.e. that the server was built/linked with the NUMA library.

The main function introduced is pg_numa_query_pages(), which allows
determining the NUMA node for individual memory pages. Internally the
function uses move_pages(2) syscall, as it allows batching, and is more
efficient than get_mempolicy(2).

Author: Jakub Wartak <jakub.wartak@enterprisedb.com>
Co-authored-by: Bertrand Drouvot <bertranddrouvot.pg@gmail.com>
Reviewed-by: Andres Freund <andres@anarazel.de>
Reviewed-by: Álvaro Herrera <alvherre@alvh.no-ip.org>
Reviewed-by: Tomas Vondra <tomas@vondra.me>
Discussion: https://postgr.es/m/CAKZiRmxh6KWo0aqRqvmcoaX2jUxZYb4kGp3N%3Dq1w%2BDiH-696Xw%40mail.gmail.com
18 files changed:
.cirrus.tasks.yml
configure
configure.ac
doc/src/sgml/func.sgml
doc/src/sgml/installation.sgml
meson.build
meson_options.txt
src/Makefile.global.in
src/backend/utils/misc/guc_tables.c
src/include/catalog/catversion.h
src/include/catalog/pg_proc.dat
src/include/pg_config.h.in
src/include/port/pg_numa.h [new file with mode: 0644]
src/include/storage/pg_shmem.h
src/makefiles/meson.build
src/port/Makefile
src/port/meson.build
src/port/pg_numa.c [new file with mode: 0644]