diff options
| author | Andres Freund <andres@anarazel.de> | 2025-03-18 14:40:05 -0400 |
|---|---|---|
| committer | Andres Freund <andres@anarazel.de> | 2025-03-26 19:49:13 -0400 |
| commit | c325a7633fcb33dbd73f46ddbbe91e95ddf3b227 (patch) | |
| tree | 0aa7ab5b32bd5dd26eef0aff6b4d4b200a771d75 /doc/src | |
| parent | 8eadd5c73c44708ecd45b9fd3ac54a550511d16f (diff) | |
| download | postgresql-c325a7633fcb33dbd73f46ddbbe91e95ddf3b227.tar.gz postgresql-c325a7633fcb33dbd73f46ddbbe91e95ddf3b227.zip | |
aio: Add io_method=io_uring
Performing AIO using io_uring can be considerably faster than
io_method=worker, particularly when lots of small IOs are issued, as
a) the context-switch overhead for worker based AIO becomes more significant
b) the number of IO workers can become limiting
io_uring, however, is linux specific and requires an additional compile-time
dependency (liburing).
This implementation is fairly simple and there are substantial optimization
opportunities.
The description of the existing AIO_IO_COMPLETION wait event is updated to
make the difference between it and the new AIO_IO_URING_EXECUTION clearer.
Reviewed-by: Noah Misch <noah@leadboat.com>
Reviewed-by: Jakub Wartak <jakub.wartak@enterprisedb.com>
Discussion: https://postgr.es/m/uvrtrknj4kdytuboidbhwclo4gxhswwcpgadptsjvjqcluzmah%40brqs62irg4dt
Discussion: https://postgr.es/m/20210223100344.llw5an2aklengrmn@alap3.anarazel.de
Discussion: https://postgr.es/m/stj36ea6yyhoxtqkhpieia2z4krnam7qyetc57rfezgk4zgapf@gcnactj4z56m
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/config.sgml | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 69fc93dffc4..f86135fbe1d 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -2712,6 +2712,14 @@ include_dir 'conf.d' </listitem> <listitem> <para> + <literal>io_uring</literal> (execute asynchronous I/O using + io_uring, requires a build with + <link linkend="configure-option-with-liburing"><option>--with-liburing</option></link> / + <link linkend="configure-with-liburing-meson"><option>-Dliburing</option></link>) + </para> + </listitem> + <listitem> + <para> <literal>sync</literal> (execute asynchronous-eligible I/O synchronously) </para> </listitem> |