FreeBSD manual
download PDF document: vfs_aio_fork.8.pdf
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.13.17 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.13.17 01/31/2022 VFS_AIO_FORK(8)