• Jens Axboe's avatar
    io_uring/rw: add support for IORING_OP_READ_MULTISHOT · fc68fcda
    Jens Axboe authored
    This behaves like IORING_OP_READ, except:
    
    1) It only supports pollable files (eg pipes, sockets, etc). Note that
       for sockets, you probably want to use recv/recvmsg with multishot
       instead.
    
    2) It supports multishot mode, meaning it will repeatedly trigger a
       read and fill a buffer when data is available. This allows similar
       use to recv/recvmsg but on non-sockets, where a single request will
       repeatedly post a CQE whenever data is read from it.
    
    3) Because of #2, it must be used with provided buffers. This is
       uniformly true across any request type that supports multishot and
       transfers data, with the reason being that it's obviously not
       possible to pass in a single buffer for the data, as multiple reads
       may very well trigger before an application has a chance to process
       previous CQEs and the data passed from them.
    Reviewed-by: default avatarGabriel Krisman Bertazi <krisman@suse.de>
    Signed-off-by: default avatarJens Axboe <axboe@kernel.dk>
    fc68fcda
rw.h 921 Bytes