Debian Codegraph @

upstream/opensuse-tumbleweed/man8/vfs_aio_pthread.8

raw
1 '\" t
2 .\" Title: vfs_aio_pthread
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: System Administration tools
7 .\" Source: Samba 4.23.8-git.477.f78166bceedSUSE-oS16.9-x86_64
8 .\" Language: English
9 .\"
10 .TH "VFS_AIO_PTHREAD" "8" "05/26/2026" "Samba 4\&.23\&.8\-git\&.477\&.f78166bcee" "System Administration tools"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 vfs_aio_pthread \- implement async open in Samba vfs using a pthread pool
32 .SH "SYNOPSIS"
33 .HP \w'\ 'u
34 vfs objects = aio_pthread
35 .SH "DESCRIPTION"
36 .PP
37 This VFS module is part of the
38 \fBsamba\fR(7)
39 suite\&.
40 .PP
41 The
42 aio_pthread
43 VFS module enables asynchronous opens (for new files) with
44 \m[blue]\fBaio_pthread:aio open = yes\fR\m[]
45 on platforms which have the pthreads API available, support the openat() syscall and support per thread credentials (modern Linux kernels)\&.
46 .PP
47 The module makes use of the global thread pool which uses the
48 \m[blue]\fBaio max threads\fR\m[]
49 option\&.
50 .PP
51 This module MUST be listed last in any module stack as the Samba VFS open interface is not thread\-safe\&. This module makes direct openat() system calls and does NOT call the Samba VFS open interfaces\&.
52 .SH "EXAMPLES"
53 .PP
54 Straight forward use:
55 .sp
56 .if n \{\
57 .RS 4
58 .\}
59 .nf
60 \fI[cooldata]\fR
61 \m[blue]\fBpath = /data/ice\fR\m[]
62 \m[blue]\fBvfs objects = aio_pthread\fR\m[]
63 \m[blue]\fBaio_pthread:aio open = yes\fR\m[]
64 .fi
65 .if n \{\
66 .RE
67 .\}
68 .SH "OPTIONS"
69 .PP
70 aio_pthread:aio open = BOOL
71 .RS 4
72 Try async opens for creating new files\&.
73 .sp
74 The default is \*(Aqno\*(Aq\&.
75 .RE
76 .SH "VERSION"
77 .PP
78 This man page is part of version 4\&.23\&.8\-git\&.477\&.f78166bceedSUSE\-oS16\&.9\-x86_64 of the Samba suite\&.
79 .SH "AUTHOR"
80 .PP
81 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\&.