VFS_AIO_FORK(8) System Administration tools VFS_AIO_FORK(8)

NAME

vfs_aio_fork - implement async I/O in Samba vfs

SYNOPSIS

vfs objects = aio_fork

DESCRIPTION

This VFS module is part of the samba(7) suite.

The aio_fork VFS module enables async I/O for Samba on platforms
where the system level Posix AIO interface is insufficient. Posix AIO
can suffer from severe limitations. For example, on some Linux
versions the real-time signals that it uses are broken under heavy
load. Other systems only allow AIO when special kernel modules are
loaded or only allow a certain system-wide amount of async requests
being scheduled. Systems based on glibc (most Linux systems) only
allow a single outstanding request per file descriptor.

To work around all these limitations, the aio_fork module was
written. It uses forked helper processes instead of the internal
Posix AIO interface to create asynchronousity for read and write
calls. It has no parameters, it will create helper processes when
async requests come in as needed. Idle helper processes will be
removed every 30 seconds.

This module is stackable.

EXAMPLES

Straight forward use:

[cooldata]
path = /data/ice
vfs objects = aio_fork

VERSION

This man page is part of version 4.18.11 of the Samba suite.

AUTHOR

The original Samba software and related utilities were created by
Andrew Tridgell. Samba is now developed by the Samba Team as an Open
Source project similar to the way the Linux kernel is developed.

Samba 4.18.11 03/13/2024 VFS_AIO_FORK(8)