1VFS_IO_URING(8)           System Administration tools          VFS_IO_URING(8)
2
3
4

NAME

6       vfs_io_uring - Implement async io in Samba vfs using io_uring of Linux
7       (>= 5.1).
8

SYNOPSIS

10       vfs objects = io_uring
11

DESCRIPTION

13       This VFS module is part of the samba(7) suite.
14
15       The io_uring VFS module enables asynchronous pread, pwrite and fsync
16       using the io_uring infrastructure of Linux (>= 5.1). This provides much
17       less overhead compared to the usage of the pthreadpool for async io.
18
19       This module SHOULD be listed last in any module stack as it requires
20       real kernel file descriptors.
21

EXAMPLES

23       Straight forward use:
24
25                   [cooldata]
26                path = /data/ice
27                vfs objects = io_uring
28

OPTIONS

30       io_uring:num_entries = NUMBER_OF_QUEUE_ENTRIES
31           The number of entries in the submission queue. The maximum allowed
32           value depends on the kernel version and the kernel will roundup the
33           value to a power of 2.
34
35           The default is '128'.
36
37       io_uring:sqpoll = BOOL
38           Use the IORING_SETUP_SQPOLL feature.
39
40           The default is 'no'.
41

SEE ALSO

43       io_uring_setup(2).
44

VERSION

46       This man page is part of version 4.17.5 of the Samba suite.
47

AUTHOR

49       The original Samba software and related utilities were created by
50       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
51       Source project similar to the way the Linux kernel is developed.
52
53
54
55Samba 4.17.5                      01/26/2023                   VFS_IO_URING(8)
Impressum