aiocancel(3c)

1aiocancel(3C)            Standard C Library Functions            aiocancel(3C)
2
3
4

NAME

6       aiocancel - cancel an asynchronous operation
7

SYNOPSIS

9       #include <sys/asynch.h>
10
11       int aiocancel(aio_result_t *resultp);
12
13

DESCRIPTION

15       aiocancel()  cancels  the  asynchronous  operation  associated with the
16       result buffer pointed to by resultp. It may not be possible to  immedi‐
17       ately  cancel  an operation which is in progress and in this case, aio‐
18       cancel() will not wait to cancel it.
19
20
21       Upon successful completion, aiocancel() returns  0  and  the  requested
22       operation  is  cancelled.   The  application will not receive the SIGIO
23       completion signal for an asynchronous operation  that  is  successfully
24       cancelled.
25

RETURN VALUES

27       Upon  successful  completion, aiocancel() returns 0. Upon failure, aio‐
28       cancel() returns −1 and sets errno to indicate the error.
29

ERRORS

31       aiocancel() will fail if any of the following are true:
32
33       EACCES    The parameter resultp does not correspond to any  outstanding
34                 asynchronous  operation,  although there is at least one cur‐
35                 rently outstanding.
36
37
38       EFAULT    resultp points to an address outside the address space of the
39                 requesting process.  See NOTES.
40
41
42       EINVAL    There are not any outstanding requests to cancel.
43
44

ATTRIBUTES

46       See attributes(5) for descriptions of the following attributes:
47
48
49
50
51       ┌─────────────────────────────┬─────────────────────────────┐
52       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
53       ├─────────────────────────────┼─────────────────────────────┤
54       │MT-Level                     │Safe                         │
55       └─────────────────────────────┴─────────────────────────────┘
56

NOTES

61       Passing  an  illegal address as resultp will result in setting errno to
62       EFAULT only if it is detected by the application process.
63
64
65
66SunOS 5.11                        5 Feb 1997                     aiocancel(3C)