io_uring: support to inject result for NOP
PATCH 1/1 io_uring: support to inject result for NOP
Support to inject result for NOP so that we can inject failure from userspace. It is very helpful for covering failure handling code in io_uring core change.
With nop flags, it could be possible to add more test feature for NOP in future, but the NOP behavior of direct completion has to be kept.
Cleared NOP SQE is required, look both liburing and Rust io-uring crate clears SQE, and it shouldn't be one big deal for raw, especially it is just NOP.
--- include/uapi/linux/io_uring.h | 13 ++++++++++++- io_uring/nop.c | 28 ++++++++++++++++++++++++---- 2 files changed, 36 insertions(+), 5 deletions(-)
include/uapi/linux/io_uring.h +12 -1
@@ -48,7 +48,10 @@ struct io_uring_sqe {__u32 optname; }; }; -__u32 len;/* buffer size or number of iovecs */ +union { +__u32 len;/* buffer size or number of iovecs */ +__s32 result;/* for NOP to inject result only */ + };union {__kernel_rwf_t rw_flags;__u32 fsync_flags;
@@ -72,6 +75,7 @@ struct io_uring_sqe {__u32 waitid_flags;__u32 futex_flags;__u32 install_fd_flags; +__u32 nop_flags; };__u64 user_data;/* data to be passed back at completion time */ /* pack this to avoid bogus arm OABI complaints */
@@ -413,6 +417,13 @@ enum io_uring_msg_ring_flags {*/ #define IORING_FIXED_FD_NO_CLOEXEC (1U << 0) +/* +* IORING_OP_NOP flags (sqe->nop_flags) +* +* IORING_NOP_INJECT_RESULT Inject result from sqe->result +*/ +#define IORING_NOP_INJECT_RESULT (1U << 0) +/* * IO completion data structure (Completion Queue Entry) */
io_uring/nop.c +24 -4
@@ -10,16 +10,36 @@#include "io_uring.h" #include "nop.h" +struct io_nop { +/* NOTE: kiocb has the file as the first member, so don't do it here */ +struct file *file; +unsigned int flags; +int result; +}; +int io_nop_prep (struct io_kiocb *req,const struct io_uring_sqe *sqe) { + struct io_nop *nop = io_kiocb_to_cmd(req, struct io_nop); +unsigned int flags; + + flags =READ_ONCE (sqe->nop_flags); +if (flags & ~IORING_NOP_INJECT_RESULT ) +return -EINVAL ; + + nop->flags = flags; +if (nop->flags &IORING_NOP_INJECT_RESULT ) + nop->result =READ_ONCE (sqe->result); +else + nop->result =0 ;return 0 ; } -/* -* IORING_OP_NOP just posts a completion event, nothing else. -*/ int io_nop (struct io_kiocb *req,unsigned int issue_flags) { -io_req_set_res (req,0 ,0 ); + struct io_nop *nop = io_kiocb_to_cmd(req, struct io_nop); + +if (nop->result <0 ) +req_set_fail (req); +io_req_set_res (req, nop->result,0 );return IOU_OK ; }
Signature · 1 line
2.44.0
Jens Axboe
maintainerQuoted 10 lines · Ming Lei
Support to inject result for NOP so that we can inject failure from userspace. It is very helpful for covering failure handling code in
io_uringcore change.With nop flags, it could be possible to add more test feature for NOP in future, but the NOP behavior of direct completion has to be kept.
Cleared NOP SQE is required, look both liburing and Rust io-uring crate clears SQE, and it shouldn't be one big deal for raw, especially it is just NOP.
I think this implementation looks fine, but probably would be best if you first had a prep patch that adds nop_flags to io_uring_sqe, and checks it in io_nop_prep() and fails if it's non-zero. Then we can mark that for stable, rather than need to do the whole thing.
Then patch 2 adds the actual meat of this patch, and now adds the proper check in io_nop_prep() for whether any unknown flags are set.
Quoted 5 lines
include/uapi/linux/io_uring.h +0
-0
include/uapi/linux/io_uring.h struct io_uring_sqe { · line 55
Quoted 9 lines
include/uapi/linux/io_uring.h +4
-1@@ -48,7 +48,10 @@ struct io_uring_sqe {__u32 optname; }; }; -__u32 len;/* buffer size or number of iovecs */ +union { +__u32 len;/* buffer size or number of iovecs */ +__s32 result;/* for NOP to inject result only */ + };union {
And I'd drop that, just use 'len' throughout.
Rest of the patch looks fine as-is.
Signature · 1 line
Jens Axboe
Quoted 37 lines · Jens Axboe
Quoted 10 lines · Ming Lei
Support to inject result for NOP so that we can inject failure from userspace. It is very helpful for covering failure handling code in
io_uringcore change.With nop flags, it could be possible to add more test feature for NOP in future, but the NOP behavior of direct completion has to be kept.
Cleared NOP SQE is required, look both liburing and Rust io-uring crate clears SQE, and it shouldn't be one big deal for raw, especially it is just NOP.
I think this implementation looks fine, but probably would be best if you first had a prep patch that adds
nop_flagstoio_uring_sqe, and checks it inio_nop_prep()and fails if it's non-zero. Then we can mark that for stable, rather than need to do the whole thing.Then patch 2 adds the actual meat of this patch, and now adds the proper check in
io_nop_prep()for whether any unknown flags are set.Quoted 5 lines
include/uapi/linux/io_uring.h +0
-0include/uapi/linux/io_uring.h struct io_uring_sqe { · line 55
Quoted 9 lines
include/uapi/linux/io_uring.h +4
-1@@ -48,7 +48,10 @@ struct io_uring_sqe {__u32 optname; }; }; -__u32 len;/* buffer size or number of iovecs */ +union { +__u32 len;/* buffer size or number of iovecs */ +__s32 result;/* for NOP to inject result only */ + };union {And I'd drop that, just use 'len' throughout.
Quoted 1 line
Rest of the patch looks fine as-is.
OK, will do both two in V2.
Thanks,
Ming