liburing icon indicating copy to clipboard operation
liburing copied to clipboard

man/io_uring.7 page says cqe flags isn't used yet

Open FrankReh opened this issue 3 years ago • 3 comments

FrankReh avatar Sep 07 '22 11:09 FrankReh

What's the problem?

alviroiskandar avatar Sep 07 '22 11:09 alviroiskandar

The io_uring.h already defines four bits for cqe->flags, and in one mode, even carries a buffer id. That becomes clear when one reads enough of the liburing man pages or looks at the header file itself but the io_uring man page has outdated information about this flags field still being unused. I wouldn't propose to know how much detail should be added but I can say it is confusing and probably wrong the way it is written now.

The flags field could carry request-specific metadata in the future, but is currently unused.

FrankReh avatar Sep 07 '22 13:09 FrankReh

Yes, that is out of date. There are a few flags there now, just only documented in the man pages where they are relevant. Should all be in io_uring.7 as well, though.

axboe avatar Sep 08 '22 02:09 axboe