1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2015-01-23 22:24+0900\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: build/C/man7/aio.7:26
26 #: build/C/man7/aio.7:26
32 #: build/C/man7/aio.7:26 build/C/man3/aio_init.3:26 build/C/man2/io_cancel.2:7 build/C/man2/io_destroy.2:7 build/C/man2/io_getevents.2:7 build/C/man2/io_setup.2:7 build/C/man2/io_submit.2:7
38 #: build/C/man7/aio.7:26 build/C/man3/aio_cancel.3:24 build/C/man3/aio_error.3:24 build/C/man3/aio_fsync.3:24 build/C/man3/aio_init.3:26 build/C/man3/aio_read.3:24 build/C/man3/aio_return.3:24 build/C/man3/aio_suspend.3:25 build/C/man3/aio_write.3:24 build/C/man2/io_cancel.2:7 build/C/man2/io_destroy.2:7 build/C/man2/io_getevents.2:7 build/C/man2/io_setup.2:7 build/C/man2/io_submit.2:7 build/C/man3/lio_listio.3:24
40 msgid "Linux Programmer's Manual"
44 #: build/C/man7/aio.7:27 build/C/man3/aio_cancel.3:25 build/C/man3/aio_error.3:25 build/C/man3/aio_fsync.3:25 build/C/man3/aio_init.3:27 build/C/man3/aio_read.3:25 build/C/man3/aio_return.3:25 build/C/man3/aio_suspend.3:26 build/C/man3/aio_write.3:25 build/C/man2/io_cancel.2:8 build/C/man2/io_destroy.2:8 build/C/man2/io_getevents.2:8 build/C/man2/io_setup.2:8 build/C/man2/io_submit.2:8 build/C/man3/lio_listio.3:25
50 #: build/C/man7/aio.7:29
51 msgid "aio - POSIX asynchronous I/O overview"
55 #: build/C/man7/aio.7:29 build/C/man3/aio_cancel.3:33 build/C/man3/aio_error.3:33 build/C/man3/aio_fsync.3:33 build/C/man3/aio_init.3:38 build/C/man3/aio_read.3:33 build/C/man3/aio_return.3:33 build/C/man3/aio_suspend.3:39 build/C/man3/aio_write.3:33 build/C/man2/io_cancel.2:20 build/C/man2/io_destroy.2:19 build/C/man2/io_getevents.2:22 build/C/man2/io_setup.2:19 build/C/man2/io_submit.2:20 build/C/man3/lio_listio.3:36
61 #: build/C/man7/aio.7:37
63 "The POSIX asynchronous I/O (AIO) interface allows applications to initiate "
64 "one or more I/O operations that are performed asynchronously (i.e., in the "
65 "background). The application can elect to be notified of completion of the "
66 "I/O operation in a variety of ways: by delivery of a signal, by "
67 "instantiation of a thread, or no notification at all."
71 #: build/C/man7/aio.7:39
72 msgid "The POSIX AIO interface consists of the following functions:"
76 #: build/C/man7/aio.7:39
78 msgid "B<aio_read>(3)"
82 #: build/C/man7/aio.7:44
83 msgid "Enqueue a read request. This is the asynchronous analog of B<read>(2)."
87 #: build/C/man7/aio.7:44
89 msgid "B<aio_write>(3)"
93 #: build/C/man7/aio.7:49
94 msgid "Enqueue a write request. This is the asynchronous analog of B<write>(2)."
98 #: build/C/man7/aio.7:49
100 msgid "B<aio_fsync>(3)"
104 #: build/C/man7/aio.7:56
106 "Enqueue a sync request for the I/O operations on a file descriptor. This is "
107 "the asynchronous analog of B<fsync>(2) and B<fdatasync>(2)."
111 #: build/C/man7/aio.7:56
113 msgid "B<aio_error>(3)"
117 #: build/C/man7/aio.7:59
118 msgid "Obtain the error status of an enqueued I/O request."
122 #: build/C/man7/aio.7:59
124 msgid "B<aio_return>(3)"
128 #: build/C/man7/aio.7:62
129 msgid "Obtain the return status of a completed I/O request."
133 #: build/C/man7/aio.7:62
135 msgid "B<aio_suspend>(3)"
139 #: build/C/man7/aio.7:66
141 "Suspend the caller until one or more of a specified set of I/O requests "
146 #: build/C/man7/aio.7:66
148 msgid "B<aio_cancel>(3)"
152 #: build/C/man7/aio.7:70
153 msgid "Attempt to cancel outstanding I/O requests on a specified file descriptor."
157 #: build/C/man7/aio.7:70
159 msgid "B<lio_listio>(3)"
163 #: build/C/man7/aio.7:73
164 msgid "Enqueue multiple I/O requests using a single function call."
168 #: build/C/man7/aio.7:80
170 "The I<aiocb> (\"asynchronous I/O control block\") structure defines "
171 "parameters that control an I/O operation. An argument of this type is "
172 "employed with all of the functions listed above. This structure has the "
177 #: build/C/man7/aio.7:84
179 msgid "#include E<lt>aiocb.hE<gt>\n"
183 #: build/C/man7/aio.7:87
187 " /* The order of these fields is implementation-dependent */\n"
191 #: build/C/man7/aio.7:96
194 " int aio_fildes; /* File descriptor */\n"
195 " off_t aio_offset; /* File offset */\n"
196 " volatile void *aio_buf; /* Location of buffer */\n"
197 " size_t aio_nbytes; /* Length of transfer */\n"
198 " int aio_reqprio; /* Request priority */\n"
199 " struct sigevent aio_sigevent; /* Notification method */\n"
200 " int aio_lio_opcode; /* Operation to be performed;\n"
201 " lio_listio() only */\n"
205 #: build/C/man7/aio.7:99
208 " /* Various implementation-internal fields not shown */\n"
213 #: build/C/man7/aio.7:101
215 msgid "/* Operation codes for \\(aqaio_lio_opcode\\(aq: */\n"
219 #: build/C/man7/aio.7:103
221 msgid "enum { LIO_READ, LIO_WRITE, LIO_NOP };\n"
225 #: build/C/man7/aio.7:107
226 msgid "The fields of this structure are as follows:"
230 #: build/C/man7/aio.7:107
232 msgid "I<aio_filedes>"
236 #: build/C/man7/aio.7:110
237 msgid "The file descriptor on which the I/O operation is to be performed."
241 #: build/C/man7/aio.7:110
243 msgid "I<aio_offset>"
247 #: build/C/man7/aio.7:113
248 msgid "This is the file offset at which the I/O operation is to be performed."
252 #: build/C/man7/aio.7:113
258 #: build/C/man7/aio.7:116
259 msgid "This is the buffer used to transfer data for a read or write operation."
263 #: build/C/man7/aio.7:116
265 msgid "I<aio_nbytes>"
269 #: build/C/man7/aio.7:120
270 msgid "This is the size of the buffer pointed to by I<aio_buf>."
274 #: build/C/man7/aio.7:120
276 msgid "I<aio_reqprio>"
280 #: build/C/man7/aio.7:129
282 "This field specifies a value that is subtracted from the calling thread's "
283 "real-time priority in order to determine the priority for execution of this "
284 "I/O request (see B<pthread_setschedparam>(3)). The specified value must be "
285 "between 0 and the value returned by I<sysconf(_SC_AIO_PRIO_DELTA_MAX)>. "
286 "This field is ignored for file synchronization operations."
290 #: build/C/man7/aio.7:129
292 msgid "I<aio_sigevent>"
296 #: build/C/man7/aio.7:143
298 "This field is a structure that specifies how the caller is to be notified "
299 "when the asynchronous I/O operation completes. Possible values for "
300 "I<aio_sigevent.sigev_notify> are B<SIGEV_NONE>, B<SIGEV_SIGNAL>, and "
301 "B<SIGEV_THREAD>. See B<sigevent>(7) for further details."
305 #: build/C/man7/aio.7:143
307 msgid "I<aio_lio_opcode>"
311 #: build/C/man7/aio.7:147
312 msgid "The type of operation to be performed; used only for B<lio_listio>(3)."
316 #: build/C/man7/aio.7:150
318 "In addition to the standard functions listed above, the GNU C library "
319 "provides the following extension to the POSIX AIO API:"
323 #: build/C/man7/aio.7:150
325 msgid "B<aio_init>(3)"
329 #: build/C/man7/aio.7:153
331 "Set parameters for tuning the behavior of the glibc POSIX AIO "
336 #: build/C/man7/aio.7:153 build/C/man3/aio_cancel.3:101 build/C/man3/aio_error.3:66 build/C/man3/aio_fsync.3:79 build/C/man3/aio_read.3:103 build/C/man3/aio_return.3:63 build/C/man3/aio_suspend.3:88 build/C/man3/aio_write.3:110 build/C/man2/io_cancel.2:42 build/C/man2/io_destroy.2:34 build/C/man2/io_getevents.2:40 build/C/man2/io_setup.2:37 build/C/man2/io_submit.2:37 build/C/man3/lio_listio.3:146
342 #: build/C/man7/aio.7:154 build/C/man3/aio_error.3:67 build/C/man3/aio_fsync.3:87 build/C/man3/aio_read.3:111 build/C/man3/aio_return.3:64 build/C/man3/aio_write.3:122 build/C/man2/io_cancel.2:49 build/C/man2/io_destroy.2:38 build/C/man2/io_getevents.2:44 build/C/man2/io_setup.2:46 build/C/man2/io_submit.2:47 build/C/man3/lio_listio.3:161
348 #: build/C/man7/aio.7:163
350 "The I<aio_reqprio> field of the I<aiocb> structure was less than 0, or was "
351 "greater than the limit returned by the call "
352 "I<sysconf(_SC_AIO_PRIO_DELTA_MAX)>."
356 #: build/C/man7/aio.7:163 build/C/man3/aio_cancel.3:110 build/C/man3/aio_error.3:78 build/C/man3/aio_fsync.3:99 build/C/man3/aio_init.3:93 build/C/man3/aio_read.3:128 build/C/man3/aio_return.3:73 build/C/man3/aio_suspend.3:103 build/C/man3/aio_write.3:133 build/C/man2/io_cancel.2:56 build/C/man2/io_destroy.2:45 build/C/man2/io_getevents.2:57 build/C/man2/io_setup.2:58 build/C/man2/io_submit.2:60 build/C/man3/lio_listio.3:201
362 #: build/C/man7/aio.7:165
363 msgid "The POSIX AIO interfaces are provided by glibc since version 2.1."
367 #: build/C/man7/aio.7:165 build/C/man3/aio_cancel.3:114 build/C/man3/aio_error.3:87 build/C/man3/aio_fsync.3:103 build/C/man3/aio_init.3:97 build/C/man3/aio_read.3:132 build/C/man3/aio_return.3:82 build/C/man3/aio_suspend.3:107 build/C/man3/aio_write.3:137 build/C/man2/io_cancel.2:59 build/C/man2/io_destroy.2:48 build/C/man2/io_getevents.2:60 build/C/man2/io_setup.2:61 build/C/man2/io_submit.2:63 build/C/man3/lio_listio.3:205
369 msgid "CONFORMING TO"
373 #: build/C/man7/aio.7:167 build/C/man3/aio_cancel.3:116 build/C/man3/aio_error.3:89 build/C/man3/aio_fsync.3:105 build/C/man3/aio_read.3:134 build/C/man3/aio_return.3:84 build/C/man3/aio_suspend.3:109 build/C/man3/aio_write.3:139 build/C/man3/lio_listio.3:207
374 msgid "POSIX.1-2001, POSIX.1-2008."
378 #: build/C/man7/aio.7:167 build/C/man3/aio_read.3:134 build/C/man3/aio_suspend.3:109 build/C/man3/aio_write.3:139 build/C/man2/io_cancel.2:64 build/C/man2/io_destroy.2:53 build/C/man2/io_getevents.2:65 build/C/man2/io_setup.2:66 build/C/man2/io_submit.2:68 build/C/man3/lio_listio.3:207
384 #: build/C/man7/aio.7:174
386 "It is a good idea to zero out the control block buffer before use (see "
387 "B<memset>(3)). The control block buffer and the buffer pointed to by "
388 "I<aio_buf> must not be changed while the I/O operation is in progress. "
389 "These buffers must remain valid until the I/O operation completes."
393 #: build/C/man7/aio.7:178
395 "Simultaneous asynchronous read or write operations using the same I<aiocb> "
396 "structure yield undefined results."
399 #. http://lse.sourceforge.net/io/aio.html
400 #. http://lse.sourceforge.net/io/aionotes.txt
401 #. http://lwn.net/Articles/148755/
403 #: build/C/man7/aio.7:196
405 "The current Linux POSIX AIO implementation is provided in user space by "
406 "glibc. This has a number of limitations, most notably that maintaining "
407 "multiple threads to perform I/O operations is expensive and scales poorly. "
408 "Work has been in progress for some time on a kernel state-machine-based "
409 "implementation of asynchronous I/O (see B<io_submit>(2), B<io_setup>(2), "
410 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2)), but this "
411 "implementation hasn't yet matured to the point where the POSIX AIO "
412 "implementation can be completely reimplemented using the kernel system "
417 #: build/C/man7/aio.7:196 build/C/man3/aio_cancel.3:116 build/C/man3/aio_error.3:89 build/C/man3/aio_read.3:146 build/C/man3/aio_return.3:84
423 #: build/C/man7/aio.7:209
425 "The program below opens each of the files named in its command-line "
426 "arguments and queues a request on the resulting file descriptor using "
427 "B<aio_read>(3). The program then loops, periodically monitoring each of the "
428 "I/O operations that is still in progress using B<aio_error>(3). Each of the "
429 "I/O requests is set up to provide notification by delivery of a signal. "
430 "After all I/O requests have completed, the program retrieves their status "
431 "using B<aio_return>(3)."
435 #: build/C/man7/aio.7:215
437 "The B<SIGQUIT> signal (generated by typing control-\\e) causes the program "
438 "to request cancellation of each of the outstanding requests using "
443 #: build/C/man7/aio.7:220
445 "Here is an example of what we might see when running this program. In this "
446 "example, the program queues two requests to standard input, and these are "
447 "satisfied by two lines of input containing \"abc\" and \"x\"."
451 #: build/C/man7/aio.7:244
454 "$ B<./a.out /dev/stdin /dev/stdin>\n"
455 "opened /dev/stdin on descriptor 3\n"
456 "opened /dev/stdin on descriptor 4\n"
458 " for request 0 (descriptor 3): In progress\n"
459 " for request 1 (descriptor 4): In progress\n"
461 "I/O completion signal received\n"
463 " for request 0 (descriptor 3): I/O succeeded\n"
464 " for request 1 (descriptor 4): In progress\n"
466 " for request 1 (descriptor 4): In progress\n"
468 "I/O completion signal received\n"
470 " for request 1 (descriptor 4): I/O succeeded\n"
471 "All I/O requests completed\n"
473 " for request 0 (descriptor 3): 4\n"
474 " for request 1 (descriptor 4): 2\n"
478 #: build/C/man7/aio.7:246
480 msgid "Program source"
484 #: build/C/man7/aio.7:255
487 "#include E<lt>stdlib.hE<gt>\n"
488 "#include E<lt>unistd.hE<gt>\n"
489 "#include E<lt>stdio.hE<gt>\n"
490 "#include E<lt>errno.hE<gt>\n"
491 "#include E<lt>aio.hE<gt>\n"
492 "#include E<lt>signal.hE<gt>\n"
496 #: build/C/man7/aio.7:257
498 msgid "#define BUF_SIZE 20 /* Size of buffers for read operations */\n"
502 #: build/C/man7/aio.7:259
504 msgid "#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); } while (0)\n"
508 #: build/C/man7/aio.7:261
510 msgid "#define errMsg(msg) do { perror(msg); } while (0)\n"
514 #: build/C/man7/aio.7:268
517 "struct ioRequest { /* Application-defined structure for tracking\n"
521 " struct aiocb *aiocbp;\n"
526 #: build/C/man7/aio.7:272
529 "static volatile sig_atomic_t gotSIGQUIT = 0;\n"
530 " /* On delivery of SIGQUIT, we attempt to\n"
531 " cancel all outstanding I/O requests */\n"
535 #: build/C/man7/aio.7:278
538 "static void /* Handler for SIGQUIT */\n"
539 "quitHandler(int sig)\n"
546 #: build/C/man7/aio.7:280
548 msgid "#define IO_SIGNAL SIGUSR1 /* Signal used to notify I/O completion */\n"
552 #: build/C/man7/aio.7:285
555 "static void /* Handler for I/O completion signal */\n"
556 "aioSigHandler(int sig, siginfo_t *si, void *ucontext)\n"
558 " write(STDOUT_FILENO, \"I/O completion signal received\\en\", 31);\n"
562 #: build/C/man7/aio.7:291
565 " /* The corresponding ioRequest structure would be available as\n"
566 " struct ioRequest *ioReq = si-E<gt>si_value.sival_ptr;\n"
567 " and the file descriptor would then be available via\n"
568 " ioReq-E<gt>aiocbp-E<gt>aio_fildes */\n"
573 #: build/C/man7/aio.7:301
577 "main(int argc, char *argv[])\n"
579 " struct ioRequest *ioList;\n"
580 " struct aiocb *aiocbList;\n"
581 " struct sigaction sa;\n"
583 " int numReqs; /* Total number of queued I/O requests */\n"
584 " int openReqs; /* Number of I/O requests still in progress */\n"
588 #: build/C/man7/aio.7:307
591 " if (argc E<lt> 2) {\n"
592 " fprintf(stderr, \"Usage: %s E<lt>pathnameE<gt> "
593 "E<lt>pathnameE<gt>...\\en\",\n"
595 " exit(EXIT_FAILURE);\n"
600 #: build/C/man7/aio.7:309
602 msgid " numReqs = argc - 1;\n"
606 #: build/C/man7/aio.7:311
608 msgid " /* Allocate our arrays */\n"
612 #: build/C/man7/aio.7:315
615 " ioList = calloc(numReqs, sizeof(struct ioRequest));\n"
616 " if (ioList == NULL)\n"
617 " errExit(\"calloc\");\n"
621 #: build/C/man7/aio.7:319
624 " aiocbList = calloc(numReqs, sizeof(struct aiocb));\n"
625 " if (aiocbList == NULL)\n"
626 " errExit(\"calloc\");\n"
630 #: build/C/man7/aio.7:321
632 msgid " /* Establish handlers for SIGQUIT and the I/O completion signal */\n"
636 #: build/C/man7/aio.7:324
639 " sa.sa_flags = SA_RESTART;\n"
640 " sigemptyset(&sa.sa_mask);\n"
644 #: build/C/man7/aio.7:328
647 " sa.sa_handler = quitHandler;\n"
648 " if (sigaction(SIGQUIT, &sa, NULL) == -1)\n"
649 " errExit(\"sigaction\");\n"
653 #: build/C/man7/aio.7:333
656 " sa.sa_flags = SA_RESTART | SA_SIGINFO;\n"
657 " sa.sa_sigaction = aioSigHandler;\n"
658 " if (sigaction(IO_SIGNAL, &sa, NULL) == -1)\n"
659 " errExit(\"sigaction\");\n"
663 #: build/C/man7/aio.7:336
666 " /* Open each file specified on the command line, and queue\n"
667 " a read request on the resulting file descriptor */\n"
671 #: build/C/man7/aio.7:341
674 " for (j = 0; j E<lt> numReqs; j++) {\n"
675 " ioList[j].reqNum = j;\n"
676 " ioList[j].status = EINPROGRESS;\n"
677 " ioList[j].aiocbp = &aiocbList[j];\n"
681 #: build/C/man7/aio.7:347
684 " ioList[j].aiocbp-E<gt>aio_fildes = open(argv[j + 1], O_RDONLY);\n"
685 " if (ioList[j].aiocbp-E<gt>aio_fildes == -1)\n"
686 " errExit(\"open\");\n"
687 " printf(\"opened %s on descriptor %d\\en\", argv[j + 1],\n"
688 " ioList[j].aiocbp-E<gt>aio_fildes);\n"
692 #: build/C/man7/aio.7:351
695 " ioList[j].aiocbp-E<gt>aio_buf = malloc(BUF_SIZE);\n"
696 " if (ioList[j].aiocbp-E<gt>aio_buf == NULL)\n"
697 " errExit(\"malloc\");\n"
701 #: build/C/man7/aio.7:359
704 " ioList[j].aiocbp-E<gt>aio_nbytes = BUF_SIZE;\n"
705 " ioList[j].aiocbp-E<gt>aio_reqprio = 0;\n"
706 " ioList[j].aiocbp-E<gt>aio_offset = 0;\n"
707 " ioList[j].aiocbp-E<gt>aio_sigevent.sigev_notify = SIGEV_SIGNAL;\n"
708 " ioList[j].aiocbp-E<gt>aio_sigevent.sigev_signo = IO_SIGNAL;\n"
709 " ioList[j].aiocbp-E<gt>aio_sigevent.sigev_value.sival_ptr =\n"
714 #: build/C/man7/aio.7:364
717 " s = aio_read(ioList[j].aiocbp);\n"
719 " errExit(\"aio_read\");\n"
724 #: build/C/man7/aio.7:366
726 msgid " openReqs = numReqs;\n"
730 #: build/C/man7/aio.7:368
732 msgid " /* Loop, monitoring status of I/O requests */\n"
736 #: build/C/man7/aio.7:371
739 " while (openReqs E<gt> 0) {\n"
740 " sleep(3); /* Delay between each monitoring step */\n"
744 #: build/C/man7/aio.7:373
746 msgid " if (gotSIGQUIT) {\n"
750 #: build/C/man7/aio.7:377
753 " /* On receipt of SIGQUIT, attempt to cancel each of the\n"
754 " outstanding I/O requests, and display status returned\n"
755 " from the cancellation requests */\n"
759 #: build/C/man7/aio.7:379
761 msgid " printf(\"got SIGQUIT; canceling I/O requests: \\en\");\n"
765 #: build/C/man7/aio.7:396
768 " for (j = 0; j E<lt> numReqs; j++) {\n"
769 " if (ioList[j].status == EINPROGRESS) {\n"
770 " printf(\" Request %d on descriptor %d:\", j,\n"
771 " ioList[j].aiocbp-E<gt>aio_fildes);\n"
772 " s = aio_cancel(ioList[j].aiocbp-E<gt>aio_fildes,\n"
773 " ioList[j].aiocbp);\n"
774 " if (s == AIO_CANCELED)\n"
775 " printf(\"I/O canceled\\en\");\n"
776 " else if (s == AIO_NOTCANCELED)\n"
777 " printf(\"I/O not canceled\\en\");\n"
778 " else if (s == AIO_ALLDONE)\n"
779 " printf(\"I/O all done\\en\");\n"
781 " errMsg(\"aio_cancel\");\n"
787 #: build/C/man7/aio.7:399
795 #: build/C/man7/aio.7:402
798 " /* Check the status of each I/O request that is still\n"
803 #: build/C/man7/aio.7:409
806 " printf(\"aio_error():\\en\");\n"
807 " for (j = 0; j E<lt> numReqs; j++) {\n"
808 " if (ioList[j].status == EINPROGRESS) {\n"
809 " printf(\" for request %d (descriptor %d): \",\n"
810 " j, ioList[j].aiocbp-E<gt>aio_fildes);\n"
811 " ioList[j].status = aio_error(ioList[j].aiocbp);\n"
815 #: build/C/man7/aio.7:424
818 " switch (ioList[j].status) {\n"
820 " printf(\"I/O succeeded\\en\");\n"
822 " case EINPROGRESS:\n"
823 " printf(\"In progress\\en\");\n"
826 " printf(\"Canceled\\en\");\n"
829 " errMsg(\"aio_error\");\n"
835 #: build/C/man7/aio.7:430
838 " if (ioList[j].status != EINPROGRESS)\n"
846 #: build/C/man7/aio.7:432
848 msgid " printf(\"All I/O requests completed\\en\");\n"
852 #: build/C/man7/aio.7:434
854 msgid " /* Check status return of all I/O requests */\n"
858 #: build/C/man7/aio.7:438
861 " printf(\"aio_return():\\en\");\n"
862 " for (j = 0; j E<lt> numReqs; j++) {\n"
867 #: build/C/man7/aio.7:443
870 " s = aio_return(ioList[j].aiocbp);\n"
871 " printf(\" for request %d (descriptor %d): %zd\\en\",\n"
872 " j, ioList[j].aiocbp-E<gt>aio_fildes, s);\n"
877 #: build/C/man7/aio.7:446
880 " exit(EXIT_SUCCESS);\n"
885 #: build/C/man7/aio.7:447 build/C/man3/aio_cancel.3:119 build/C/man3/aio_error.3:92 build/C/man3/aio_fsync.3:105 build/C/man3/aio_init.3:99 build/C/man3/aio_read.3:149 build/C/man3/aio_return.3:87 build/C/man3/aio_suspend.3:129 build/C/man3/aio_write.3:151 build/C/man2/io_cancel.2:94 build/C/man2/io_destroy.2:83 build/C/man2/io_getevents.2:100 build/C/man2/io_setup.2:96 build/C/man2/io_submit.2:98 build/C/man3/lio_listio.3:219
891 #: build/C/man7/aio.7:462
893 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), "
894 "B<io_submit>(2), B<aio_cancel>(3), B<aio_error>(3), B<aio_init>(3), "
895 "B<aio_read>(3), B<aio_return>(3), B<aio_write>(3), B<lio_listio>(3)"
899 #: build/C/man7/aio.7:465
902 "http://www.squid-cache.org\\:/~adrian\\:/Reprint-Pulavarty-OLS2003.pdf> "
907 #: build/C/man7/aio.7:465 build/C/man3/aio_cancel.3:128 build/C/man3/aio_error.3:101 build/C/man3/aio_fsync.3:115 build/C/man3/aio_init.3:101 build/C/man3/aio_read.3:158 build/C/man3/aio_return.3:96 build/C/man3/aio_suspend.3:139 build/C/man3/aio_write.3:160 build/C/man2/io_cancel.2:102 build/C/man2/io_destroy.2:91 build/C/man2/io_getevents.2:110 build/C/man2/io_setup.2:104 build/C/man2/io_submit.2:106 build/C/man3/lio_listio.3:227
913 #: build/C/man7/aio.7:473 build/C/man3/aio_cancel.3:136 build/C/man3/aio_error.3:109 build/C/man3/aio_fsync.3:123 build/C/man3/aio_init.3:109 build/C/man3/aio_read.3:166 build/C/man3/aio_return.3:104 build/C/man3/aio_suspend.3:147 build/C/man3/aio_write.3:168 build/C/man2/io_cancel.2:110 build/C/man2/io_destroy.2:99 build/C/man2/io_getevents.2:118 build/C/man2/io_setup.2:112 build/C/man2/io_submit.2:114 build/C/man3/lio_listio.3:235
915 "This page is part of release 3.78 of the Linux I<man-pages> project. A "
916 "description of the project, information about reporting bugs, and the latest "
917 "version of this page, can be found at "
918 "\\%http://www.kernel.org/doc/man-pages/."
922 #: build/C/man3/aio_cancel.3:24
928 #: build/C/man3/aio_cancel.3:24 build/C/man3/aio_fsync.3:24 build/C/man3/aio_read.3:24 build/C/man3/aio_suspend.3:25 build/C/man3/aio_write.3:24 build/C/man3/lio_listio.3:24
934 #: build/C/man3/aio_cancel.3:27
935 msgid "aio_cancel - cancel an outstanding asynchronous I/O request"
939 #: build/C/man3/aio_cancel.3:27 build/C/man3/aio_error.3:27 build/C/man3/aio_fsync.3:27 build/C/man3/aio_init.3:29 build/C/man3/aio_read.3:27 build/C/man3/aio_return.3:27 build/C/man3/aio_suspend.3:28 build/C/man3/aio_write.3:27 build/C/man2/io_cancel.2:10 build/C/man2/io_destroy.2:10 build/C/man2/io_getevents.2:10 build/C/man2/io_setup.2:10 build/C/man2/io_submit.2:10 build/C/man3/lio_listio.3:27
945 #: build/C/man3/aio_cancel.3:29 build/C/man3/aio_error.3:29 build/C/man3/aio_fsync.3:29 build/C/man3/aio_read.3:29 build/C/man3/aio_return.3:29 build/C/man3/aio_write.3:29
946 msgid "B<#include E<lt>aio.hE<gt>>"
950 #: build/C/man3/aio_cancel.3:31
951 msgid "B<int aio_cancel(int >I<fd>B<, struct aiocb *>I<aiocbp>B<);>"
955 #: build/C/man3/aio_cancel.3:33 build/C/man3/aio_error.3:33 build/C/man3/aio_fsync.3:33 build/C/man3/aio_init.3:38 build/C/man3/aio_read.3:33 build/C/man3/aio_return.3:33 build/C/man3/aio_write.3:33
956 msgid "Link with I<-lrt>."
960 #: build/C/man3/aio_cancel.3:51
962 "The B<aio_cancel>() function attempts to cancel outstanding asynchronous "
963 "I/O requests for the file descriptor I<fd>. If I<aiocbp> is NULL, all such "
964 "requests are canceled. Otherwise, only the request described by the control "
965 "block pointed to by I<aiocbp> is canceled. (See B<aio>(7) for a "
966 "description of the I<aiocb> structure.)"
970 #: build/C/man3/aio_cancel.3:63
972 "Normal asynchronous notification occurs for canceled requests (see B<aio>(7) "
973 "and B<sigevent>(7)). The request return status (B<aio_return>(3)) is set "
974 "to -1, and the request error status (B<aio_error>(3)) is set to "
975 "B<ECANCELED>. The control block of requests that cannot be canceled is not "
980 #: build/C/man3/aio_cancel.3:70
982 "If the request could not be canceled, then it will terminate in the usual "
983 "way after performing the I/O operation. (In this case, B<aio_error>(3) "
984 "will return the status B<EINPROGRESSS>.)"
988 #: build/C/man3/aio_cancel.3:77
990 "If I<aiocbp> is not NULL, and I<fd> differs from the file descriptor with "
991 "which the asynchronous operation was initiated, unspecified results occur."
994 #. FreeBSD: not those on raw disk devices.
996 #: build/C/man3/aio_cancel.3:80
997 msgid "Which operations are cancelable is implementation-defined."
1001 #: build/C/man3/aio_cancel.3:80 build/C/man3/aio_error.3:44 build/C/man3/aio_fsync.3:73 build/C/man3/aio_read.3:88 build/C/man3/aio_return.3:49 build/C/man3/aio_suspend.3:80 build/C/man3/aio_write.3:95 build/C/man2/io_cancel.2:37 build/C/man2/io_destroy.2:29 build/C/man2/io_getevents.2:34 build/C/man2/io_setup.2:32 build/C/man2/io_submit.2:31 build/C/man3/lio_listio.3:108
1003 msgid "RETURN VALUE"
1007 #: build/C/man3/aio_cancel.3:84
1008 msgid "The B<aio_cancel>() function returns one of the following values:"
1012 #: build/C/man3/aio_cancel.3:84
1014 msgid "B<AIO_CANCELED>"
1018 #: build/C/man3/aio_cancel.3:87
1019 msgid "All requests were successfully canceled."
1023 #: build/C/man3/aio_cancel.3:87
1025 msgid "B<AIO_NOTCANCELED>"
1029 #: build/C/man3/aio_cancel.3:93
1031 "At least one of the requests specified was not canceled because it was in "
1032 "progress. In this case, one may check the status of individual requests "
1033 "using B<aio_error>(3)."
1037 #: build/C/man3/aio_cancel.3:93
1039 msgid "B<AIO_ALLDONE>"
1043 #: build/C/man3/aio_cancel.3:96
1044 msgid "All requests had already been completed before the call."
1048 #: build/C/man3/aio_cancel.3:96
1054 #: build/C/man3/aio_cancel.3:101
1056 "An error occurred. The cause of the error can be found by inspecting "
1061 #: build/C/man3/aio_cancel.3:102 build/C/man3/aio_fsync.3:83 build/C/man3/aio_read.3:107 build/C/man3/aio_write.3:114 build/C/man2/io_submit.2:41
1067 #: build/C/man3/aio_cancel.3:106
1068 msgid "I<fd> is not a valid file descriptor."
1072 #: build/C/man3/aio_cancel.3:106 build/C/man3/aio_error.3:74 build/C/man3/aio_fsync.3:95 build/C/man3/aio_read.3:119 build/C/man3/aio_return.3:69 build/C/man3/aio_suspend.3:99 build/C/man3/aio_write.3:129 build/C/man2/io_cancel.2:52 build/C/man2/io_destroy.2:41 build/C/man2/io_getevents.2:53 build/C/man2/io_setup.2:54 build/C/man2/io_submit.2:56
1078 #: build/C/man3/aio_cancel.3:110
1079 msgid "B<aio_cancel>() is not implemented."
1083 #: build/C/man3/aio_cancel.3:114
1084 msgid "The B<aio_cancel>() function is available since glibc 2.1."
1088 #: build/C/man3/aio_cancel.3:119 build/C/man3/aio_error.3:92 build/C/man3/aio_read.3:149 build/C/man3/aio_return.3:87
1089 msgid "See B<aio>(7)."
1093 #: build/C/man3/aio_cancel.3:128
1095 "B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_return>(3), "
1096 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1100 #: build/C/man3/aio_error.3:24
1106 #: build/C/man3/aio_error.3:24 build/C/man3/aio_return.3:24
1112 #: build/C/man3/aio_error.3:27
1113 msgid "aio_error - get error status of asynchronous I/O operation"
1117 #: build/C/man3/aio_error.3:31
1118 msgid "B<int aio_error(const struct aiocb *>I<aiocbp>B<);>"
1122 #: build/C/man3/aio_error.3:44
1124 "The B<aio_error>() function returns the error status for the asynchronous "
1125 "I/O request with control block pointed to by I<aiocbp>. (See B<aio>(7) for "
1126 "a description of the I<aiocb> structure.)"
1130 #: build/C/man3/aio_error.3:46
1131 msgid "This function returns one of the following:"
1135 #: build/C/man3/aio_error.3:46 build/C/man3/aio_error.3:50 build/C/man3/aio_error.3:53 build/C/man3/aio_error.3:55 build/C/man3/aio_suspend.3:43 build/C/man3/aio_suspend.3:47 build/C/man3/aio_suspend.3:49
1141 #: build/C/man3/aio_error.3:50
1142 msgid "B<EINPROGRESS>, if the request has not been completed yet."
1146 #: build/C/man3/aio_error.3:53
1147 msgid "B<ECANCELED>, if the request was canceled."
1151 #: build/C/man3/aio_error.3:55
1152 msgid "0, if the request completed successfully."
1156 #: build/C/man3/aio_error.3:66
1158 "A positive error number, if the asynchronous I/O operation failed. This is "
1159 "the same value that would have been stored in the I<errno> variable in the "
1160 "case of a synchronous B<read>(2), B<write>(2), B<fsync>(2), or "
1161 "B<fdatasync>(2) call."
1165 #: build/C/man3/aio_error.3:74
1167 "I<aiocbp> does not point at a control block for an asynchronous I/O request "
1168 "of which the return status (see B<aio_return>(3)) has not been retrieved "
1173 #: build/C/man3/aio_error.3:78
1174 msgid "B<aio_error>() is not implemented."
1178 #: build/C/man3/aio_error.3:82
1179 msgid "The B<aio_error>() function is available since glibc 2.1."
1183 #: build/C/man3/aio_error.3:82 build/C/man3/aio_return.3:77
1189 #: build/C/man3/aio_error.3:83 build/C/man3/aio_return.3:78
1191 msgid "Multithreading (see pthreads(7))"
1195 #: build/C/man3/aio_error.3:87
1196 msgid "The B<aio_error>() function is thread-safe."
1200 #: build/C/man3/aio_error.3:101
1202 "B<aio_cancel>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_return>(3), "
1203 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1207 #: build/C/man3/aio_fsync.3:24
1213 #: build/C/man3/aio_fsync.3:27
1214 msgid "aio_fsync - asynchronous file synchronization"
1218 #: build/C/man3/aio_fsync.3:31
1219 msgid "B<int aio_fsync(int >I<op>B<, struct aiocb *>I<aiocbp>B<);>"
1223 #: build/C/man3/aio_fsync.3:44
1225 "The B<aio_fsync>() function does a sync on all outstanding asynchronous I/O "
1226 "operations associated with I<aiocbp-E<gt>aio_fildes>. (See B<aio>(7) for a "
1227 "description of the I<aiocb> structure.)"
1231 #: build/C/man3/aio_fsync.3:58
1233 "More precisely, if I<op> is B<O_SYNC>, then all currently queued I/O "
1234 "operations shall be completed as if by a call of B<fsync>(2), and if I<op> "
1235 "is B<O_DSYNC>, this call is the asynchronous analog of B<fdatasync>(2)."
1239 #: build/C/man3/aio_fsync.3:60
1240 msgid "Note that this is a request only; it does not wait for I/O completion."
1244 #: build/C/man3/aio_fsync.3:73
1246 "Apart from I<aio_fildes>, the only field in the structure pointed to by "
1247 "I<aiocbp> that is used by this call is the I<aio_sigevent> field (a "
1248 "I<sigevent> structure, described in B<sigevent>(7)), which indicates the "
1249 "desired type of asynchronous notification at completion. All other fields "
1254 #: build/C/man3/aio_fsync.3:79
1256 "On success (the sync request was successfully queued) this function returns "
1257 "0. On error, -1 is returned, and I<errno> is set appropriately."
1261 #: build/C/man3/aio_fsync.3:80 build/C/man3/aio_read.3:104 build/C/man3/aio_suspend.3:89 build/C/man3/aio_write.3:111 build/C/man2/io_cancel.2:43 build/C/man2/io_setup.2:38 build/C/man2/io_submit.2:38 build/C/man3/lio_listio.3:150 build/C/man3/lio_listio.3:153
1267 #: build/C/man3/aio_fsync.3:83 build/C/man3/aio_read.3:107 build/C/man3/aio_write.3:114 build/C/man3/lio_listio.3:153
1268 msgid "Out of resources."
1272 #: build/C/man3/aio_fsync.3:87 build/C/man3/aio_write.3:118
1273 msgid "I<aio_fildes> is not a valid file descriptor open for writing."
1277 #: build/C/man3/aio_fsync.3:95
1279 "Synchronized I/O is not supported for this file, or I<op> is not B<O_SYNC> "
1284 #: build/C/man3/aio_fsync.3:99
1285 msgid "B<aio_fsync>() is not implemented."
1289 #: build/C/man3/aio_fsync.3:103
1290 msgid "The B<aio_fsync>() function is available since glibc 2.1."
1294 #: build/C/man3/aio_fsync.3:115
1296 "B<aio_cancel>(3), B<aio_error>(3), B<aio_read>(3), B<aio_return>(3), "
1297 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7), "
1302 #: build/C/man3/aio_init.3:26
1308 #: build/C/man3/aio_init.3:26
1314 #: build/C/man3/aio_init.3:29
1315 msgid "aio_init - asynchronous I/O initialization"
1319 #: build/C/man3/aio_init.3:33
1322 "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n"
1323 "B<#include E<lt>aio.hE<gt>>\n"
1327 #: build/C/man3/aio_init.3:35
1329 msgid "B<void aio_init(const struct aioinit *>I<init>B<);>\n"
1333 #: build/C/man3/aio_init.3:45
1335 "The GNU-specific B<aio_init>() function allows the caller to provide tuning "
1336 "hints to the glibc POSIX AIO implementation. Use of this function is "
1337 "optional, but to be effective, it must be called before employing any other "
1338 "functions in the POSIX AIO API."
1342 #: build/C/man3/aio_init.3:49
1344 "The tuning information is provided in the buffer pointed to by the argument "
1345 "I<init>. This buffer is a structure of the following form:"
1349 #: build/C/man3/aio_init.3:64
1352 "struct aioinit {\n"
1353 " int aio_threads; /* Maximum number of threads */\n"
1354 " int aio_num; /* Number of expected simultaneous\n"
1356 " int aio_locks; /* Not used */\n"
1357 " int aio_usedba; /* Not used */\n"
1358 " int aio_debug; /* Not used */\n"
1359 " int aio_numusers; /* Not used */\n"
1360 " int aio_idle_time; /* Number of seconds before idle thread\n"
1361 " terminates (since glibc 2.2) */\n"
1362 " int aio_reserved;\n"
1367 #: build/C/man3/aio_init.3:70
1368 msgid "The following fields are used in the I<aioinit> structure:"
1372 #: build/C/man3/aio_init.3:70
1374 msgid "I<aio_threads>"
1378 #: build/C/man3/aio_init.3:78
1380 "This field specifies the maximum number of worker threads that may be used "
1381 "by the implementation. If the number of outstanding I/O operations exceeds "
1382 "this limit, then excess operations will be queued until a worker thread "
1383 "becomes free. If this field is specified with a value less than 1, the "
1384 "value 1 is used. The default value is 20."
1388 #: build/C/man3/aio_init.3:78
1393 #. FIXME . But, if aio_num > 32, the behavior looks strange. See
1394 #. http://sourceware.org/bugzilla/show_bug.cgi?id=12083
1396 #: build/C/man3/aio_init.3:87
1398 "This field should specify the maximum number of simultaneous I/O requests "
1399 "that the caller expects to enqueue. If a value less than 32 is specified "
1400 "for this field, it is rounded up to 32. The default value is 64."
1404 #: build/C/man3/aio_init.3:87
1406 msgid "I<aio_idle_time>"
1410 #: build/C/man3/aio_init.3:93
1412 "This field specifies the amount of time in seconds that a worker thread "
1413 "should wait for further requests before terminating, after having completed "
1414 "a previous request. The default value is 1."
1418 #: build/C/man3/aio_init.3:97
1419 msgid "The B<aio_init>() function is available since glibc 2.1."
1423 #: build/C/man3/aio_init.3:99
1424 msgid "This function is a GNU extension."
1428 #: build/C/man3/aio_init.3:101
1433 #: build/C/man3/aio_read.3:24
1439 #: build/C/man3/aio_read.3:27
1440 msgid "aio_read - asynchronous read"
1444 #: build/C/man3/aio_read.3:31
1445 msgid "B<int aio_read(struct aiocb *>I<aiocbp>B<);>"
1449 #: build/C/man3/aio_read.3:41
1451 "The B<aio_read>() function queues the I/O request described by the buffer "
1452 "pointed to by I<aiocbp>. This function is the asynchronous analog of "
1453 "B<read>(2). The arguments of the call"
1457 #: build/C/man3/aio_read.3:43
1459 msgid " read(fd, buf, count)\n"
1463 #: build/C/man3/aio_read.3:56 build/C/man3/aio_write.3:56
1465 "correspond (in order) to the fields I<aio_fildes>, I<aio_buf>, and "
1466 "I<aio_nbytes> of the structure pointed to by I<aiocbp>. (See B<aio>(7) for "
1467 "a description of the I<aiocb> structure.)"
1471 #: build/C/man3/aio_read.3:62
1473 "The data is read starting at the absolute file offset "
1474 "I<aiocbp-E<gt>aio_offset>, regardless of the current file offset. After the "
1475 "call, the value of the current file offset is unspecified."
1479 #: build/C/man3/aio_read.3:75
1481 "The \"asynchronous\" means that this call returns as soon as the request has "
1482 "been enqueued; the read may or may not have completed when the call "
1483 "returns. One tests for completion using B<aio_error>(3). The return status "
1484 "of a completed I/O operation can be obtained by B<aio_return>(3). "
1485 "Asynchronous notification of I/O completion can be obtained by setting "
1486 "I<aiocbp-E<gt>aio_sigevent> appropriately; see B<sigevent>(7) for details."
1490 #: build/C/man3/aio_read.3:82 build/C/man3/aio_write.3:89
1492 "If B<_POSIX_PRIORITIZED_IO> is defined, and this file supports it, then the "
1493 "asynchronous operation is submitted at a priority equal to that of the "
1494 "calling process minus I<aiocbp-E<gt>aio_reqprio>."
1498 #: build/C/man3/aio_read.3:86 build/C/man3/aio_write.3:93
1499 msgid "The field I<aiocbp-E<gt>aio_lio_opcode> is ignored."
1503 #: build/C/man3/aio_read.3:88
1504 msgid "No data is read from a regular file beyond its maximum offset."
1508 #: build/C/man3/aio_read.3:103 build/C/man3/aio_write.3:110
1510 "On success, 0 is returned. On error, the request is not enqueued, -1 is "
1511 "returned, and I<errno> is set appropriately. If an error is detected only "
1512 "later, it will be reported via B<aio_return>(3) (returns status -1) and "
1513 "B<aio_error>(3) (error status\\(emwhatever one would have gotten in "
1514 "I<errno>, such as B<EBADF>)."
1518 #: build/C/man3/aio_read.3:111
1519 msgid "I<aio_fildes> is not a valid file descriptor open for reading."
1523 #: build/C/man3/aio_read.3:119
1524 msgid "One or more of I<aio_offset>, I<aio_reqprio>, or I<aio_nbytes> are invalid."
1528 #: build/C/man3/aio_read.3:123
1529 msgid "B<aio_read>() is not implemented."
1533 #: build/C/man3/aio_read.3:123
1535 msgid "B<EOVERFLOW>"
1539 #: build/C/man3/aio_read.3:128
1541 "The file is a regular file, we start reading before end-of-file and want at "
1542 "least one byte, but the starting position is past the maximum offset for "
1547 #: build/C/man3/aio_read.3:132
1548 msgid "The B<aio_read>() function is available since glibc 2.1."
1551 #. or the control block of the operation
1553 #: build/C/man3/aio_read.3:142
1555 "It is a good idea to zero out the control block before use. The control "
1556 "block must not be changed while the read operation is in progress. The "
1557 "buffer area being read into must not be accessed during the operation or "
1558 "undefined results may occur. The memory areas involved must remain valid."
1562 #: build/C/man3/aio_read.3:146 build/C/man3/aio_write.3:151 build/C/man3/lio_listio.3:219
1564 "Simultaneous I/O operations specifying the same I<aiocb> structure produce "
1565 "undefined results."
1569 #: build/C/man3/aio_read.3:158
1571 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_return>(3), "
1572 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1576 #: build/C/man3/aio_return.3:24
1582 #: build/C/man3/aio_return.3:27
1583 msgid "aio_return - get return status of asynchronous I/O operation"
1587 #: build/C/man3/aio_return.3:31
1588 msgid "B<ssize_t aio_return(struct aiocb *>I<aiocbp>B<);>"
1592 #: build/C/man3/aio_return.3:44
1594 "The B<aio_return>() function returns the final return status for the "
1595 "asynchronous I/O request with control block pointed to by I<aiocbp>. (See "
1596 "B<aio>(7) for a description of the I<aiocb> structure.)"
1600 #: build/C/man3/aio_return.3:49
1602 "This function should be called only once for any given request, after "
1603 "B<aio_error>(3) returns something other than B<EINPROGRESS>."
1607 #: build/C/man3/aio_return.3:58
1609 "If the asynchronous I/O operation has completed, this function returns the "
1610 "value that would have been returned in case of a synchronous B<read>(2), "
1611 "B<write>(2), B<fsync>(2) or B<fdatasync>(2), call."
1615 #: build/C/man3/aio_return.3:63
1617 "If the asynchronous I/O operation has not yet completed, the return value "
1618 "and effect of B<aio_return>() are undefined."
1622 #: build/C/man3/aio_return.3:69
1624 "I<aiocbp> does not point at a control block for an asynchronous I/O request "
1625 "of which the return status has not been retrieved yet."
1629 #: build/C/man3/aio_return.3:73
1630 msgid "B<aio_return>() is not implemented."
1634 #: build/C/man3/aio_return.3:77
1635 msgid "The B<aio_return>() function is available since glibc 2.1."
1639 #: build/C/man3/aio_return.3:82
1640 msgid "The B<aio_return>() function is thread-safe."
1644 #: build/C/man3/aio_return.3:96
1646 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), "
1647 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1651 #: build/C/man3/aio_suspend.3:25
1657 #: build/C/man3/aio_suspend.3:28
1658 msgid "aio_suspend - wait for asynchronous I/O operation or timeout"
1662 #: build/C/man3/aio_suspend.3:32 build/C/man3/lio_listio.3:30
1664 msgid "B<#include E<lt>aio.hE<gt>>\n"
1668 #: build/C/man3/aio_suspend.3:34
1670 msgid "B<int aio_suspend(const struct aiocb * const >I<aiocb_list>B<[],>\n"
1674 #: build/C/man3/aio_suspend.3:36
1677 "B< int >I<nitems>B<, const struct timespec "
1678 "*>I<timeout>B<);>\n"
1682 #: build/C/man3/aio_suspend.3:38 build/C/man3/lio_listio.3:35
1684 msgid "Link with I<-lrt>.\n"
1688 #: build/C/man3/aio_suspend.3:43
1690 "The B<aio_suspend>() function suspends the calling thread until one of the "
1695 #: build/C/man3/aio_suspend.3:47
1697 "One or more of the asynchronous I/O requests in the list I<aiocb_list> has "
1702 #: build/C/man3/aio_suspend.3:49
1703 msgid "A signal is delivered."
1707 #: build/C/man3/aio_suspend.3:56
1709 "I<timeout> is not NULL and the specified time interval has passed. (For "
1710 "details of the I<timespec> structure, see B<nanosleep>(2).)"
1714 #: build/C/man3/aio_suspend.3:74
1716 "The I<nitems> argument specifies the number of items in I<aiocb_list>. Each "
1717 "item in the list pointed to by I<aiocb_list> must be either NULL (and then "
1718 "is ignored), or a pointer to a control block on which I/O was initiated "
1719 "using B<aio_read>(3), B<aio_write>(3), or B<lio_listio>(3). (See B<aio>(7) "
1720 "for a description of the I<aiocb> structure.)"
1724 #: build/C/man3/aio_suspend.3:80
1726 "If B<CLOCK_MONOTONIC> is supported, this clock is used to measure the "
1727 "timeout interval (see B<clock_gettime>(3))."
1731 #: build/C/man3/aio_suspend.3:88
1733 "If this function returns after completion of one of the I/O requests "
1734 "specified in I<aiocb_list>, 0 is returned. Otherwise, -1 is returned, and "
1735 "I<errno> is set to indicate the error."
1739 #: build/C/man3/aio_suspend.3:93
1740 msgid "The call timed out before any of the indicated operations had completed."
1744 #: build/C/man3/aio_suspend.3:93 build/C/man2/io_getevents.2:49 build/C/man3/lio_listio.3:169
1750 #: build/C/man3/aio_suspend.3:99
1752 "The call was ended by signal (possibly the completion signal of one of the "
1753 "operations we were waiting for); see B<signal>(7)."
1757 #: build/C/man3/aio_suspend.3:103
1758 msgid "B<aio_suspend>() is not implemented."
1762 #: build/C/man3/aio_suspend.3:107
1763 msgid "The B<aio_suspend>() function is available since glibc 2.1."
1767 #: build/C/man3/aio_suspend.3:113
1769 "One can achieve polling by using a non-NULL I<timeout> that specifies a zero "
1774 #: build/C/man3/aio_suspend.3:119
1776 "If one or more of the asynchronous I/O operations specified in I<aiocb_list> "
1777 "has already completed at the time of the call to B<aio_suspend>(), then the "
1778 "call returns immediately."
1782 #: build/C/man3/aio_suspend.3:129
1784 "To determine which I/O operations have completed after a successful return "
1785 "from B<aio_suspend>(), use B<aio_error>(3) to scan the list of I<aiocb> "
1786 "structures pointed to by I<aiocb_list>."
1790 #: build/C/man3/aio_suspend.3:139
1792 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), "
1793 "B<aio_return>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7), B<time>(7)"
1797 #: build/C/man3/aio_write.3:24
1803 #: build/C/man3/aio_write.3:27
1804 msgid "aio_write - asynchronous write"
1808 #: build/C/man3/aio_write.3:31
1809 msgid "B<int aio_write(struct aiocb *>I<aiocbp>B<);>"
1813 #: build/C/man3/aio_write.3:41
1815 "The B<aio_write>() function queues the I/O request described by the buffer "
1816 "pointed to by I<aiocbp>. This function is the asynchronous analog of "
1817 "B<write>(2). The arguments of the call"
1821 #: build/C/man3/aio_write.3:43
1823 msgid " write(fd, buf, count)\n"
1827 #: build/C/man3/aio_write.3:69
1829 "If B<O_APPEND> is not set, the data is written starting at the absolute file "
1830 "offset I<aiocbp-E<gt>aio_offset>, regardless of the current file offset. If "
1831 "B<O_APPEND> is set, data is written at the end of the file in the same order "
1832 "as B<aio_write>() calls are made. After the call, the value of the current "
1833 "file offset is unspecified."
1837 #: build/C/man3/aio_write.3:82
1839 "The \"asynchronous\" means that this call returns as soon as the request has "
1840 "been enqueued; the write may or may not have completed when the call "
1841 "returns. One tests for completion using B<aio_error>(3). The return status "
1842 "of a completed I/O operation can be obtained B<aio_return>(3). Asynchronous "
1843 "notification of I/O completion can be obtained by setting "
1844 "I<aiocbp-E<gt>aio_sigevent> appropriately; see B<sigevent>(7) for details."
1848 #: build/C/man3/aio_write.3:95
1849 msgid "No data is written to a regular file beyond its maximum offset."
1853 #: build/C/man3/aio_write.3:118
1859 #: build/C/man3/aio_write.3:122
1861 "The file is a regular file, we want to write at least one byte, but the "
1862 "starting position is at or beyond the maximum offset for this file."
1866 #: build/C/man3/aio_write.3:129
1867 msgid "One or more of I<aio_offset>, I<aio_reqprio>, I<aio_nbytes> are invalid."
1871 #: build/C/man3/aio_write.3:133
1872 msgid "B<aio_write>() is not implemented."
1876 #: build/C/man3/aio_write.3:137
1877 msgid "The B<aio_write>() function is available since glibc 2.1."
1880 #. or the control block of the operation
1882 #: build/C/man3/aio_write.3:147
1884 "It is a good idea to zero out the control block before use. The control "
1885 "block must not be changed while the write operation is in progress. The "
1886 "buffer area being written out must not be accessed during the operation or "
1887 "undefined results may occur. The memory areas involved must remain valid."
1891 #: build/C/man3/aio_write.3:160
1893 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), "
1894 "B<aio_return>(3), B<aio_suspend>(3), B<lio_listio>(3), B<aio>(7)"
1898 #: build/C/man2/io_cancel.2:7
1904 #: build/C/man2/io_cancel.2:7
1910 #: build/C/man2/io_cancel.2:10
1911 msgid "io_cancel - cancel an outstanding asynchronous I/O operation"
1915 #: build/C/man2/io_cancel.2:13 build/C/man2/io_destroy.2:13 build/C/man2/io_setup.2:13 build/C/man2/io_submit.2:13
1917 msgid "B<#include E<lt>linux/aio_abi.hE<gt>> /* Defines needed types */\n"
1921 #: build/C/man2/io_cancel.2:16
1924 "B<int io_cancel(aio_context_t >I<ctx_id>B<, struct iocb *>I<iocb>B<,>\n"
1925 "B< struct io_event *>I<result>B<);>\n"
1929 #: build/C/man2/io_cancel.2:20 build/C/man2/io_destroy.2:19 build/C/man2/io_getevents.2:22 build/C/man2/io_setup.2:19 build/C/man2/io_submit.2:20
1930 msgid "I<Note>: There is no glibc wrapper for this system call; see NOTES."
1934 #: build/C/man2/io_cancel.2:37
1936 "The B<io_cancel>() system call attempts to cancel an asynchronous I/O "
1937 "operation previously submitted with B<io_submit>(2). The I<iocb> argument "
1938 "describes the operation to be canceled and the I<ctx_id> argument is the AIO "
1939 "context to which the operation was submitted. If the operation is "
1940 "successfully canceled, the event will be copied into the memory pointed to "
1941 "by I<result> without being placed into the completion queue."
1945 #: build/C/man2/io_cancel.2:42
1946 msgid "On success, B<io_cancel>() returns 0. For the failure return, see NOTES."
1950 #: build/C/man2/io_cancel.2:46
1951 msgid "The I<iocb> specified was not canceled."
1955 #: build/C/man2/io_cancel.2:46 build/C/man2/io_destroy.2:35 build/C/man2/io_getevents.2:41 build/C/man2/io_setup.2:43 build/C/man2/io_submit.2:44
1961 #: build/C/man2/io_cancel.2:49 build/C/man2/io_submit.2:47
1962 msgid "One of the data structures points to invalid data."
1966 #: build/C/man2/io_cancel.2:52 build/C/man2/io_destroy.2:41
1967 msgid "The AIO context specified by I<ctx_id> is invalid."
1971 #: build/C/man2/io_cancel.2:56
1972 msgid "B<io_cancel>() is not implemented on this architecture."
1976 #: build/C/man2/io_cancel.2:59 build/C/man2/io_destroy.2:48 build/C/man2/io_getevents.2:60 build/C/man2/io_setup.2:61 build/C/man2/io_submit.2:63
1977 msgid "The asynchronous I/O system calls first appeared in Linux 2.5."
1981 #: build/C/man2/io_cancel.2:64
1983 "B<io_cancel>() is Linux-specific and should not be used in programs that "
1984 "are intended to be portable."
1987 #. http://git.fedorahosted.org/git/?p=libaio.git
1989 #: build/C/man2/io_cancel.2:73
1991 "Glibc does not provide a wrapper function for this system call. You could "
1992 "invoke it using B<syscall>(2). But instead, you probably want to use the "
1993 "B<io_cancel>() wrapper function provided by I<libaio>."
1996 #. But glibc is confused, since <libaio.h> uses 'io_context_t' to declare
1999 #: build/C/man2/io_cancel.2:94 build/C/man2/io_destroy.2:83 build/C/man2/io_getevents.2:95 build/C/man2/io_submit.2:98
2001 "Note that the I<libaio> wrapper function uses a different type "
2002 "(I<io_context_t>) for the I<ctx_id> argument. Note also that the I<libaio> "
2003 "wrapper does not follow the usual C library conventions for indicating "
2004 "errors: on error it returns a negated error number (the negative of one of "
2005 "the values listed in ERRORS). If the system call is invoked via "
2006 "B<syscall>(2), then the return value follows the usual conventions for "
2007 "indicating an error: -1, with I<errno> set to a (positive) value that "
2008 "indicates the error."
2014 #: build/C/man2/io_cancel.2:102
2016 "B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), B<io_submit>(2), "
2021 #: build/C/man2/io_destroy.2:7
2027 #: build/C/man2/io_destroy.2:7 build/C/man2/io_getevents.2:7
2033 #: build/C/man2/io_destroy.2:10
2034 msgid "io_destroy - destroy an asynchronous I/O context"
2038 #: build/C/man2/io_destroy.2:15
2040 msgid "B<int io_destroy(aio_context_t >I<ctx_id>B<);>\n"
2044 #: build/C/man2/io_destroy.2:29
2046 "The B<io_destroy>() system call will attempt to cancel all outstanding "
2047 "asynchronous I/O operations against I<ctx_id>, will block on the completion "
2048 "of all operations that could not be canceled, and will destroy the "
2053 #: build/C/man2/io_destroy.2:34
2054 msgid "On success, B<io_destroy>() returns 0. For the failure return, see NOTES."
2058 #: build/C/man2/io_destroy.2:38
2059 msgid "The context pointed to is invalid."
2063 #: build/C/man2/io_destroy.2:45
2064 msgid "B<io_destroy>() is not implemented on this architecture."
2068 #: build/C/man2/io_destroy.2:53
2070 "B<io_destroy>() is Linux-specific and should not be used in programs that "
2071 "are intended to be portable."
2074 #. http://git.fedorahosted.org/git/?p=libaio.git
2076 #: build/C/man2/io_destroy.2:62
2078 "Glibc does not provide a wrapper function for this system call. You could "
2079 "invoke it using B<syscall>(2). But instead, you probably want to use the "
2080 "B<io_destroy>() wrapper function provided by I<libaio>."
2086 #: build/C/man2/io_destroy.2:91
2088 "B<io_cancel>(2), B<io_getevents>(2), B<io_setup>(2), B<io_submit>(2), "
2093 #: build/C/man2/io_getevents.2:7
2095 msgid "IO_GETEVENTS"
2099 #: build/C/man2/io_getevents.2:10
2100 msgid "io_getevents - read asynchronous I/O events from the completion queue"
2104 #: build/C/man2/io_getevents.2:14
2107 "B<#include E<lt>linux/aio_abi.hE<gt>> /* Defines needed types */\n"
2108 "B<#include E<lt>linux/time.hE<gt>> /* Defines 'struct timespec' "
2113 #: build/C/man2/io_getevents.2:18
2116 "B<int io_getevents(aio_context_t >I<ctx_id>B<, long >I<min_nr>B<, long "
2118 "B< struct io_event *>I<events>B<, struct timespec "
2119 "*>I<timeout>B<);>\n"
2123 #: build/C/man2/io_getevents.2:34
2125 "The B<io_getevents>() system call attempts to read at least I<min_nr> "
2126 "events and up to I<nr> events from the completion queue of the AIO context "
2127 "specified by I<ctx_id>. The I<timeout> argument specifies the amount of "
2128 "time to wait for events, where a NULL timeout waits until at least I<min_nr> "
2129 "events have been seen. Note that I<timeout> is relative."
2133 #: build/C/man2/io_getevents.2:40
2135 "On success, B<io_getevents>() returns the number of events read: 0 if no "
2136 "events are available, or less than I<min_nr> if the I<timeout> has elapsed. "
2137 "For the failure return, see NOTES."
2141 #: build/C/man2/io_getevents.2:44
2142 msgid "Either I<events> or I<timeout> is an invalid pointer."
2146 #: build/C/man2/io_getevents.2:49
2147 msgid "I<ctx_id> is invalid. I<min_nr> is out of range or I<nr> is out of range."
2151 #: build/C/man2/io_getevents.2:53
2152 msgid "Interrupted by a signal handler; see B<signal>(7)."
2156 #: build/C/man2/io_getevents.2:57
2157 msgid "B<io_getevents>() is not implemented on this architecture."
2161 #: build/C/man2/io_getevents.2:65
2163 "B<io_getevents>() is Linux-specific and should not be used in programs that "
2164 "are intended to be portable."
2167 #. http://git.fedorahosted.org/git/?p=libaio.git
2169 #: build/C/man2/io_getevents.2:74
2171 "Glibc does not provide a wrapper function for this system call. You could "
2172 "invoke it using B<syscall>(2). But instead, you probably want to use the "
2173 "B<io_getevents>() wrapper function provided by I<libaio>."
2177 #: build/C/man2/io_getevents.2:95
2183 #: build/C/man2/io_getevents.2:100
2185 "An invalid I<ctx_id> may cause a segmentation fault instead of generating "
2186 "the error B<EINVAL>."
2192 #: build/C/man2/io_getevents.2:110
2194 "B<io_cancel>(2), B<io_destroy>(2), B<io_setup>(2), B<io_submit>(2), "
2195 "B<aio>(7), B<time>(7)"
2199 #: build/C/man2/io_setup.2:7
2205 #: build/C/man2/io_setup.2:7
2211 #: build/C/man2/io_setup.2:10
2212 msgid "io_setup - create an asynchronous I/O context"
2216 #: build/C/man2/io_setup.2:15
2218 msgid "B<int io_setup(unsigned >I<nr_events>B<, aio_context_t *>I<ctx_idp>B<);>\n"
2222 #: build/C/man2/io_setup.2:32
2224 "The B<io_setup>() system call creates an asynchronous I/O context suitable "
2225 "for concurrently processing I<nr_events> operations. The I<ctx_idp> "
2226 "argument must not point to an AIO context that already exists, and must be "
2227 "initialized to 0 prior to the call. On successful creation of the AIO "
2228 "context, I<*ctx_idp> is filled in with the resulting handle."
2232 #: build/C/man2/io_setup.2:37
2233 msgid "On success, B<io_setup>() returns 0. For the failure return, see NOTES."
2237 #: build/C/man2/io_setup.2:43
2239 "The specified I<nr_events> exceeds the user's limit of available events, as "
2240 "defined in I</proc/sys/fs/aio-max-nr>."
2244 #: build/C/man2/io_setup.2:46
2245 msgid "An invalid pointer is passed for I<ctx_idp>."
2249 #: build/C/man2/io_setup.2:51
2251 "I<ctx_idp> is not initialized, or the specified I<nr_events> exceeds "
2252 "internal limits. I<nr_events> should be greater than 0."
2256 #: build/C/man2/io_setup.2:51
2262 #: build/C/man2/io_setup.2:54
2263 msgid "Insufficient kernel resources are available."
2267 #: build/C/man2/io_setup.2:58
2268 msgid "B<io_setup>() is not implemented on this architecture."
2272 #: build/C/man2/io_setup.2:66
2274 "B<io_setup>() is Linux-specific and should not be used in programs that are "
2275 "intended to be portable."
2278 #. http://git.fedorahosted.org/git/?p=libaio.git
2280 #: build/C/man2/io_setup.2:75
2282 "Glibc does not provide a wrapper function for this system call. You could "
2283 "invoke it using B<syscall>(2). But instead, you probably want to use the "
2284 "B<io_setup>() wrapper function provided by I<libaio>."
2287 #. But glibc is confused, since <libaio.h> uses 'io_context_t' to declare
2290 #: build/C/man2/io_setup.2:96
2292 "Note that the I<libaio> wrapper function uses a different type "
2293 "(I<io_context_t\\ *>) for the I<ctx_idp> argument. Note also that the "
2294 "I<libaio> wrapper does not follow the usual C library conventions for "
2295 "indicating errors: on error it returns a negated error number (the negative "
2296 "of one of the values listed in ERRORS). If the system call is invoked via "
2297 "B<syscall>(2), then the return value follows the usual conventions for "
2298 "indicating an error: -1, with I<errno> set to a (positive) value that "
2299 "indicates the error."
2305 #: build/C/man2/io_setup.2:104
2307 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_submit>(2), "
2312 #: build/C/man2/io_submit.2:7
2318 #: build/C/man2/io_submit.2:7
2324 #: build/C/man2/io_submit.2:10
2325 msgid "io_submit - submit asynchronous I/O blocks for processing"
2329 #: build/C/man2/io_submit.2:16
2332 "B<int io_submit(aio_context_t >I<ctx_id>B<, long >I<nr>B<, struct iocb "
2333 "**>I<iocbpp>B<);>\n"
2337 #: build/C/man2/io_submit.2:31
2339 "The B<io_submit>() system call queues I<nr> I/O request blocks for "
2340 "processing in the AIO context I<ctx_id>. The I<iocbpp> argument should be "
2341 "an array of I<nr> AIO control blocks, which will be submitted to context "
2346 #: build/C/man2/io_submit.2:37
2348 "On success, B<io_submit>() returns the number of I<iocb>s submitted (which "
2349 "may be 0 if I<nr> is zero). For the failure return, see NOTES."
2353 #: build/C/man2/io_submit.2:41
2354 msgid "Insufficient resources are available to queue any I<iocb>s."
2358 #: build/C/man2/io_submit.2:44
2359 msgid "The file descriptor specified in the first I<iocb> is invalid."
2363 #: build/C/man2/io_submit.2:56
2365 "The AIO context specified by I<ctx_id> is invalid. I<nr> is less than 0. "
2366 "The I<iocb> at I<*iocbpp[0]> is not properly initialized, or the operation "
2367 "specified is invalid for the file descriptor in the I<iocb>."
2371 #: build/C/man2/io_submit.2:60
2372 msgid "B<io_submit>() is not implemented on this architecture."
2376 #: build/C/man2/io_submit.2:68
2378 "B<io_submit>() is Linux-specific and should not be used in programs that "
2379 "are intended to be portable."
2382 #. http://git.fedorahosted.org/git/?p=libaio.git
2384 #: build/C/man2/io_submit.2:77
2386 "Glibc does not provide a wrapper function for this system call. You could "
2387 "invoke it using B<syscall>(2). But instead, you probably want to use the "
2388 "B<io_submit>() wrapper function provided by I<libaio>."
2394 #: build/C/man2/io_submit.2:106
2396 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), "
2401 #: build/C/man3/lio_listio.3:24
2407 #: build/C/man3/lio_listio.3:27
2408 msgid "lio_listio - initiate a list of I/O requests"
2412 #: build/C/man3/lio_listio.3:33
2415 "B<int lio_listio(int >I<mode>B<, struct aiocb *const >I<aiocb_list>B<[],>\n"
2416 "B< int >I<nitems>B<, struct sigevent *>I<sevp>B<);>\n"
2420 #: build/C/man3/lio_listio.3:41
2422 "The B<lio_listio>() function initiates the list of I/O operations described "
2423 "by the array I<aiocb_list>."
2427 #: build/C/man3/lio_listio.3:45
2428 msgid "The I<mode> operation has one of the following values:"
2432 #: build/C/man3/lio_listio.3:45
2438 #: build/C/man3/lio_listio.3:51
2440 "The call blocks until all operations are complete. The I<sevp> argument is "
2445 #: build/C/man3/lio_listio.3:51
2447 msgid "B<LIO_NOWAIT>"
2451 #: build/C/man3/lio_listio.3:63
2453 "The I/O operations are queued for processing and the call returns "
2454 "immediately. When all of the I/O operations complete, asynchronous "
2455 "notification occurs, as specified by the I<sevp> argument; see "
2456 "B<sigevent>(7) for details. If I<sevp> is NULL, no asynchronous "
2457 "notification occurs."
2461 #: build/C/man3/lio_listio.3:77
2463 "The I<aiocb_list> argument is an array of pointers to I<aiocb> structures "
2464 "that describe I/O operations. These operations are executed in an "
2465 "unspecified order. The I<nitems> argument specifies the size of the array "
2466 "I<aiocb_list>. null pointers in I<aiocb_list> are ignored."
2470 #: build/C/man3/lio_listio.3:83
2472 "In each control block in I<aiocb_list>, the I<aio_lio_opcode> field "
2473 "specifies the I/O operation to be initiated, as follows:"
2477 #: build/C/man3/lio_listio.3:83
2483 #: build/C/man3/lio_listio.3:89
2485 "Initiate a read operation. The operation is queued as for a call to "
2486 "B<aio_read>(3) specifying this control block."
2490 #: build/C/man3/lio_listio.3:89
2492 msgid "B<LIO_WRITE>"
2496 #: build/C/man3/lio_listio.3:95
2498 "Initiate a write operation. The operation is queued as for a call to "
2499 "B<aio_write>(3) specifying this control block."
2503 #: build/C/man3/lio_listio.3:95
2509 #: build/C/man3/lio_listio.3:98
2510 msgid "Ignore this control block."
2514 #: build/C/man3/lio_listio.3:108
2516 "The remaining fields in each control block have the same meanings as for "
2517 "B<aio_read>(3) and B<aio_write>(3). The I<aio_sigevent> fields of each "
2518 "control block can be used to specify notifications for the individual I/O "
2519 "operations (see B<sigevent>(7))."
2523 #: build/C/man3/lio_listio.3:118
2525 "If I<mode> is B<LIO_NOWAIT>, B<lio_listio>() returns 0 if all I/O "
2526 "operations are successfully queued. Otherwise, -1 is returned, and I<errno> "
2527 "is set to indicate the error."
2531 #: build/C/man3/lio_listio.3:128
2533 "If I<mode> is B<LIO_WAIT>, B<lio_listio>() returns 0 when all of the I/O "
2534 "operations have completed successfully. Otherwise, -1 is returned, and "
2535 "I<errno> is set to indicate the error."
2539 #: build/C/man3/lio_listio.3:146
2541 "The return status from B<lio_listio>() provides information only about the "
2542 "call itself, not about the individual I/O operations. One or more of the "
2543 "I/O operations may fail, but this does not prevent other operations "
2544 "completing. The status of individual I/O operations in I<aiocb_list> can be "
2545 "determined using B<aio_error>(3). When an operation has completed, its "
2546 "return status can be obtained using B<aio_return>(3). Individual I/O "
2547 "operations can fail for the reasons described in B<aio_read>(3) and "
2552 #: build/C/man3/lio_listio.3:150
2553 msgid "The B<lio_listio>() function may fail for the following reasons:"
2556 #. Doesn't happen in glibc(?)
2558 #: build/C/man3/lio_listio.3:161
2560 "The number of I/O operations specified by I<nitems> would cause the limit "
2561 "B<AIO_MAX> to be exceeded."
2564 #. Doesn't happen in glibc(?)
2566 #: build/C/man3/lio_listio.3:169
2567 msgid "I<mode> is invalid, or I<nitems> exceeds the limit B<AIO_LISTIO_MAX>."
2571 #: build/C/man3/lio_listio.3:178
2573 "I<mode> was B<LIO_WAIT> and a signal was caught before all I/O operations "
2574 "completed. (This may even be one of the signals used for asynchronous I/O "
2575 "completion notification.)"
2579 #: build/C/man3/lio_listio.3:178
2584 #. e.g., ioa_reqprio or aio_lio_opcode was invalid
2586 #: build/C/man3/lio_listio.3:186
2588 "One of more of the operations specified by I<aiocb_list> failed. The "
2589 "application can check the status of each operation using B<aio_return>(3)."
2593 #: build/C/man3/lio_listio.3:201
2595 "If B<lio_listio>() fails with the error B<EAGAIN>, B<EINTR>, or B<EIO>, "
2596 "then some of the operations in I<aiocb_list> may have been initiated. If "
2597 "B<lio_listio>() fails for any other reason, then none of the I/O operations "
2598 "has been initiated."
2602 #: build/C/man3/lio_listio.3:205
2603 msgid "The B<lio_listio>() function is available since glibc 2.1."
2606 #. or the control block of the operation
2608 #: build/C/man3/lio_listio.3:215
2610 "It is a good idea to zero out the control blocks before use. The control "
2611 "blocks must not be changed while the I/O operations are in progress. The "
2612 "buffer areas being read into or written from must not be accessed during the "
2613 "operations or undefined results may occur. The memory areas involved must "
2618 #: build/C/man3/lio_listio.3:227
2620 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_return>(3), "
2621 "B<aio_suspend>(3), B<aio_write>(3), B<aio>(7)"