io_uring_free_buf_ring(3)	 liburing Manual       io_uring_free_buf_ring(3)

NAME
     io_uring_free_buf_ring  -	register  and  free  a	buffer ring for provided
     buffers

SYNOPSIS
     #include <liburing.h>

     int io_uring_free_buf_ring(struct io_uring *ring,
				struct io_uring_buf_ring *br,
				unsigned int nentries,
				int bgid);


DESCRIPTION
     The io_uring_free_buf_ring(3) function unregisters a previously  registered
     shared buffer ring. The ring must have heen previously returned from io_ur-
     ing_setup_buf_ring(3).

     The  ring	argument  must pointer to the ring for which the provided buffer
     ring is being registered, br must point to a  buffer  ring	 previously  re-
     turned by io_uring_setup_buf_ring(3), nentries is the number of entries re-
     quested  in  the  buffer  ring, and bgid is the buffer group ID that br was
     setup with.

     Under the covers, this function uses io_uring_unregister_buf_ring(3) to un-
     register the ring, and handles the freeing of the ring rather than	 letting
     the application open code it.

     Available since 5.19.


RETURN VALUE
     On	 success  io_uring_free_buf_ring(3)  returns zero. On failure it returns
     -errno.

SEE ALSO
     io_uring_setup_buf_ring(3)

liburing-2.4			  Mar 07, 2023	       io_uring_free_buf_ring(3)