• Home
Name Date Size #Lines LOC

..--

debian/03-May-2024-279217

examples/03-May-2024-891706

man/03-May-2024-2,8852,703

src/03-May-2024-2,3541,666

test/03-May-2024-24,32919,587

.gitignoreD03-May-20242.2 KiB131124

.travis.ymlD03-May-2024390 2322

Android.bpD03-May-20241.2 KiB5550

COPYINGD03-May-202425.9 KiB503418

COPYING.GPLD03-May-202417.7 KiB340281

LICENSED03-May-20241 KiB84

METADATAD03-May-2024323 1816

MODULE_LICENSE_MIT_LGPLD03-May-20240

MakefileD03-May-20242.2 KiB8567

Makefile.quietD03-May-2024237 129

NOTICED03-May-20241 KiB84

OWNERSD03-May-202439 32

READMED03-May-20241.6 KiB4733

configureD03-May-20248.3 KiB381308

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
19ulimit settings
20---------------
21
22io_uring accounts memory it needs under the rlimit memlocked option, which
23can be quite low on some setups (64K). The default is usually enough for
24most use cases, but bigger rings or things like registered buffers deplete
25it quickly. root isn't under this restriction, but regular users are. Going
26into detail on how to bump the limit on various systems is beyond the scope
27of this little blurb, but check /etc/security/limits.conf for user specific
28settings, or /etc/systemd/user.conf and /etc/systemd/system.conf for systemd
29setups.
30
31Regressions tests
32-----------------
33
34The bulk of liburing is actually regression/unit tests for both liburing and
35the kernel io_uring support. Please note that this suite isn't expected to
36pass on older kernels, and may even crash or hang older kernels!
37
38License
39-------
40
41All software contained within this repo is dual licensed LGPL and MIT, see
42COPYING and LICENSE, except for a header coming from the kernel which is
43dual licensed GPL with a Linux-syscall-note exception and MIT, see
44COPYING.GPL and <https://spdx.org/licenses/Linux-syscall-note.html>.
45
46Jens Axboe 2020-01-20
47