io_uring_prep_remove_buffers(3)

io_uring_prep_remove_buffers3

Prepare a remove buffers request

Usage

#include <liburing.h>

void io_uring_prep_remove_buffers(struct io_uring_sqe *sqe, int nr, int bgid);

Overview

The io_uring_prep_remove_buffers(3) function prepares a request for removing previously supplied buffers. The submission queue entry sqe is setup to remove nr number of buffers from the buffer group ID indicated by bgid.

Return value

None

Errors

These are the errors that are reported in the CQE res field. On success, res will contain the number of successfully removed buffers. On error, the following errors can occur.

-ENOMEM

The kernel was unable to allocate memory for the request.

-EINVAL

One of the fields set in the SQE was invalid.

-ENOENT

No buffers exist at the specified bgid buffer group ID.

Releases

Unchanged in 3 releases since Debian 12 (Bookworm).

  1. 12–Arch

From liburing 2.15-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.