• Home
Name
Date
Size
#Lines
LOC

..--

.github/03-May-2024-236176

debian/03-May-2024-279217

examples/03-May-2024-903715

man/03-May-2024-10,8589,818

src/03-May-2024-3,9442,849

test/03-May-2024-31,94625,801

.gitignoreD03-May-2024301 3022

Android.bpD03-May-20241.3 KiB6156

CHANGELOGD03-May-20241.4 KiB3028

CITATION.cffD03-May-2024244 1211

COPYINGD03-May-202425.9 KiB503418

COPYING.GPLD03-May-202417.7 KiB340281

LICENSED03-May-20241 KiB2117

METADATAD03-May-2024324 1816

MODULE_LICENSE_MIT_LGPLD03-May-20240

MakefileD03-May-20242.2 KiB8566

Makefile.commonD03-May-2024256 76

Makefile.quietD03-May-2024237 129

NOTICED03-May-20241 KiB84

OWNERSD03-May-202439 32

READMED03-May-20242 KiB5940

SECURITY.mdD03-May-2024206 74

configureD03-May-202410.7 KiB488397

liburing.pc.inD03-May-2024233 1310

liburing.specD03-May-20241.7 KiB6755

make-debs.shD03-May-20241.7 KiB5425

README

1liburing
2--------
3
4This is the io_uring library, liburing. liburing provides helpers to setup and
5teardown io_uring instances, and also a simplified interface for
6applications that don't need (or want) to deal with the full kernel
7side implementation.
8
9For more info on io_uring, please see:
10
11https://kernel.dk/io_uring.pdf
12
13Subscribe to io-uring@vger.kernel.org for io_uring related discussions
14and development for both kernel and userspace. The list is archived here:
15
16https://lore.kernel.org/io-uring/
17
18
19kernel version dependency
20--------------------------
21
22liburing itself is not tied to any specific kernel release, and hence it's
23possible to use the newest liburing release even on older kernels (and vice
24versa). Newer features may only be available on more recent kernels,
25obviously.
26
27
28ulimit settings
29---------------
30
31io_uring accounts memory it needs under the rlimit memlocked option, which
32can be quite low on some setups (64K). The default is usually enough for
33most use cases, but bigger rings or things like registered buffers deplete
34it quickly. root isn't under this restriction, but regular users are. Going
35into detail on how to bump the limit on various systems is beyond the scope
36of this little blurb, but check /etc/security/limits.conf for user specific
37settings, or /etc/systemd/user.conf and /etc/systemd/system.conf for systemd
38setups. This affects 5.11 and earlier, new kernels are less dependent
39on RLIMIT_MEMLOCK as it is only used for registering buffers.
40
41
42Regressions tests
43-----------------
44
45The bulk of liburing is actually regression/unit tests for both liburing and
46the kernel io_uring support. Please note that this suite isn't expected to
47pass on older kernels, and may even crash or hang older kernels!
48
49
50License
51-------
52
53All software contained within this repo is dual licensed LGPL and MIT, see
54COPYING and LICENSE, except for a header coming from the kernel which is
55dual licensed GPL with a Linux-syscall-note exception and MIT, see
56COPYING.GPL and <https://spdx.org/licenses/Linux-syscall-note.html>.
57
58Jens Axboe 2022-05-19
59