dax_cancel - cancel a command in a queue
cc [ flag... ] file... -ldax [ library...] #include <dax.h> dax_status_t dax_cancel(dax_queue_t *queue, void *udata);
This function cancels the oldest command posted in queue whose udata matches udata. The cancelled command completes with a dax_poll_t status of DAX_ECANCEL. The destination buffer may have partial results.
If it finds a matching command that is complete, the status of the command is not changed to DAX_ECANCEL.
Returns one of the following values:
A command with matching udata is found. The command completed or was cancelled.
No command with matching udata found
The calling thread did not create the queue
Unknown internal error. Caller must stop using ctx.
See attributes(7) for descriptions of the following attributes:
|
libdax(3LIB), dax_post(3DAX), dax_poll(3DAX)
A cancelled command must be reaped by using the dax_poll() function.