io_destroy.2: Improve description

The description was rather vague, citing a "list of I/O contexts"
and stating that it "can" cancel outstanding requests.  This
update makes things more concrete so that the reader knows exactly
what's going on.

Signed-off-by: Jeff Moyer <jmoyer@redhat.com>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Jeff Moyer 2013-04-08 12:01:53 +02:00 committed by Michael Kerrisk
parent 3d083fa4de
commit 1d79f88e2e
1 changed files with 6 additions and 7 deletions

View File

@ -4,7 +4,7 @@
.\" This file is distributed according to the GNU General Public License.
.\" %%%LICENSE_END
.\"
.TH IO_DESTROY 2 2012-07-13 "Linux" "Linux Programmer's Manual"
.TH IO_DESTROY 2 2013-04-08 "Linux" "Linux Programmer's Manual"
.SH NAME
io_destroy \- destroy an asynchronous I/O context
.SH SYNOPSIS
@ -21,12 +21,11 @@ There is no glibc wrapper for this system call; see NOTES.
The
.BR io_destroy ()
system call
removes the asynchronous I/O context specified by
.I ctx_id
from the list of
I/O contexts and then destroys it.
It can also cancel any outstanding asynchronous I/O
actions on \fIctx_id\fP and block on completion.
will attempt to cancel all outstanding asynchronous I/O operations against
.IR ctx_id ,
will block on the completion of all operations
that could not be cancelled, and will destroy the
.IR ctx_id .
.SH RETURN VALUE
On success,
.BR io_destroy ()