po4a/aio/po/ja.po

   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.
   5 #
   6 msgid ""
   7 msgstr ""
   8 "Project-Id-Version: PACKAGE VERSION\n"
   9 "POT-Creation-Date: 2012-04-25 05:36+0900\n"
  10 "PO-Revision-Date: 2012-04-27 04:36+0900\n"
  11 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  12 "Language-Team: LANGUAGE <LL@li.org>\n"
  13 "Language: \n"
  14 "MIME-Version: 1.0\n"
  15 "Content-Type: text/plain; charset=UTF-8\n"
  16 "Content-Transfer-Encoding: 8bit\n"
  17
  18 #. type: TH
  19 #: build/C/man7/aio.7:24
  20 #, no-wrap
  21 msgid "AIO"
  22 msgstr "AIO"
  23
  24 #. type: TH
  25 #: build/C/man7/aio.7:24 build/C/man3/aio_fsync.3:23
  26 #: build/C/man3/aio_suspend.3:24 build/C/man3/aio_write.3:23
  27 #, no-wrap
  28 msgid "2010-10-02"
  29 msgstr "2010-10-02"
  30
  31 #. type: TH
  32 #: build/C/man7/aio.7:24 build/C/man3/aio_init.3:24
  33 #: build/C/man2/io_cancel.2:23 build/C/man2/io_destroy.2:23
  34 #: build/C/man2/io_getevents.2:23 build/C/man2/io_setup.2:23
  35 #: build/C/man2/io_submit.2:23
  36 #, no-wrap
  37 msgid "Linux"
  38 msgstr "Linux"
  39
  40 #. type: TH
  41 #: build/C/man7/aio.7:24 build/C/man3/aio_cancel.3:23
  42 #: build/C/man3/aio_error.3:23 build/C/man3/aio_fsync.3:23
  43 #: build/C/man3/aio_init.3:24 build/C/man3/aio_read.3:23
  44 #: build/C/man3/aio_return.3:23 build/C/man3/aio_suspend.3:24
  45 #: build/C/man3/aio_write.3:23 build/C/man2/io_cancel.2:23
  46 #: build/C/man2/io_destroy.2:23 build/C/man2/io_getevents.2:23
  47 #: build/C/man2/io_setup.2:23 build/C/man2/io_submit.2:23
  48 #: build/C/man3/lio_listio.3:23
  49 #, no-wrap
  50 msgid "Linux Programmer's Manual"
  51 msgstr "Linux Programmer's Manual"
  52
  53 #. type: SH
  54 #: build/C/man7/aio.7:25 build/C/man3/aio_cancel.3:24
  55 #: build/C/man3/aio_error.3:24 build/C/man3/aio_fsync.3:24
  56 #: build/C/man3/aio_init.3:25 build/C/man3/aio_read.3:24
  57 #: build/C/man3/aio_return.3:24 build/C/man3/aio_suspend.3:25
  58 #: build/C/man3/aio_write.3:24 build/C/man2/io_cancel.2:24
  59 #: build/C/man2/io_destroy.2:24 build/C/man2/io_getevents.2:24
  60 #: build/C/man2/io_setup.2:24 build/C/man2/io_submit.2:24
  61 #: build/C/man3/lio_listio.3:24
  62 #, no-wrap
  63 msgid "NAME"
  64 msgstr "名前"
  65
  66 #. type: Plain text
  67 #: build/C/man7/aio.7:27
  68 msgid "aio - POSIX asynchronous I/O overview"
  69 msgstr ""
  70
  71 #. type: SH
  72 #: build/C/man7/aio.7:27 build/C/man3/aio_cancel.3:32
  73 #: build/C/man3/aio_error.3:32 build/C/man3/aio_fsync.3:32
  74 #: build/C/man3/aio_init.3:36 build/C/man3/aio_read.3:32
  75 #: build/C/man3/aio_return.3:32 build/C/man3/aio_suspend.3:38
  76 #: build/C/man3/aio_write.3:32 build/C/man2/io_cancel.2:42
  77 #: build/C/man2/io_destroy.2:40 build/C/man2/io_getevents.2:43
  78 #: build/C/man2/io_setup.2:40 build/C/man2/io_submit.2:41
  79 #: build/C/man3/lio_listio.3:35
  80 #, no-wrap
  81 msgid "DESCRIPTION"
  82 msgstr "説明"
  83
  84 #. type: Plain text
  85 #: build/C/man7/aio.7:35
  86 msgid ""
  87 "The POSIX asynchronous I/O (AIO) interface allows applications to initiate "
  88 "one or more I/O operations that are performed asynchronously (i.e., in the "
  89 "background).  The application can elect to be notified of completion of the "
  90 "I/O operation in a variety of ways: by delivery of a signal, by "
  91 "instantiation of a thread, or no notification at all."
  92 msgstr ""
  93
  94 #. type: Plain text
  95 #: build/C/man7/aio.7:37
  96 msgid "The POSIX AIO interface consists of the following functions:"
  97 msgstr ""
  98
  99 #. type: TP
 100 #: build/C/man7/aio.7:37
 101 #, no-wrap
 102 msgid "B<aio_read>(3)"
 103 msgstr "B<aio_read>(3)"
 104
 105 #. type: Plain text
 106 #: build/C/man7/aio.7:42
 107 msgid "Enqueue a read request.  This is the asynchronous analog of B<read>(2)."
 108 msgstr ""
 109
 110 #. type: TP
 111 #: build/C/man7/aio.7:42
 112 #, no-wrap
 113 msgid "B<aio_write>(3)"
 114 msgstr "B<aio_write>(3)"
 115
 116 #. type: Plain text
 117 #: build/C/man7/aio.7:47
 118 msgid ""
 119 "Enqueue a write request.  This is the asynchronous analog of B<write>(2)."
 120 msgstr ""
 121
 122 #. type: TP
 123 #: build/C/man7/aio.7:47
 124 #, no-wrap
 125 msgid "B<aio_fsync>(3)"
 126 msgstr "B<aio_fsync>(3)"
 127
 128 #. type: Plain text
 129 #: build/C/man7/aio.7:54
 130 msgid ""
 131 "Enqueue a sync request for the I/O operations on a file descriptor.  This is "
 132 "the asynchronous analog of B<fsync>(2)  and B<fdatasync>(2)."
 133 msgstr ""
 134
 135 #. type: TP
 136 #: build/C/man7/aio.7:54
 137 #, no-wrap
 138 msgid "B<aio_error>(3)"
 139 msgstr "B<aio_error>(3)"
 140
 141 #. type: Plain text
 142 #: build/C/man7/aio.7:57
 143 msgid "Obtain the error status of an enqueued I/O request."
 144 msgstr ""
 145
 146 #. type: TP
 147 #: build/C/man7/aio.7:57
 148 #, no-wrap
 149 msgid "B<aio_return>(3)"
 150 msgstr "B<aio_return>(3)"
 151
 152 #. type: Plain text
 153 #: build/C/man7/aio.7:60
 154 msgid "Obtain the return status of a completed I/O request."
 155 msgstr ""
 156
 157 #. type: TP
 158 #: build/C/man7/aio.7:60
 159 #, no-wrap
 160 msgid "B<aio_suspend>(3)"
 161 msgstr "B<aio_suspend>(3)"
 162
 163 #. type: Plain text
 164 #: build/C/man7/aio.7:64
 165 msgid ""
 166 "Suspend the caller until one or more of a specified set of I/O requests "
 167 "completes."
 168 msgstr ""
 169
 170 #. type: TP
 171 #: build/C/man7/aio.7:64
 172 #, no-wrap
 173 msgid "B<aio_cancel>(3)"
 174 msgstr "B<aio_cancel>(3)"
 175
 176 #. type: Plain text
 177 #: build/C/man7/aio.7:68
 178 msgid ""
 179 "Attempt to cancel outstanding I/O requests on a specified file descriptor."
 180 msgstr ""
 181
 182 #. type: TP
 183 #: build/C/man7/aio.7:68
 184 #, no-wrap
 185 msgid "B<lio_listio>(3)"
 186 msgstr "B<lio_listio>(3)"
 187
 188 #. type: Plain text
 189 #: build/C/man7/aio.7:71
 190 msgid "Enqueue multiple I/O requests using a single function call."
 191 msgstr ""
 192
 193 #. type: Plain text
 194 #: build/C/man7/aio.7:78
 195 msgid ""
 196 "The I<aiocb> (\"asynchronous I/O control block\") structure defines "
 197 "parameters that control an I/O operation.  An argument of this type is "
 198 "employed with all of the functions listed above.  This structure has the "
 199 "following form:"
 200 msgstr ""
 201
 202 #. type: Plain text
 203 #: build/C/man7/aio.7:82
 204 #, no-wrap
 205 msgid "#include E<lt>aiocb.hE<gt>\n"
 206 msgstr "#include E<lt>aiocb.hE<gt>\n"
 207
 208 #. type: Plain text
 209 #: build/C/man7/aio.7:85
 210 #, no-wrap
 211 msgid ""
 212 "struct aiocb {\n"
 213 "    /* The order of these fields is implementation-dependent */\n"
 214 msgstr ""
 215
 216 #. type: Plain text
 217 #: build/C/man7/aio.7:94
 218 #, no-wrap
 219 msgid ""
 220 "    int             aio_fildes;     /* File descriptor */\n"
 221 "    off_t           aio_offset;     /* File offset */\n"
 222 "    volatile void  *aio_buf;        /* Location of buffer */\n"
 223 "    size_t          aio_nbytes;     /* Length of transfer */\n"
 224 "    int             aio_reqprio;    /* Request priority */\n"
 225 "    struct sigevent aio_sigevent;   /* Notification method */\n"
 226 "    int             aio_lio_opcode; /* Operation to be performed;\n"
 227 "                                       lio_listio() only */\n"
 228 msgstr ""
 229
 230 #. type: Plain text
 231 #: build/C/man7/aio.7:97
 232 #, no-wrap
 233 msgid ""
 234 "    /* Various implementation-internal fields not shown */\n"
 235 "};\n"
 236 msgstr ""
 237
 238 #. type: Plain text
 239 #: build/C/man7/aio.7:99
 240 #, no-wrap
 241 msgid "/* Operation codes for \\(aqaio_lio_opcode\\(aq: */\n"
 242 msgstr ""
 243
 244 #. type: Plain text
 245 #: build/C/man7/aio.7:101
 246 #, no-wrap
 247 msgid "enum { LIO_READ, LIO_WRITE, LIO_NOP };\n"
 248 msgstr "enum { LIO_READ, LIO_WRITE, LIO_NOP };\n"
 249
 250 #. type: Plain text
 251 #: build/C/man7/aio.7:105
 252 msgid "The fields of this structure are as follows:"
 253 msgstr ""
 254
 255 #. type: TP
 256 #: build/C/man7/aio.7:105
 257 #, no-wrap
 258 msgid "I<aio_filedes>"
 259 msgstr "I<aio_filedes>"
 260
 261 #. type: Plain text
 262 #: build/C/man7/aio.7:108
 263 msgid "The file descriptor on which the I/O operation is to be performed."
 264 msgstr ""
 265
 266 #. type: TP
 267 #: build/C/man7/aio.7:108
 268 #, no-wrap
 269 msgid "I<aio_offset>"
 270 msgstr "I<aio_offset>"
 271
 272 #. type: Plain text
 273 #: build/C/man7/aio.7:111
 274 msgid "This is the file offset at which the I/O operation is to be performed."
 275 msgstr ""
 276
 277 #. type: TP
 278 #: build/C/man7/aio.7:111
 279 #, no-wrap
 280 msgid "I<aio_buf>"
 281 msgstr "I<aio_buf>"
 282
 283 #. type: Plain text
 284 #: build/C/man7/aio.7:114
 285 msgid "This is the buffer used to transfer data for a read or write operation."
 286 msgstr ""
 287
 288 #. type: TP
 289 #: build/C/man7/aio.7:114
 290 #, no-wrap
 291 msgid "I<aio_nbytes>"
 292 msgstr "I<aio_nbytes>"
 293
 294 #. type: Plain text
 295 #: build/C/man7/aio.7:118
 296 msgid "This is the size of the buffer pointed to by I<aio_buf>."
 297 msgstr ""
 298
 299 #. type: TP
 300 #: build/C/man7/aio.7:118
 301 #, no-wrap
 302 msgid "I<aio_reqprio>"
 303 msgstr "I<aio_reqprio>"
 304
 305 #. type: Plain text
 306 #: build/C/man7/aio.7:127
 307 msgid ""
 308 "This field specifies a value that is subtracted from the calling thread's "
 309 "real-time priority in order to determine the priority for execution of this "
 310 "I/O request (see B<pthread_setschedparam>(3)).  The specified value must be "
 311 "between 0 and the value returned by I<sysconf(_SC_AIO_PRIO_DELTA_MAX)>.  "
 312 "This field is ignored for file synchronization operations."
 313 msgstr ""
 314
 315 #. type: TP
 316 #: build/C/man7/aio.7:127
 317 #, no-wrap
 318 msgid "I<aio_sigevent>"
 319 msgstr "I<aio_sigevent>"
 320
 321 #. type: Plain text
 322 #: build/C/man7/aio.7:141
 323 msgid ""
 324 "This field is a structure that specifies how the caller is to be notified "
 325 "when the asynchronous I/O operation completes.  Possible values for "
 326 "I<aio_sigevent.sigev_notify> are B<SIGEV_NONE>, B<SIGEV_SIGNAL>, and "
 327 "B<SIGEV_THREAD>.  See B<sigevent>(7)  for further details."
 328 msgstr ""
 329
 330 #. type: TP
 331 #: build/C/man7/aio.7:141
 332 #, no-wrap
 333 msgid "I<aio_lio_opcode>"
 334 msgstr "I<aio_lio_opcode>"
 335
 336 #. type: Plain text
 337 #: build/C/man7/aio.7:145
 338 msgid "The type of operation to be performed; used only for B<lio_listio>(3)."
 339 msgstr ""
 340
 341 #. type: Plain text
 342 #: build/C/man7/aio.7:148
 343 msgid ""
 344 "In addition to the standard functions listed above, the GNU C library "
 345 "provides the following extension to the POSIX AIO API:"
 346 msgstr ""
 347
 348 #. type: TP
 349 #: build/C/man7/aio.7:148
 350 #, no-wrap
 351 msgid "B<aio_init>(3)"
 352 msgstr "B<aio_init>(3)"
 353
 354 #. type: Plain text
 355 #: build/C/man7/aio.7:151
 356 msgid ""
 357 "Set parameters for tuning the behavior of the glibc POSIX AIO implementation."
 358 msgstr ""
 359
 360 #. type: SH
 361 #: build/C/man7/aio.7:151 build/C/man3/aio_read.3:132
 362 #: build/C/man3/aio_suspend.3:104 build/C/man3/aio_write.3:137
 363 #: build/C/man2/io_cancel.2:78 build/C/man2/io_destroy.2:72
 364 #: build/C/man2/io_getevents.2:85 build/C/man2/io_setup.2:81
 365 #: build/C/man2/io_submit.2:83 build/C/man3/lio_listio.3:206
 366 #, no-wrap
 367 msgid "NOTES"
 368 msgstr "注意"
 369
 370 #. type: Plain text
 371 #: build/C/man7/aio.7:158
 372 msgid ""
 373 "It is a good idea to zero out the control block buffer before use (see "
 374 "B<memset>(3)).  The control block buffer and the buffer pointed to by "
 375 "I<aio_buf> must not be changed while the I/O operation is in progress.  "
 376 "These buffers must remain valid until the I/O operation completes."
 377 msgstr ""
 378
 379 #. type: Plain text
 380 #: build/C/man7/aio.7:162
 381 msgid ""
 382 "Simultaneous asynchronous read or write operations using the same I<aiocb> "
 383 "structure yield undefined results."
 384 msgstr ""
 385
 386 #.  http://lse.sourceforge.net/io/aio.html
 387 #.  http://lse.sourceforge.net/io/aionotes.txt
 388 #.  http://lwn.net/Articles/148755/
 389 #. type: Plain text
 390 #: build/C/man7/aio.7:180
 391 msgid ""
 392 "The current Linux POSIX AIO implementation is provided in userspace by "
 393 "glibc.  This has a number of limitations, most notably that maintaining "
 394 "multiple threads to perform I/O operations is expensive and scales poorly.  "
 395 "Work has been in progress for some time on a kernel state-machine-based "
 396 "implementation of asynchronous I/O (see B<io_submit>(2), B<io_setup>(2), "
 397 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2)), but this "
 398 "implementation hasn't yet matured to the point where the POSIX AIO "
 399 "implementation can be completely reimplemented using the kernel system calls."
 400 msgstr ""
 401
 402 #. type: SH
 403 #: build/C/man7/aio.7:180 build/C/man3/aio_cancel.3:87
 404 #: build/C/man3/aio_error.3:65 build/C/man3/aio_fsync.3:78
 405 #: build/C/man3/aio_read.3:102 build/C/man3/aio_return.3:62
 406 #: build/C/man3/aio_suspend.3:87 build/C/man3/aio_write.3:109
 407 #: build/C/man2/io_cancel.2:56 build/C/man2/io_destroy.2:53
 408 #: build/C/man2/io_getevents.2:60 build/C/man2/io_setup.2:54
 409 #: build/C/man2/io_submit.2:54 build/C/man3/lio_listio.3:145
 410 #, no-wrap
 411 msgid "ERRORS"
 412 msgstr "エラー"
 413
 414 #. type: TP
 415 #: build/C/man7/aio.7:181 build/C/man3/aio_error.3:66
 416 #: build/C/man3/aio_fsync.3:86 build/C/man3/aio_read.3:110
 417 #: build/C/man3/aio_return.3:63 build/C/man3/aio_write.3:121
 418 #: build/C/man2/io_cancel.2:63 build/C/man2/io_destroy.2:57
 419 #: build/C/man2/io_getevents.2:64 build/C/man2/io_setup.2:61
 420 #: build/C/man2/io_submit.2:64 build/C/man3/lio_listio.3:160
 421 #, no-wrap
 422 msgid "B<EINVAL>"
 423 msgstr "B<EINVAL>"
 424
 425 #. type: Plain text
 426 #: build/C/man7/aio.7:190
 427 msgid ""
 428 "The I<aio_reqprio> field of the I<aiocb> structure was less than 0, or was "
 429 "greater than the limit returned by the call I<sysconf(_SC_AIO_PRIO_DELTA_MAX)"
 430 ">."
 431 msgstr ""
 432
 433 #. type: SH
 434 #: build/C/man7/aio.7:190 build/C/man3/aio_cancel.3:92
 435 #: build/C/man3/aio_error.3:73 build/C/man3/aio_fsync.3:94
 436 #: build/C/man3/aio_init.3:91 build/C/man3/aio_read.3:126
 437 #: build/C/man3/aio_return.3:68 build/C/man3/aio_suspend.3:98
 438 #: build/C/man3/aio_write.3:131 build/C/man2/io_cancel.2:70
 439 #: build/C/man2/io_destroy.2:64 build/C/man2/io_getevents.2:77
 440 #: build/C/man2/io_setup.2:73 build/C/man2/io_submit.2:75
 441 #: build/C/man3/lio_listio.3:200
 442 #, no-wrap
 443 msgid "VERSIONS"
 444 msgstr "バージョン"
 445
 446 #. type: Plain text
 447 #: build/C/man7/aio.7:192
 448 msgid "The POSIX AIO interfaces are provided by glibc since version 2.1."
 449 msgstr ""
 450
 451 #. type: SH
 452 #: build/C/man7/aio.7:192 build/C/man3/aio_cancel.3:96
 453 #: build/C/man3/aio_error.3:77 build/C/man3/aio_fsync.3:98
 454 #: build/C/man3/aio_init.3:95 build/C/man3/aio_read.3:130
 455 #: build/C/man3/aio_return.3:72 build/C/man3/aio_suspend.3:102
 456 #: build/C/man3/aio_write.3:135 build/C/man2/io_cancel.2:73
 457 #: build/C/man2/io_destroy.2:67 build/C/man2/io_getevents.2:80
 458 #: build/C/man2/io_setup.2:76 build/C/man2/io_submit.2:78
 459 #: build/C/man3/lio_listio.3:204
 460 #, no-wrap
 461 msgid "CONFORMING TO"
 462 msgstr "準拠"
 463
 464 #. type: Plain text
 465 #: build/C/man7/aio.7:194 build/C/man3/aio_cancel.3:98
 466 #: build/C/man3/aio_error.3:79 build/C/man3/aio_fsync.3:100
 467 #: build/C/man3/aio_read.3:132 build/C/man3/aio_return.3:74
 468 #: build/C/man3/aio_suspend.3:104 build/C/man3/aio_write.3:137
 469 #: build/C/man3/lio_listio.3:206
 470 msgid "POSIX.1-2001, POSIX.1-2008."
 471 msgstr "POSIX.1-2001, POSIX.1-2008."
 472
 473 #. type: SH
 474 #: build/C/man7/aio.7:194 build/C/man3/aio_cancel.3:98
 475 #: build/C/man3/aio_error.3:79 build/C/man3/aio_read.3:144
 476 #: build/C/man3/aio_return.3:74
 477 #, no-wrap
 478 msgid "EXAMPLE"
 479 msgstr "例"
 480
 481 #. type: Plain text
 482 #: build/C/man7/aio.7:207
 483 msgid ""
 484 "The program below opens each of the files named in its command-line "
 485 "arguments and queues a request on the resulting file descriptor using "
 486 "B<aio_read>(3).  The program then loops, periodically monitoring each of the "
 487 "I/O operations that is still in progress using B<aio_error>(3).  Each of the "
 488 "I/O requests is set up to provide notification by delivery of a signal.  "
 489 "After all I/O requests have completed, the program retrieves their status "
 490 "using B<aio_return>(3)."
 491 msgstr ""
 492
 493 #. type: Plain text
 494 #: build/C/man7/aio.7:213
 495 msgid ""
 496 "The B<SIGQUIT> signal (generated by typing control-\\e) causes the program "
 497 "to request cancellation of each of the outstanding requests using "
 498 "B<aio_cancel>(3)."
 499 msgstr ""
 500
 501 #. type: Plain text
 502 #: build/C/man7/aio.7:218
 503 msgid ""
 504 "Here is an example of what we might see when running this program.  In this "
 505 "example, the program queues two requests to standard input, and these are "
 506 "satisfied by two lines of input containing \"abc\" and \"x\"."
 507 msgstr ""
 508
 509 #. type: Plain text
 510 #: build/C/man7/aio.7:242
 511 #, no-wrap
 512 msgid ""
 513 "$ B<./a.out /dev/stdin /dev/stdin>\n"
 514 "opened /dev/stdin on descriptor 3\n"
 515 "opened /dev/stdin on descriptor 4\n"
 516 "aio_error():\n"
 517 "    for request 0 (descriptor 3): In progress\n"
 518 "    for request 1 (descriptor 4): In progress\n"
 519 "B<abc>\n"
 520 "I/O completion signal received\n"
 521 "aio_error():\n"
 522 "    for request 0 (descriptor 3): I/O succeeded\n"
 523 "    for request 1 (descriptor 4): In progress\n"
 524 "aio_error():\n"
 525 "    for request 1 (descriptor 4): In progress\n"
 526 "B<x>\n"
 527 "I/O completion signal received\n"
 528 "aio_error():\n"
 529 "    for request 1 (descriptor 4): I/O succeeded\n"
 530 "All I/O requests completed\n"
 531 "aio_return():\n"
 532 "    for request 0 (descriptor 3): 4\n"
 533 "    for request 1 (descriptor 4): 2\n"
 534 msgstr ""
 535
 536 #. type: SS
 537 #: build/C/man7/aio.7:244
 538 #, no-wrap
 539 msgid "Program source"
 540 msgstr ""
 541
 542 #. type: Plain text
 543 #: build/C/man7/aio.7:253
 544 #, no-wrap
 545 msgid ""
 546 "#include E<lt>stdlib.hE<gt>\n"
 547 "#include E<lt>unistd.hE<gt>\n"
 548 "#include E<lt>stdio.hE<gt>\n"
 549 "#include E<lt>errno.hE<gt>\n"
 550 "#include E<lt>aio.hE<gt>\n"
 551 "#include E<lt>signal.hE<gt>\n"
 552 msgstr ""
 553 "#include E<lt>stdlib.hE<gt>\n"
 554 "#include E<lt>unistd.hE<gt>\n"
 555 "#include E<lt>stdio.hE<gt>\n"
 556 "#include E<lt>errno.hE<gt>\n"
 557 "#include E<lt>aio.hE<gt>\n"
 558 "#include E<lt>signal.hE<gt>\n"
 559
 560 #. type: Plain text
 561 #: build/C/man7/aio.7:255
 562 #, no-wrap
 563 msgid "#define BUF_SIZE 20     /* Size of buffers for read operations */\n"
 564 msgstr "#define BUF_SIZE 20     /* Size of buffers for read operations */\n"
 565
 566 #. type: Plain text
 567 #: build/C/man7/aio.7:257
 568 #, no-wrap
 569 msgid "#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); } while (0)\n"
 570 msgstr "#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); } while (0)\n"
 571
 572 #. type: Plain text
 573 #: build/C/man7/aio.7:259
 574 #, no-wrap
 575 msgid "#define errMsg(msg)  do { perror(msg); } while (0)\n"
 576 msgstr "#define errMsg(msg)  do { perror(msg); } while (0)\n"
 577
 578 #. type: Plain text
 579 #: build/C/man7/aio.7:266
 580 #, no-wrap
 581 msgid ""
 582 "struct ioRequest {      /* Application-defined structure for tracking\n"
 583 "                           I/O requests */\n"
 584 "    int           reqNum;\n"
 585 "    int           status;\n"
 586 "    struct aiocb *aiocbp;\n"
 587 "};\n"
 588 msgstr ""
 589 "struct ioRequest {      /* Application-defined structure for tracking\n"
 590 "                           I/O requests */\n"
 591 "    int           reqNum;\n"
 592 "    int           status;\n"
 593 "    struct aiocb *aiocbp;\n"
 594 "};\n"
 595
 596 #. type: Plain text
 597 #: build/C/man7/aio.7:270
 598 #, no-wrap
 599 msgid ""
 600 "static volatile sig_atomic_t gotSIGQUIT = 0;\n"
 601 "                        /* On delivery of SIGQUIT, we attempt to\n"
 602 "                           cancel all outstanding I/O requests */\n"
 603 msgstr ""
 604 "static volatile sig_atomic_t gotSIGQUIT = 0;\n"
 605 "                        /* On delivery of SIGQUIT, we attempt to\n"
 606 "                           cancel all outstanding I/O requests */\n"
 607
 608 #. type: Plain text
 609 #: build/C/man7/aio.7:276
 610 #, no-wrap
 611 msgid ""
 612 "static void             /* Handler for SIGQUIT */\n"
 613 "quitHandler(int sig)\n"
 614 "{\n"
 615 "    gotSIGQUIT = 1;\n"
 616 "}\n"
 617 msgstr ""
 618 "static void             /* Handler for SIGQUIT */\n"
 619 "quitHandler(int sig)\n"
 620 "{\n"
 621 "    gotSIGQUIT = 1;\n"
 622 "}\n"
 623
 624 #. type: Plain text
 625 #: build/C/man7/aio.7:278
 626 #, no-wrap
 627 msgid "#define IO_SIGNAL SIGUSR1   /* Signal used to notify I/O completion */\n"
 628 msgstr "#define IO_SIGNAL SIGUSR1   /* Signal used to notify I/O completion */\n"
 629
 630 #. type: Plain text
 631 #: build/C/man7/aio.7:283
 632 #, no-wrap
 633 msgid ""
 634 "static void                 /* Handler for I/O completion signal */\n"
 635 "aioSigHandler(int sig, siginfo_t *si, void *ucontext)\n"
 636 "{\n"
 637 "    write(STDOUT_FILENO, \"I/O completion signal received\\en\", 31);\n"
 638 msgstr ""
 639 "static void                 /* Handler for I/O completion signal */\n"
 640 "aioSigHandler(int sig, siginfo_t *si, void *ucontext)\n"
 641 "{\n"
 642 "    write(STDOUT_FILENO, \"I/O completion signal received\\en\", 31);\n"
 643
 644 #. type: Plain text
 645 #: build/C/man7/aio.7:289
 646 #, no-wrap
 647 msgid ""
 648 "    /* The corresponding ioRequest structure would be available as\n"
 649 "           struct ioRequest *ioReq = si-E<gt>si_value.sival_ptr;\n"
 650 "       and the file descriptor would then be available via\n"
 651 "           ioReq-E<gt>aiocbp-E<gt>aio_fildes */\n"
 652 "}\n"
 653 msgstr ""
 654 "    /* The corresponding ioRequest structure would be available as\n"
 655 "           struct ioRequest *ioReq = si-E<gt>si_value.sival_ptr;\n"
 656 "       and the file descriptor would then be available via\n"
 657 "           ioReq-E<gt>aiocbp-E<gt>aio_fildes */\n"
 658 "}\n"
 659
 660 #. type: Plain text
 661 #: build/C/man7/aio.7:299
 662 #, no-wrap
 663 msgid ""
 664 "int\n"
 665 "main(int argc, char *argv[])\n"
 666 "{\n"
 667 "    struct ioRequest *ioList;\n"
 668 "    struct aiocb *aiocbList;\n"
 669 "    struct sigaction sa;\n"
 670 "    int s, j;\n"
 671 "    int numReqs;        /* Total number of queued I/O requests */\n"
 672 "    int openReqs;       /* Number of I/O requests still in progress */\n"
 673 msgstr ""
 674 "int\n"
 675 "main(int argc, char *argv[])\n"
 676 "{\n"
 677 "    struct ioRequest *ioList;\n"
 678 "    struct aiocb *aiocbList;\n"
 679 "    struct sigaction sa;\n"
 680 "    int s, j;\n"
 681 "    int numReqs;        /* Total number of queued I/O requests */\n"
 682 "    int openReqs;       /* Number of I/O requests still in progress */\n"
 683
 684 #. type: Plain text
 685 #: build/C/man7/aio.7:305
 686 #, no-wrap
 687 msgid ""
 688 "    if (argc E<lt> 2) {\n"
 689 "        fprintf(stderr, \"Usage: %s E<lt>pathnameE<gt> E<lt>pathnameE<gt>...\\en\",\n"
 690 "                argv[0]);\n"
 691 "        exit(EXIT_FAILURE);\n"
 692 "    }\n"
 693 msgstr ""
 694 "    if (argc E<lt> 2) {\n"
 695 "        fprintf(stderr, \"Usage: %s E<lt>pathnameE<gt> E<lt>pathnameE<gt>...\\en\",\n"
 696 "                argv[0]);\n"
 697 "        exit(EXIT_FAILURE);\n"
 698 "    }\n"
 699
 700 #. type: Plain text
 701 #: build/C/man7/aio.7:307
 702 #, no-wrap
 703 msgid "    numReqs = argc - 1;\n"
 704 msgstr "    numReqs = argc - 1;\n"
 705
 706 #. type: Plain text
 707 #: build/C/man7/aio.7:309
 708 #, no-wrap
 709 msgid "    /* Allocate our arrays */\n"
 710 msgstr "    /* Allocate our arrays */\n"
 711
 712 #. type: Plain text
 713 #: build/C/man7/aio.7:313
 714 #, no-wrap
 715 msgid ""
 716 "    ioList = calloc(numReqs, sizeof(struct ioRequest));\n"
 717 "    if (ioList == NULL)\n"
 718 "        errExit(\"calloc\");\n"
 719 msgstr ""
 720 "    ioList = calloc(numReqs, sizeof(struct ioRequest));\n"
 721 "    if (ioList == NULL)\n"
 722 "        errExit(\"calloc\");\n"
 723
 724 #. type: Plain text
 725 #: build/C/man7/aio.7:317
 726 #, no-wrap
 727 msgid ""
 728 "    aiocbList = calloc(numReqs, sizeof(struct aiocb));\n"
 729 "    if (aiocbList == NULL)\n"
 730 "        errExit(\"calloc\");\n"
 731 msgstr ""
 732 "    aiocbList = calloc(numReqs, sizeof(struct aiocb));\n"
 733 "    if (aiocbList == NULL)\n"
 734 "        errExit(\"calloc\");\n"
 735
 736 #. type: Plain text
 737 #: build/C/man7/aio.7:319
 738 #, no-wrap
 739 msgid "    /* Establish handlers for SIGQUIT and the I/O completion signal */\n"
 740 msgstr "    /* Establish handlers for SIGQUIT and the I/O completion signal */\n"
 741
 742 #. type: Plain text
 743 #: build/C/man7/aio.7:322
 744 #, no-wrap
 745 msgid ""
 746 "    sa.sa_flags = SA_RESTART;\n"
 747 "    sigemptyset(&sa.sa_mask);\n"
 748 msgstr ""
 749 "    sa.sa_flags = SA_RESTART;\n"
 750 "    sigemptyset(&sa.sa_mask);\n"
 751
 752 #. type: Plain text
 753 #: build/C/man7/aio.7:326
 754 #, no-wrap
 755 msgid ""
 756 "    sa.sa_handler = quitHandler;\n"
 757 "    if (sigaction(SIGQUIT, &sa, NULL) == -1)\n"
 758 "        errExit(\"sigaction\");\n"
 759 msgstr ""
 760 "    sa.sa_handler = quitHandler;\n"
 761 "    if (sigaction(SIGQUIT, &sa, NULL) == -1)\n"
 762 "        errExit(\"sigaction\");\n"
 763
 764 #. type: Plain text
 765 #: build/C/man7/aio.7:331
 766 #, no-wrap
 767 msgid ""
 768 "    sa.sa_flags = SA_RESTART | SA_SIGINFO;\n"
 769 "    sa.sa_sigaction = aioSigHandler;\n"
 770 "    if (sigaction(IO_SIGNAL, &sa, NULL) == -1)\n"
 771 "        errExit(\"sigaction\");\n"
 772 msgstr ""
 773 "    sa.sa_flags = SA_RESTART | SA_SIGINFO;\n"
 774 "    sa.sa_sigaction = aioSigHandler;\n"
 775 "    if (sigaction(IO_SIGNAL, &sa, NULL) == -1)\n"
 776 "        errExit(\"sigaction\");\n"
 777
 778 #. type: Plain text
 779 #: build/C/man7/aio.7:334
 780 #, no-wrap
 781 msgid ""
 782 "    /* Open each file specified on the command line, and queue\n"
 783 "       a read request on the resulting file descriptor */\n"
 784 msgstr ""
 785 "    /* Open each file specified on the command line, and queue\n"
 786 "       a read request on the resulting file descriptor */\n"
 787
 788 #. type: Plain text
 789 #: build/C/man7/aio.7:339
 790 #, no-wrap
 791 msgid ""
 792 "    for (j = 0; j E<lt> numReqs; j++) {\n"
 793 "        ioList[j].reqNum = j;\n"
 794 "        ioList[j].status = EINPROGRESS;\n"
 795 "        ioList[j].aiocbp = &aiocbList[j];\n"
 796 msgstr ""
 797 "    for (j = 0; j E<lt> numReqs; j++) {\n"
 798 "        ioList[j].reqNum = j;\n"
 799 "        ioList[j].status = EINPROGRESS;\n"
 800 "        ioList[j].aiocbp = &aiocbList[j];\n"
 801
 802 #. type: Plain text
 803 #: build/C/man7/aio.7:345
 804 #, no-wrap
 805 msgid ""
 806 "        ioList[j].aiocbp-E<gt>aio_fildes = open(argv[j + 1], O_RDONLY);\n"
 807 "        if (ioList[j].aiocbp-E<gt>aio_fildes == -1)\n"
 808 "            errExit(\"open\");\n"
 809 "        printf(\"opened %s on descriptor %d\\en\", argv[j + 1],\n"
 810 "                ioList[j].aiocbp-E<gt>aio_fildes);\n"
 811 msgstr ""
 812 "        ioList[j].aiocbp-E<gt>aio_fildes = open(argv[j + 1], O_RDONLY);\n"
 813 "        if (ioList[j].aiocbp-E<gt>aio_fildes == -1)\n"
 814 "            errExit(\"open\");\n"
 815 "        printf(\"opened %s on descriptor %d\\en\", argv[j + 1],\n"
 816 "                ioList[j].aiocbp-E<gt>aio_fildes);\n"
 817
 818 #. type: Plain text
 819 #: build/C/man7/aio.7:349
 820 #, no-wrap
 821 msgid ""
 822 "        ioList[j].aiocbp-E<gt>aio_buf = malloc(BUF_SIZE);\n"
 823 "        if (ioList[j].aiocbp-E<gt>aio_buf == NULL)\n"
 824 "            errExit(\"malloc\");\n"
 825 msgstr ""
 826 "        ioList[j].aiocbp-E<gt>aio_buf = malloc(BUF_SIZE);\n"
 827 "        if (ioList[j].aiocbp-E<gt>aio_buf == NULL)\n"
 828 "            errExit(\"malloc\");\n"
 829
 830 #. type: Plain text
 831 #: build/C/man7/aio.7:357
 832 #, no-wrap
 833 msgid ""
 834 "        ioList[j].aiocbp-E<gt>aio_nbytes = BUF_SIZE;\n"
 835 "        ioList[j].aiocbp-E<gt>aio_reqprio = 0;\n"
 836 "        ioList[j].aiocbp-E<gt>aio_offset = 0;\n"
 837 "        ioList[j].aiocbp-E<gt>aio_sigevent.sigev_notify = SIGEV_SIGNAL;\n"
 838 "        ioList[j].aiocbp-E<gt>aio_sigevent.sigev_signo = IO_SIGNAL;\n"
 839 "        ioList[j].aiocbp-E<gt>aio_sigevent.sigev_value.sival_ptr =\n"
 840 "                                &ioList[j];\n"
 841 msgstr ""
 842 "        ioList[j].aiocbp-E<gt>aio_nbytes = BUF_SIZE;\n"
 843 "        ioList[j].aiocbp-E<gt>aio_reqprio = 0;\n"
 844 "        ioList[j].aiocbp-E<gt>aio_offset = 0;\n"
 845 "        ioList[j].aiocbp-E<gt>aio_sigevent.sigev_notify = SIGEV_SIGNAL;\n"
 846 "        ioList[j].aiocbp-E<gt>aio_sigevent.sigev_signo = IO_SIGNAL;\n"
 847 "        ioList[j].aiocbp-E<gt>aio_sigevent.sigev_value.sival_ptr =\n"
 848 "                                &ioList[j];\n"
 849
 850 #. type: Plain text
 851 #: build/C/man7/aio.7:362
 852 #, no-wrap
 853 msgid ""
 854 "        s = aio_read(ioList[j].aiocbp);\n"
 855 "        if (s == -1)\n"
 856 "            errExit(\"aio_read\");\n"
 857 "    }\n"
 858 msgstr ""
 859 "        s = aio_read(ioList[j].aiocbp);\n"
 860 "        if (s == -1)\n"
 861 "            errExit(\"aio_read\");\n"
 862 "    }\n"
 863
 864 #. type: Plain text
 865 #: build/C/man7/aio.7:364
 866 #, no-wrap
 867 msgid "    openReqs = numReqs;\n"
 868 msgstr "    openReqs = numReqs;\n"
 869
 870 #. type: Plain text
 871 #: build/C/man7/aio.7:366
 872 #, no-wrap
 873 msgid "    /* Loop, monitoring status of I/O requests */\n"
 874 msgstr "    /* Loop, monitoring status of I/O requests */\n"
 875
 876 #. type: Plain text
 877 #: build/C/man7/aio.7:369
 878 #, no-wrap
 879 msgid ""
 880 "    while (openReqs E<gt> 0) {\n"
 881 "        sleep(3);       /* Delay between each monitoring step */\n"
 882 msgstr ""
 883 "    while (openReqs E<gt> 0) {\n"
 884 "        sleep(3);       /* Delay between each monitoring step */\n"
 885
 886 #. type: Plain text
 887 #: build/C/man7/aio.7:371
 888 #, no-wrap
 889 msgid "        if (gotSIGQUIT) {\n"
 890 msgstr "        if (gotSIGQUIT) {\n"
 891
 892 #. type: Plain text
 893 #: build/C/man7/aio.7:375
 894 #, no-wrap
 895 msgid ""
 896 "            /* On receipt of SIGQUIT, attempt to cancel each of the\n"
 897 "               outstanding I/O requests, and display status returned\n"
 898 "               from the cancellation requests */\n"
 899 msgstr ""
 900 "            /* On receipt of SIGQUIT, attempt to cancel each of the\n"
 901 "               outstanding I/O requests, and display status returned\n"
 902 "               from the cancellation requests */\n"
 903
 904 #. type: Plain text
 905 #: build/C/man7/aio.7:377
 906 #, no-wrap
 907 msgid "            printf(\"got SIGQUIT; canceling I/O requests: \\en\");\n"
 908 msgstr "            printf(\"got SIGQUIT; canceling I/O requests: \\en\");\n"
 909
 910 #. type: Plain text
 911 #: build/C/man7/aio.7:394
 912 #, no-wrap
 913 msgid ""
 914 "            for (j = 0; j E<lt> numReqs; j++) {\n"
 915 "                if (ioList[j].status == EINPROGRESS) {\n"
 916 "                    printf(\"    Request %d on descriptor %d:\", j,\n"
 917 "                            ioList[j].aiocbp-E<gt>aio_fildes);\n"
 918 "                    s = aio_cancel(ioList[j].aiocbp-E<gt>aio_fildes,\n"
 919 "                            ioList[j].aiocbp);\n"
 920 "                    if (s == AIO_CANCELED)\n"
 921 "                        printf(\"I/O canceled\\en\");\n"
 922 "                    else if (s == AIO_NOTCANCELED)\n"
 923 "                            printf(\"I/O not canceled\\en\");\n"
 924 "                    else if (s == AIO_ALLDONE)\n"
 925 "                        printf(\"I/O all done\\en\");\n"
 926 "                    else\n"
 927 "                        errMsg(\"aio_cancel\");\n"
 928 "                }\n"
 929 "            }\n"
 930 msgstr ""
 931 "            for (j = 0; j E<lt> numReqs; j++) {\n"
 932 "                if (ioList[j].status == EINPROGRESS) {\n"
 933 "                    printf(\"    Request %d on descriptor %d:\", j,\n"
 934 "                            ioList[j].aiocbp-E<gt>aio_fildes);\n"
 935 "                    s = aio_cancel(ioList[j].aiocbp-E<gt>aio_fildes,\n"
 936 "                            ioList[j].aiocbp);\n"
 937 "                    if (s == AIO_CANCELED)\n"
 938 "                        printf(\"I/O canceled\\en\");\n"
 939 "                    else if (s == AIO_NOTCANCELED)\n"
 940 "                            printf(\"I/O not canceled\\en\");\n"
 941 "                    else if (s == AIO_ALLDONE)\n"
 942 "                        printf(\"I/O all done\\en\");\n"
 943 "                    else\n"
 944 "                        errMsg(\"aio_cancel\");\n"
 945 "                }\n"
 946 "            }\n"
 947
 948 #. type: Plain text
 949 #: build/C/man7/aio.7:397
 950 #, no-wrap
 951 msgid ""
 952 "            gotSIGQUIT = 0;\n"
 953 "        }\n"
 954 msgstr ""
 955 "            gotSIGQUIT = 0;\n"
 956 "        }\n"
 957
 958 #. type: Plain text
 959 #: build/C/man7/aio.7:400
 960 #, no-wrap
 961 msgid ""
 962 "        /* Check the status of each I/O request that is still\n"
 963 "           in progress */\n"
 964 msgstr ""
 965 "        /* Check the status of each I/O request that is still\n"
 966 "           in progress */\n"
 967
 968 #. type: Plain text
 969 #: build/C/man7/aio.7:407
 970 #, no-wrap
 971 msgid ""
 972 "        printf(\"aio_error():\\en\");\n"
 973 "        for (j = 0; j E<lt> numReqs; j++) {\n"
 974 "            if (ioList[j].status == EINPROGRESS) {\n"
 975 "                printf(\"    for request %d (descriptor %d): \",\n"
 976 "                        j, ioList[j].aiocbp-E<gt>aio_fildes);\n"
 977 "                ioList[j].status = aio_error(ioList[j].aiocbp);\n"
 978 msgstr ""
 979 "        printf(\"aio_error():\\en\");\n"
 980 "        for (j = 0; j E<lt> numReqs; j++) {\n"
 981 "            if (ioList[j].status == EINPROGRESS) {\n"
 982 "                printf(\"    for request %d (descriptor %d): \",\n"
 983 "                        j, ioList[j].aiocbp-E<gt>aio_fildes);\n"
 984 "                ioList[j].status = aio_error(ioList[j].aiocbp);\n"
 985
 986 #. type: Plain text
 987 #: build/C/man7/aio.7:422
 988 #, no-wrap
 989 msgid ""
 990 "                switch (ioList[j].status) {\n"
 991 "                case 0:\n"
 992 "                    printf(\"I/O succeeded\\en\");\n"
 993 "                    break;\n"
 994 "                case EINPROGRESS:\n"
 995 "                    printf(\"In progress\\en\");\n"
 996 "                    break;\n"
 997 "                case ECANCELED:\n"
 998 "                    printf(\"Canceled\\en\");\n"
 999 "                    break;\n"
1000 "                default:\n"
1001 "                    errMsg(\"aio_error\");\n"
1002 "                    break;\n"
1003 "                }\n"
1004 msgstr ""
1005 "                switch (ioList[j].status) {\n"
1006 "                case 0:\n"
1007 "                    printf(\"I/O succeeded\\en\");\n"
1008 "                    break;\n"
1009 "                case EINPROGRESS:\n"
1010 "                    printf(\"In progress\\en\");\n"
1011 "                    break;\n"
1012 "                case ECANCELED:\n"
1013 "                    printf(\"Canceled\\en\");\n"
1014 "                    break;\n"
1015 "                default:\n"
1016 "                    errMsg(\"aio_error\");\n"
1017 "                    break;\n"
1018 "                }\n"
1019
1020 #. type: Plain text
1021 #: build/C/man7/aio.7:428
1022 #, no-wrap
1023 msgid ""
1024 "                if (ioList[j].status != EINPROGRESS)\n"
1025 "                    openReqs--;\n"
1026 "            }\n"
1027 "        }\n"
1028 "    }\n"
1029 msgstr ""
1030 "                if (ioList[j].status != EINPROGRESS)\n"
1031 "                    openReqs--;\n"
1032 "            }\n"
1033 "        }\n"
1034 "    }\n"
1035
1036 #. type: Plain text
1037 #: build/C/man7/aio.7:430
1038 #, no-wrap
1039 msgid "    printf(\"All I/O requests completed\\en\");\n"
1040 msgstr "    printf(\"All I/O requests completed\\en\");\n"
1041
1042 #. type: Plain text
1043 #: build/C/man7/aio.7:432
1044 #, no-wrap
1045 msgid "    /* Check status return of all I/O requests */\n"
1046 msgstr "    /* Check status return of all I/O requests */\n"
1047
1048 #. type: Plain text
1049 #: build/C/man7/aio.7:436
1050 #, no-wrap
1051 msgid ""
1052 "    printf(\"aio_return():\\en\");\n"
1053 "    for (j = 0; j E<lt> numReqs; j++) {\n"
1054 "        ssize_t s;\n"
1055 msgstr ""
1056 "    printf(\"aio_return():\\en\");\n"
1057 "    for (j = 0; j E<lt> numReqs; j++) {\n"
1058 "        ssize_t s;\n"
1059
1060 #. type: Plain text
1061 #: build/C/man7/aio.7:441
1062 #, no-wrap
1063 msgid ""
1064 "        s = aio_return(ioList[j].aiocbp);\n"
1065 "        printf(\"    for request %d (descriptor %d): %ld\\en\",\n"
1066 "                j, ioList[j].aiocbp-E<gt>aio_fildes, (long) s);\n"
1067 "    }\n"
1068 msgstr ""
1069 "        s = aio_return(ioList[j].aiocbp);\n"
1070 "        printf(\"    for request %d (descriptor %d): %ld\\en\",\n"
1071 "                j, ioList[j].aiocbp-E<gt>aio_fildes, (long) s);\n"
1072 "    }\n"
1073
1074 #. type: Plain text
1075 #: build/C/man7/aio.7:444
1076 #, no-wrap
1077 msgid ""
1078 "    exit(EXIT_SUCCESS);\n"
1079 "}\n"
1080 msgstr ""
1081 "    exit(EXIT_SUCCESS);\n"
1082 "}\n"
1083
1084 #. type: SH
1085 #: build/C/man7/aio.7:445 build/C/man3/aio_cancel.3:101
1086 #: build/C/man3/aio_error.3:82 build/C/man3/aio_fsync.3:100
1087 #: build/C/man3/aio_init.3:97 build/C/man3/aio_read.3:147
1088 #: build/C/man3/aio_return.3:77 build/C/man3/aio_suspend.3:124
1089 #: build/C/man3/aio_write.3:149 build/C/man2/io_cancel.2:94
1090 #: build/C/man2/io_destroy.2:88 build/C/man2/io_getevents.2:101
1091 #: build/C/man2/io_setup.2:97 build/C/man2/io_submit.2:99
1092 #: build/C/man3/lio_listio.3:218
1093 #, no-wrap
1094 msgid "SEE ALSO"
1095 msgstr "関連項目"
1096
1097 #. type: Plain text
1098 #: build/C/man7/aio.7:459
1099 msgid ""
1100 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), "
1101 "B<io_submit>(2), B<aio_cancel>(3), B<aio_error>(3), B<aio_init>(3), "
1102 "B<aio_read>(3), B<aio_return>(3), B<aio_write>(3), B<lio_listio>(3), http://"
1103 "www.squid-cache.org/~adrian/Reprint-Pulavarty-OLS2003.pdf"
1104 msgstr ""
1105 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), "
1106 "B<io_submit>(2), B<aio_cancel>(3), B<aio_error>(3), B<aio_init>(3), "
1107 "B<aio_read>(3), B<aio_return>(3), B<aio_write>(3), B<lio_listio>(3), http://"
1108 "www.squid-cache.org/~adrian/Reprint-Pulavarty-OLS2003.pdf"
1109
1110 #. type: TH
1111 #: build/C/man3/aio_cancel.3:23
1112 #, no-wrap
1113 msgid "AIO_CANCEL"
1114 msgstr "AIO_CANCEL"
1115
1116 #. type: TH
1117 #: build/C/man3/aio_cancel.3:23
1118 #, no-wrap
1119 msgid "2011-10-04"
1120 msgstr "2011-10-04"
1121
1122 #. type: Plain text
1123 #: build/C/man3/aio_cancel.3:26
1124 msgid "aio_cancel - cancel an outstanding asynchronous I/O request"
1125 msgstr "aio_cancel - 完了していない非同期 I/O リクエストをキャンセルする"
1126
1127 #. type: SH
1128 #: build/C/man3/aio_cancel.3:26 build/C/man3/aio_error.3:26
1129 #: build/C/man3/aio_fsync.3:26 build/C/man3/aio_init.3:27
1130 #: build/C/man3/aio_read.3:26 build/C/man3/aio_return.3:26
1131 #: build/C/man3/aio_suspend.3:27 build/C/man3/aio_write.3:26
1132 #: build/C/man2/io_cancel.2:26 build/C/man2/io_destroy.2:26
1133 #: build/C/man2/io_getevents.2:26 build/C/man2/io_setup.2:26
1134 #: build/C/man2/io_submit.2:26 build/C/man3/lio_listio.3:26
1135 #, no-wrap
1136 msgid "SYNOPSIS"
1137 msgstr "書式"
1138
1139 #. type: Plain text
1140 #: build/C/man3/aio_cancel.3:28 build/C/man3/aio_error.3:28
1141 #: build/C/man3/aio_fsync.3:28 build/C/man3/aio_read.3:28
1142 #: build/C/man3/aio_return.3:28 build/C/man3/aio_write.3:28
1143 msgid "B<#include E<lt>aio.hE<gt>>"
1144 msgstr "B<#include E<lt>aio.hE<gt>>"
1145
1146 #. type: Plain text
1147 #: build/C/man3/aio_cancel.3:30
1148 msgid "B<int aio_cancel(int >I<fd>B<, struct aiocb *>I<aiocbp>B<);>"
1149 msgstr "B<int aio_cancel(int >I<fd>B<, struct aiocb *>I<aiocbp>B<);>"
1150
1151 #. type: Plain text
1152 #: build/C/man3/aio_cancel.3:32 build/C/man3/aio_error.3:32
1153 #: build/C/man3/aio_fsync.3:32 build/C/man3/aio_init.3:36
1154 #: build/C/man3/aio_read.3:32 build/C/man3/aio_return.3:32
1155 #: build/C/man3/aio_write.3:32
1156 msgid "Link with I<-lrt>."
1157 msgstr "I<-lrt> でリンクする。"
1158
1159 #. type: Plain text
1160 #: build/C/man3/aio_cancel.3:50
1161 msgid ""
1162 "The B<aio_cancel>()  function attempts to cancel outstanding asynchronous I/"
1163 "O requests for the file descriptor I<fd>.  If I<aiocbp> is NULL, all such "
1164 "requests are canceled.  Otherwise, only the request described by the control "
1165 "block pointed to by I<aiocbp> is canceled.  (See B<aio>(7)  for a "
1166 "description of the I<aiocb> structure.)"
1167 msgstr ""
1168 "B<aio_cancel>() 関数は、ファイルディスクリプタ I<fd> についての完了していない\n"
1169 "非同期 I/O リクエストをキャンセルしようとする。 I<aiocbp> が NULL の場合、そ\n"
1170 "のような全てのリクエストがキャンセルされる。 I<aiocbp> が NULL でない場合、\n"
1171 "I<aiocbp> で指された制御ブロックで記述されたリクエストのみがキャンセルされる。\n"
1172 "(I<aiocb> 構造体の説明は B<aio>(7) を参照)"
1173
1174 #. type: Plain text
1175 #: build/C/man3/aio_cancel.3:59
1176 msgid ""
1177 "Normal asynchronous notification occurs for canceled requests.  The request "
1178 "return status (B<aio_return>(3))  is set to -1, and the request error status "
1179 "(B<aio_error>(3))  is set to B<ECANCELED>.  The control block of requests "
1180 "that cannot be canceled is not changed."
1181 msgstr ""
1182 "キャンセルされたリクエストに対して、通常の非同期通知が起こる。\n"
1183 "リクエストの返り値 (B<aio_return>(3)) は -1 に設定され、\n"
1184 "リクエストのエラー状態 (B<aio_error>(3)) は B<ECANCELED> に設定される。\n"
1185 "キャンセルできないリクエストの制御ブロックは変更されない。"
1186
1187 #. type: Plain text
1188 #: build/C/man3/aio_cancel.3:66
1189 msgid ""
1190 "If I<aiocbp> is not NULL, and I<fd> differs from the file descriptor with "
1191 "which the asynchronous operation was initiated, unspecified results occur."
1192 msgstr ""
1193 "I<aiocbp> が NULL でなく、かつ I<fd> が非同期操作が開始されたファイルディスク"
1194 "リプタと異なる場合、 生じる結果は不定である。"
1195
1196 #.  FreeBSD: not those on raw disk devices.
1197 #. type: Plain text
1198 #: build/C/man3/aio_cancel.3:69
1199 msgid "Which operations are cancelable is implementation-defined."
1200 msgstr "どの操作をキャンセルできるかは、実装定義である。"
1201
1202 #. type: SH
1203 #: build/C/man3/aio_cancel.3:69 build/C/man3/aio_error.3:43
1204 #: build/C/man3/aio_fsync.3:72 build/C/man3/aio_read.3:87
1205 #: build/C/man3/aio_return.3:48 build/C/man3/aio_suspend.3:79
1206 #: build/C/man3/aio_write.3:94 build/C/man2/io_cancel.2:51
1207 #: build/C/man2/io_destroy.2:48 build/C/man2/io_getevents.2:54
1208 #: build/C/man2/io_setup.2:49 build/C/man2/io_submit.2:48
1209 #: build/C/man3/lio_listio.3:107
1210 #, no-wrap
1211 msgid "RETURN VALUE"
1212 msgstr "返り値"
1213
1214 #. type: Plain text
1215 #: build/C/man3/aio_cancel.3:87
1216 msgid ""
1217 "This function returns B<AIO_CANCELED> if all requests were successfully "
1218 "canceled.  It returns B<AIO_NOTCANCELED> when at least one of the requests "
1219 "specified was not canceled because it was in progress.  In this case one may "
1220 "check the status of individual requests using B<aio_error>(3).  This "
1221 "function returns B<AIO_ALLDONE> if all requests had already been completed "
1222 "before this call.  When some error occurs, -1 is returned, and I<errno> is "
1223 "set appropriately."
1224 msgstr ""
1225 "全てのリクエストのキャンセルが成功した場合、この関数は B<AIO_CANCELED> を返"
1226 "す。 指定されたリクエストのうち少なくとも 1 つが進行中であるために キャンセル"
1227 "できなかった場合は、 B<AIO_NOTCANCELED> が返される。 この場合は、 "
1228 "B<aio_error>(3)  を使って個々のリクエストの状態をチェックすることができる。 "
1229 "呼び出される前に全てのリクエストが完了していた場合、 この関数は "
1230 "B<AIO_ALLDONE> を返す。 何らかのエラーが起こった場合は、-1 が返されて、 "
1231 "I<errno> が適切に設定される。"
1232
1233 #. type: TP
1234 #: build/C/man3/aio_cancel.3:88 build/C/man3/aio_fsync.3:82
1235 #: build/C/man3/aio_read.3:106 build/C/man3/aio_write.3:113
1236 #: build/C/man2/io_submit.2:58
1237 #, no-wrap
1238 msgid "B<EBADF>"
1239 msgstr "B<EBADF>"
1240
1241 #. type: Plain text
1242 #: build/C/man3/aio_cancel.3:92
1243 msgid "I<fd> is not a valid file descriptor."
1244 msgstr "I<fd> が有効なファイルディスクリプタでない。"
1245
1246 #. type: Plain text
1247 #: build/C/man3/aio_cancel.3:96
1248 msgid "The B<aio_cancel>()  function is available since glibc 2.1."
1249 msgstr ""
1250
1251 #. type: Plain text
1252 #: build/C/man3/aio_cancel.3:101 build/C/man3/aio_error.3:82
1253 #: build/C/man3/aio_read.3:147 build/C/man3/aio_return.3:77
1254 msgid "See B<aio>(7)."
1255 msgstr "B<aio>(7) を参照。"
1256
1257 #. type: Plain text
1258 #: build/C/man3/aio_cancel.3:109
1259 msgid ""
1260 "B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_return>(3), "
1261 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1262 msgstr ""
1263 "B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_return>(3), \n"
1264 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1265
1266 #. type: TH
1267 #: build/C/man3/aio_error.3:23
1268 #, no-wrap
1269 msgid "AIO_ERROR"
1270 msgstr "AIO_ERROR"
1271
1272 #. type: TH
1273 #: build/C/man3/aio_error.3:23 build/C/man3/aio_read.3:23
1274 #: build/C/man3/aio_return.3:23
1275 #, no-wrap
1276 msgid "2010-10-03"
1277 msgstr "2010-10-03"
1278
1279 #. type: Plain text
1280 #: build/C/man3/aio_error.3:26
1281 msgid "aio_error - get error status of asynchronous I/O operation"
1282 msgstr "aio_error - 非同期 I/O 操作のエラー状態を取得する"
1283
1284 #. type: Plain text
1285 #: build/C/man3/aio_error.3:30
1286 msgid "B<int aio_error(const struct aiocb *>I<aiocbp>B<);>"
1287 msgstr "B<int aio_error(const struct aiocb *>I<aiocbp>B<);>"
1288
1289 #. type: Plain text
1290 #: build/C/man3/aio_error.3:43
1291 msgid ""
1292 "The B<aio_error>()  function returns the error status for the asynchronous I/"
1293 "O request with control block pointed to by I<aiocbp>.  (See B<aio>(7)  for a "
1294 "description of the I<aiocb> structure.)"
1295 msgstr ""
1296 "B<aio_error>() 関数は I<aiocbp> で指された制御ブロックでの非同期 I/O リクエス\n"
1297 "トのエラー状態を返す。(I<aiocb> 構造体の説明は B<aio>(7) を参照)"
1298
1299 #. type: Plain text
1300 #: build/C/man3/aio_error.3:45
1301 msgid "This function returns one of the following:"
1302 msgstr ""
1303
1304 #. type: IP
1305 #: build/C/man3/aio_error.3:45 build/C/man3/aio_error.3:49
1306 #: build/C/man3/aio_error.3:52 build/C/man3/aio_error.3:54
1307 #: build/C/man3/aio_suspend.3:42 build/C/man3/aio_suspend.3:46
1308 #: build/C/man3/aio_suspend.3:48
1309 #, no-wrap
1310 msgid "*"
1311 msgstr ""
1312
1313 #. type: Plain text
1314 #: build/C/man3/aio_error.3:49
1315 msgid "B<EINPROGRESS>, if the request has not been completed yet."
1316 msgstr ""
1317
1318 #. type: Plain text
1319 #: build/C/man3/aio_error.3:52
1320 msgid "B<ECANCELED>, if the request was canceled."
1321 msgstr ""
1322
1323 #. type: Plain text
1324 #: build/C/man3/aio_error.3:54
1325 msgid "0, if the request completed successfully."
1326 msgstr ""
1327
1328 #. type: Plain text
1329 #: build/C/man3/aio_error.3:65
1330 msgid ""
1331 "A positive error, if the asynchronous I/O operation failed.  This is the "
1332 "same value that would have been stored in the I<errno> variable in the case "
1333 "of a synchronous B<read>(2), B<write>(2), B<fsync>(2), or B<fdatasync>(2)  "
1334 "call."
1335 msgstr ""
1336
1337 #. type: Plain text
1338 #: build/C/man3/aio_error.3:73
1339 msgid ""
1340 "I<aiocbp> does not point at a control block for an asynchronous I/O request "
1341 "of which the return status (see B<aio_return>(3))  has not been retrieved "
1342 "yet."
1343 msgstr ""
1344 "I<aiocbp> が、まだ返り値 (return status)  (B<aio_return>(3)  を参照) が取得さ"
1345 "れていない非同期 I/O リクエストの制御ブロックを指していない。"
1346
1347 #. type: Plain text
1348 #: build/C/man3/aio_error.3:77
1349 msgid "The B<aio_error>()  function is available since glibc 2.1."
1350 msgstr ""
1351
1352 #. type: Plain text
1353 #: build/C/man3/aio_error.3:90
1354 msgid ""
1355 "B<aio_cancel>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_return>(3), "
1356 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1357 msgstr "B<aio_cancel>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_return>(3), B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1358
1359 #. type: TH
1360 #: build/C/man3/aio_fsync.3:23
1361 #, no-wrap
1362 msgid "AIO_FSYNC"
1363 msgstr "AIO_FSYNC"
1364
1365 #. type: Plain text
1366 #: build/C/man3/aio_fsync.3:26
1367 msgid "aio_fsync - asynchronous file synchronization"
1368 msgstr "aio_fsync - 非同期ファイルを同期させる"
1369
1370 #. type: Plain text
1371 #: build/C/man3/aio_fsync.3:30
1372 msgid "B<int aio_fsync(int >I<op>B<, struct aiocb *>I<aiocbp>B<);>"
1373 msgstr "B<int aio_fsync(int >I<op>B<, struct aiocb *>I<aiocbp>B<);>"
1374
1375 #. type: Plain text
1376 #: build/C/man3/aio_fsync.3:43
1377 msgid ""
1378 "The B<aio_fsync>()  function does a sync on all outstanding asynchronous I/O "
1379 "operations associated with I<aiocbp-E<gt>aio_fildes>.  (See B<aio>(7)  for a "
1380 "description of the I<aiocb> structure.)"
1381 msgstr ""
1382 "B<aio_fsync>() 関数は、 I<aiocbp-E<gt>aio_fildes> で関連付けられているまだ\n"
1383 "完了していない全ての非同期 I/O 操作を同期させる。\n"
1384 "(I<aiocb> 構造体の説明は B<aio>(7) を参照)"
1385
1386 #. type: Plain text
1387 #: build/C/man3/aio_fsync.3:57
1388 msgid ""
1389 "More precisely, if I<op> is B<O_SYNC>, then all currently queued I/O "
1390 "operations shall be completed as if by a call of B<fsync>(2), and if I<op> "
1391 "is B<O_DSYNC>, this call is the asynchronous analog of B<fdatasync>(2)."
1392 msgstr ""
1393 "より正確に言うと、 I<op> が B<O_SYNC> の場合、現在キューに入れられている全て\n"
1394 "の I/O 操作は、 B<fsync>(2) が呼ばれたかのように完了されるだろう。 また\n"
1395 "I<op> が B<O_DSYNC> の場合、この呼び出しは B<fdatasync>(2) の非同期版となる。"
1396
1397 #. type: Plain text
1398 #: build/C/man3/aio_fsync.3:59
1399 msgid "Note that this is a request only; it does not wait for I/O completion."
1400 msgstr ""
1401
1402 #. type: Plain text
1403 #: build/C/man3/aio_fsync.3:72
1404 msgid ""
1405 "Apart from I<aio_fildes>, the only field in the structure pointed to by "
1406 "I<aiocbp> that is used by this call is the I<aio_sigevent> field (a "
1407 "I<sigevent> structure, described in B<sigevent>(7)), which indicates the "
1408 "desired type of asynchronous notification at completion.  All other fields "
1409 "are ignored."
1410 msgstr ""
1411 "I<aiocbp> で指される構造体のフィールドのうち、この呼び出しで I<aio_fildes>\n"
1412 "以外に使用されるのは I<aio_sigevent> フィールド (I<sigevent> 構造体、説明は\n"
1413 "B<sigevent>(7) 参照) のみである。このフィールドは、完了時の非同期通知に使用\n"
1414 "したいタイプを示す。 その他のフィールドは無視される。"
1415
1416 #. type: Plain text
1417 #: build/C/man3/aio_fsync.3:78
1418 msgid ""
1419 "On success (the sync request was successfully queued)  this function returns "
1420 "0.  On error -1 is returned, and I<errno> is set appropriately."
1421 msgstr ""
1422 "成功した場合 (同期リクエストをキューに入れるのに成功した場合)、 この関数は 0 "
1423 "を返す。 エラーの場合、-1 が返され、 I<errno> が適切に設定される。"
1424
1425 #. type: TP
1426 #: build/C/man3/aio_fsync.3:79 build/C/man3/aio_read.3:103
1427 #: build/C/man3/aio_suspend.3:88 build/C/man3/aio_write.3:110
1428 #: build/C/man2/io_cancel.2:57 build/C/man2/io_setup.2:55
1429 #: build/C/man2/io_submit.2:55 build/C/man3/lio_listio.3:149
1430 #: build/C/man3/lio_listio.3:152
1431 #, no-wrap
1432 msgid "B<EAGAIN>"
1433 msgstr "B<EAGAIN>"
1434
1435 #. type: Plain text
1436 #: build/C/man3/aio_fsync.3:82 build/C/man3/aio_read.3:106
1437 #: build/C/man3/aio_write.3:113 build/C/man3/lio_listio.3:152
1438 msgid "Out of resources."
1439 msgstr "リソースが足りない。"
1440
1441 #. type: Plain text
1442 #: build/C/man3/aio_fsync.3:86 build/C/man3/aio_write.3:117
1443 msgid "I<aio_fildes> is not a valid file descriptor open for writing."
1444 msgstr ""
1445 "I<aio_fildes> が書き込みのためにオープンされた有効なファイルディスクリプタで"
1446 "はない。"
1447
1448 #. type: Plain text
1449 #: build/C/man3/aio_fsync.3:94
1450 msgid ""
1451 "Synchronized I/O is not supported for this file, or I<op> is not B<O_SYNC> "
1452 "or B<O_DSYNC>."
1453 msgstr ""
1454 "このファイルでは同期 I/O がサポートされていない。\n"
1455 "または I<op> が B<O_SYNC> でも B<O_DSYNC> でもない。"
1456
1457 #. type: Plain text
1458 #: build/C/man3/aio_fsync.3:98
1459 msgid "The B<aio_fsync>()  function is available since glibc 2.1."
1460 msgstr ""
1461
1462 #. type: Plain text
1463 #: build/C/man3/aio_fsync.3:109
1464 msgid ""
1465 "B<aio_cancel>(3), B<aio_error>(3), B<aio_read>(3), B<aio_return>(3), "
1466 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7), B<sigevent>"
1467 "(7)"
1468 msgstr "B<aio_cancel>(3), B<aio_error>(3), B<aio_read>(3), B<aio_return>(3), B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7), B<sigevent>(7)"
1469
1470 #. type: TH
1471 #: build/C/man3/aio_init.3:24
1472 #, no-wrap
1473 msgid "AIO_INIT"
1474 msgstr "AIO_INIT"
1475
1476 #. type: TH
1477 #: build/C/man3/aio_init.3:24
1478 #, no-wrap
1479 msgid "2010-10-06"
1480 msgstr "2010-10-06"
1481
1482 #. type: Plain text
1483 #: build/C/man3/aio_init.3:27
1484 msgid "aio_init - POSIX asynchronous I/O initialization"
1485 msgstr ""
1486
1487 #. type: Plain text
1488 #: build/C/man3/aio_init.3:31
1489 #, no-wrap
1490 msgid ""
1491 "B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
1492 "B<#include E<lt>aio.hE<gt>>\n"
1493 msgstr ""
1494 "B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
1495 "B<#include E<lt>aio.hE<gt>>\n"
1496
1497 #. type: Plain text
1498 #: build/C/man3/aio_init.3:33
1499 #, no-wrap
1500 msgid "B<void aio_init(const struct aioinit *>I<init>B<);>\n"
1501 msgstr "B<void aio_init(const struct aioinit *>I<init>B<);>\n"
1502
1503 #. type: Plain text
1504 #: build/C/man3/aio_init.3:43
1505 msgid ""
1506 "The GNU-specific B<aio_init>()  function allows the caller to provide tuning "
1507 "hints to the glibc POSIX AIO implementation.  Use of this function is "
1508 "optional, but to be effective, it must be called before employing any other "
1509 "functions in the POSIX AIO API."
1510 msgstr ""
1511
1512 #. type: Plain text
1513 #: build/C/man3/aio_init.3:47
1514 msgid ""
1515 "The tuning information is provided in the buffer pointed to by the argument "
1516 "I<init>.  This buffer is a structure of the following form:"
1517 msgstr ""
1518
1519 #. type: Plain text
1520 #: build/C/man3/aio_init.3:62
1521 #, no-wrap
1522 msgid ""
1523 "struct aioinit {\n"
1524 "    int aio_threads;    /* Maximum number of threads */\n"
1525 "    int aio_num;        /* Number of expected simultaneous\n"
1526 "                           requests */\n"
1527 "    int aio_locks;      /* Not used */\n"
1528 "    int aio_usedba;     /* Not used */\n"
1529 "    int aio_debug;      /* Not used */\n"
1530 "    int aio_numusers;   /* Not used */\n"
1531 "    int aio_idle_time;  /* Number of seconds before idle thread\n"
1532 "                           terminates (since glibc 2.2) */\n"
1533 "    int aio_reserved;\n"
1534 "};\n"
1535 msgstr ""
1536 "struct aioinit {\n"
1537 "    int aio_threads;    /* Maximum number of threads */\n"
1538 "    int aio_num;        /* Number of expected simultaneous\n"
1539 "                           requests */\n"
1540 "    int aio_locks;      /* Not used */\n"
1541 "    int aio_usedba;     /* Not used */\n"
1542 "    int aio_debug;      /* Not used */\n"
1543 "    int aio_numusers;   /* Not used */\n"
1544 "    int aio_idle_time;  /* Number of seconds before idle thread\n"
1545 "                           terminates (since glibc 2.2) */\n"
1546 "    int aio_reserved;\n"
1547 "};\n"
1548
1549 #. type: Plain text
1550 #: build/C/man3/aio_init.3:68
1551 msgid "The following fields are used in the I<aioinit> structure:"
1552 msgstr ""
1553
1554 #. type: TP
1555 #: build/C/man3/aio_init.3:68
1556 #, no-wrap
1557 msgid "I<aio_threads>"
1558 msgstr "I<aio_threads>"
1559
1560 #. type: Plain text
1561 #: build/C/man3/aio_init.3:76
1562 msgid ""
1563 "This field specifies the maximum number of worker threads that may be used "
1564 "by the implementation.  If the number of outstanding I/O operations exceeds "
1565 "this limit, then excess operations will be queued until a worker thread "
1566 "becomes free.  If this field is specified with a value less than 1, the "
1567 "value 1 is used.  The default value is 20."
1568 msgstr ""
1569
1570 #. type: TP
1571 #: build/C/man3/aio_init.3:76
1572 #, no-wrap
1573 msgid "I<aio_num>"
1574 msgstr "I<aio_num>"
1575
1576 #.  FIXME But, if aio_num > 32, the behavior looks strange. See
1577 #.  http://sourceware.org/bugzilla/show_bug.cgi?id=12083
1578 #. type: Plain text
1579 #: build/C/man3/aio_init.3:85
1580 msgid ""
1581 "This field should specify the maximum number of simultaneous I/O requests "
1582 "that the caller expects to enqueue.  If a value less than 32 is specified "
1583 "for this field, it is rounded up to 32.  The default value is 64."
1584 msgstr ""
1585
1586 #. type: TP
1587 #: build/C/man3/aio_init.3:85
1588 #, no-wrap
1589 msgid "I<aio_idle_time>"
1590 msgstr "I<aio_idle_time>"
1591
1592 #. type: Plain text
1593 #: build/C/man3/aio_init.3:91
1594 msgid ""
1595 "This field specifies the amount of time in seconds that a worker thread "
1596 "should wait for further requests before terminating, after having completed "
1597 "a previous request.  The default value is 1."
1598 msgstr ""
1599
1600 #. type: Plain text
1601 #: build/C/man3/aio_init.3:95
1602 msgid "The B<aio_init>()  function is available since glibc 2.1."
1603 msgstr ""
1604
1605 #. type: Plain text
1606 #: build/C/man3/aio_init.3:97
1607 msgid "This function is a GNU extension."
1608 msgstr ""
1609
1610 #. type: Plain text
1611 #: build/C/man3/aio_init.3:98
1612 msgid "B<aio>(7)"
1613 msgstr "B<aio>(7)"
1614
1615 #. type: TH
1616 #: build/C/man3/aio_read.3:23
1617 #, no-wrap
1618 msgid "AIO_READ"
1619 msgstr "AIO_READ"
1620
1621 #. type: Plain text
1622 #: build/C/man3/aio_read.3:26
1623 msgid "aio_read - asynchronous read"
1624 msgstr "aio_read - 非同期で読み込む"
1625
1626 #. type: Plain text
1627 #: build/C/man3/aio_read.3:30
1628 msgid "B<int aio_read(struct aiocb *>I<aiocbp>B<);>"
1629 msgstr "B<int aio_read(struct aiocb *>I<aiocbp>B<);>"
1630
1631 #. type: Plain text
1632 #: build/C/man3/aio_read.3:40
1633 msgid ""
1634 "The B<aio_read>()  function queues the I/O request described by the buffer "
1635 "pointed to by I<aiocbp>.  This function is the asynchronous analog of B<read>"
1636 "(2).  The arguments of the call"
1637 msgstr ""
1638
1639 #. type: Plain text
1640 #: build/C/man3/aio_read.3:42
1641 #, no-wrap
1642 msgid "    read(fd, buf, count)\n"
1643 msgstr ""
1644
1645 #. type: Plain text
1646 #: build/C/man3/aio_read.3:55 build/C/man3/aio_write.3:55
1647 msgid ""
1648 "correspond (in order) to the fields I<aio_fildes>, I<aio_buf>, and "
1649 "I<aio_nbytes> of the structure pointed to by I<aiocbp>.  (See B<aio>(7)  for "
1650 "a description of the I<aiocb> structure.)"
1651 msgstr ""
1652
1653 #. type: Plain text
1654 #: build/C/man3/aio_read.3:61
1655 msgid ""
1656 "The data is read starting at the absolute file offset I<aiocbp-"
1657 "E<gt>aio_offset>, regardless of the current file offset.  After the call, "
1658 "the value of the current file offset is unspecified."
1659 msgstr ""
1660 "データの読み込みは、カレントのファイルオフセットに関係なく、\n"
1661 "絶対ファイルオフセット I<aiocbp-E<gt>aio_offset> を開始点として行われる。\n"
1662 "呼び出しの後のカレントのファイルオフセットは規定されていない。"
1663
1664 #. type: Plain text
1665 #: build/C/man3/aio_read.3:74
1666 msgid ""
1667 "The \"asynchronous\" means that this call returns as soon as the request has "
1668 "been enqueued; the read may or may not have completed when the call "
1669 "returns.  One tests for completion using B<aio_error>(3).  The return status "
1670 "of a completed I/O operation can be obtained by B<aio_return>(3).  "
1671 "Asynchronous notification of I/O completion can be obtained by setting "
1672 "I<aiocbp-E<gt>aio_sigevent> appropriately; see B<sigevent>(7)  for details."
1673 msgstr ""
1674 "「非同期」とは「リクエストがキューに入れられたら、この呼び出しはすぐに返る」\n"
1675 "ということである。 呼び出しから戻った時に、読み込みは完了しているかも知れないし、\n"
1676 "完了していないかも知れない。 B<aio_error>(3) を使うことで完了したかをテストできる。\n"
1677 "完了した I/O 操作の返り値は B<aio_return>(3) で取得できる。\n"
1678 "I<aiocbp-E<gt>aio_sigevent> を適切に設定することで、\n"
1679 "I/O 完了の非同期通知は受けることもできる。詳細は B<sigevent>(7) を参照。"
1680
1681 #. type: Plain text
1682 #: build/C/man3/aio_read.3:81 build/C/man3/aio_write.3:88
1683 msgid ""
1684 "If B<_POSIX_PRIORITIZED_IO> is defined, and this file supports it, then the "
1685 "asynchronous operation is submitted at a priority equal to that of the "
1686 "calling process minus I<aiocbp-E<gt>aio_reqprio>."
1687 msgstr ""
1688 "B<_POSIX_PRIORITIZED_IO> が定義されていて、 かつファイルがこれをサポートして"
1689 "いる場合、 非同期操作は呼び出したプロセスの優先度から I<aiocbp-"
1690 "E<gt>aio_reqprio> を引いた優先度で登録 (submit) される。"
1691
1692 #. type: Plain text
1693 #: build/C/man3/aio_read.3:85 build/C/man3/aio_write.3:92
1694 msgid "The field I<aiocbp-E<gt>aio_lio_opcode> is ignored."
1695 msgstr "フィールド I<aiocbp-E<gt>aio_lio_opcode> は無視される。"
1696
1697 #. type: Plain text
1698 #: build/C/man3/aio_read.3:87
1699 msgid "No data is read from a regular file beyond its maximum offset."
1700 msgstr ""
1701 "最大オフセットを超えた通常のファイルからは、何もデータが読み込まれない。"
1702
1703 #. type: Plain text
1704 #: build/C/man3/aio_read.3:102 build/C/man3/aio_write.3:109
1705 msgid ""
1706 "On success, 0 is returned.  On error the request is not enqueued, -1 is "
1707 "returned, and I<errno> is set appropriately.  If an error is only detected "
1708 "later, it will be reported via B<aio_return>(3)  (returns status -1) and "
1709 "B<aio_error>(3)  (error status\\(emwhatever one would have gotten in "
1710 "I<errno>, such as B<EBADF>)."
1711 msgstr ""
1712 "成功した場合、0 が返される。 エラーの場合、リクエストはキューに入れられず、\n"
1713 "-1 が返されて、 I<errno> が適切に設定される。 エラーは後でのみ検知された場合は、\n"
1714 "エラーは B<aio_return>(3) と B<aio_error>(3) 経由で報告されることになる\n"
1715 "(B<aio_return>(3) は状態 -1 を返し、B<aio_error>(3) でエラー状態\\(em\n"
1716 "I<errno> で取得できる B<EBADF> のようなエラー状態が返される)。"
1717
1718 #. type: Plain text
1719 #: build/C/man3/aio_read.3:110
1720 msgid "I<aio_fildes> is not a valid file descriptor open for reading."
1721 msgstr ""
1722 "I<aio_fildes> は読み込みのためにオープンされた有効なファイルディスクリプタで"
1723 "ない。"
1724
1725 #. type: Plain text
1726 #: build/C/man3/aio_read.3:118
1727 msgid ""
1728 "One or more of I<aio_offset>, I<aio_reqprio>, or I<aio_nbytes> are invalid."
1729 msgstr ""
1730 "I<aio_offset>, I<aio_reqprio>, I<aio_nbytes> のうち 1 つ以上が無効である。"
1731
1732 #. type: TP
1733 #: build/C/man3/aio_read.3:118 build/C/man3/aio_write.3:128
1734 #: build/C/man2/io_cancel.2:66 build/C/man2/io_destroy.2:60
1735 #: build/C/man2/io_getevents.2:73 build/C/man2/io_setup.2:69
1736 #: build/C/man2/io_submit.2:71
1737 #, no-wrap
1738 msgid "B<ENOSYS>"
1739 msgstr "B<ENOSYS>"
1740
1741 #. type: Plain text
1742 #: build/C/man3/aio_read.3:121 build/C/man3/aio_write.3:131
1743 msgid "This function is not supported."
1744 msgstr "この関数がサポートされていない。"
1745
1746 #. type: TP
1747 #: build/C/man3/aio_read.3:121
1748 #, no-wrap
1749 msgid "B<EOVERFLOW>"
1750 msgstr "B<EOVERFLOW>"
1751
1752 #. type: Plain text
1753 #: build/C/man3/aio_read.3:126
1754 msgid ""
1755 "The file is a regular file, we start reading before end-of-file and want at "
1756 "least one byte, but the starting position is past the maximum offset for "
1757 "this file."
1758 msgstr ""
1759 "ファイルが通常のファイルであり、 ファイルの終端の前から読み込みを開始して、 "
1760 "少なくとも 1 バイトを読み込もうとした。 しかし開始位置がこのファイルの最大オ"
1761 "フセットを超えていた。"
1762
1763 #. type: Plain text
1764 #: build/C/man3/aio_read.3:130
1765 msgid "The B<aio_read>()  function is available since glibc 2.1."
1766 msgstr ""
1767
1768 #.  or the control block of the operation
1769 #. type: Plain text
1770 #: build/C/man3/aio_read.3:140
1771 msgid ""
1772 "It is a good idea to zero out the control block before use.  The control "
1773 "block must not be changed while the read operation is in progress.  The "
1774 "buffer area being read into must not be accessed during the operation or "
1775 "undefined results may occur.  The memory areas involved must remain valid."
1776 msgstr ""
1777 "使用する前に制御ブロックを 0 にしておくのは、よい考えである。 この制御ブロッ"
1778 "クは、読み込み操作が進行している間は変更すべきでない。 読み込まれるバッファ領"
1779 "域は 操作の最中にアクセスすべきではない。 さもないと起こる結果が不定になる。 "
1780 "これに含まれるメモリ領域は、有効なままにしなければならない。"
1781
1782 #. type: Plain text
1783 #: build/C/man3/aio_read.3:144 build/C/man3/aio_write.3:149
1784 #: build/C/man3/lio_listio.3:218
1785 msgid ""
1786 "Simultaneous I/O operations specifying the same I<aiocb> structure produce "
1787 "undefined results."
1788 msgstr ""
1789
1790 #. type: Plain text
1791 #: build/C/man3/aio_read.3:155
1792 msgid ""
1793 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_return>(3), "
1794 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1795 msgstr "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_return>(3), B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1796
1797 #. type: TH
1798 #: build/C/man3/aio_return.3:23
1799 #, no-wrap
1800 msgid "AIO_RETURN"
1801 msgstr "AIO_RETURN"
1802
1803 #. type: Plain text
1804 #: build/C/man3/aio_return.3:26
1805 msgid "aio_return - get return status of asynchronous I/O operation"
1806 msgstr "aio_return - 非同期 I/O 操作の返り値 (return status) を取得する"
1807
1808 #. type: Plain text
1809 #: build/C/man3/aio_return.3:30
1810 msgid "B<ssize_t aio_return(struct aiocb *>I<aiocbp>B<);>"
1811 msgstr "B<ssize_t aio_return(struct aiocb *>I<aiocbp>B<);>"
1812
1813 #. type: Plain text
1814 #: build/C/man3/aio_return.3:43
1815 msgid ""
1816 "The B<aio_return>()  function returns the final return status for the "
1817 "asynchronous I/O request with control block pointed to by I<aiocbp>.  (See "
1818 "B<aio>(7)  for a description of the I<aiocb> structure.)"
1819 msgstr ""
1820 "B<aio_return>() 関数は I<aiocbp> で指された制御ブロックにおける非同期 I/O\n"
1821 "リクエストの最終的な返り値を返す。\n"
1822 "(I<aiocb> 構造体の説明は B<aio>(7) を参照)"
1823
1824 #. type: Plain text
1825 #: build/C/man3/aio_return.3:48
1826 msgid ""
1827 "This function should be called only once for any given request, after "
1828 "B<aio_error>(3)  returns something other than B<EINPROGRESS>."
1829 msgstr ""
1830 "この関数は、 B<aio_error>(3)  が B<EINPROGRESS> 以外を返した後で、 与えられた"
1831 "リクエストに対して 1 回だけ呼ばれるべきである。"
1832
1833 #. type: Plain text
1834 #: build/C/man3/aio_return.3:57
1835 msgid ""
1836 "If the asynchronous I/O operation has completed, this function returns the "
1837 "value that would have been returned in case of a synchronous B<read>(2), "
1838 "B<write>(2), B<fsync>(2)  or B<fdatasync>(2), call."
1839 msgstr ""
1840 "非同期 I/O 操作が完了した場合、この関数は、同期呼び出し B<read>(2),\n"
1841 "B<write>(2), B<fsync>(2), B<fdatasync>(2) が返すのと同じ値を返す。"
1842
1843 #. type: Plain text
1844 #: build/C/man3/aio_return.3:62
1845 msgid ""
1846 "If the asynchronous I/O operation has not yet completed, the return value "
1847 "and effect of B<aio_return>()  are undefined."
1848 msgstr ""
1849 "非同期 I/O 操作が完了していない場合、\n"
1850 "B<aio_return>() の返り値とその影響は不定である。"
1851
1852 #. type: Plain text
1853 #: build/C/man3/aio_return.3:68
1854 msgid ""
1855 "I<aiocbp> does not point at a control block for an asynchronous I/O request "
1856 "of which the return status has not been retrieved yet."
1857 msgstr ""
1858 "I<aiocbp> が、返り値がまだ取得されていない非同期 I/O リクエストの 制御ブロッ"
1859 "クを指していない。"
1860
1861 #. type: Plain text
1862 #: build/C/man3/aio_return.3:72
1863 msgid "The B<aio_return>()  function is available since glibc 2.1."
1864 msgstr ""
1865
1866 #. type: Plain text
1867 #: build/C/man3/aio_return.3:85
1868 msgid ""
1869 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), "
1870 "B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1871 msgstr "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_suspend>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7)"
1872
1873 #. type: TH
1874 #: build/C/man3/aio_suspend.3:24
1875 #, no-wrap
1876 msgid "AIO_SUSPEND"
1877 msgstr "AIO_SUSPEND"
1878
1879 #. type: Plain text
1880 #: build/C/man3/aio_suspend.3:27
1881 msgid "aio_suspend - wait for asynchronous I/O operation or timeout"
1882 msgstr "aio_suspend - 非同期 I/O 操作またはタイムアウトを待つ"
1883
1884 #. type: Plain text
1885 #: build/C/man3/aio_suspend.3:31 build/C/man3/lio_listio.3:29
1886 #, no-wrap
1887 msgid "B<#include E<lt>aio.hE<gt>>\n"
1888 msgstr "B<#include E<lt>aio.hE<gt>>\n"
1889
1890 #. type: Plain text
1891 #: build/C/man3/aio_suspend.3:33
1892 #, no-wrap
1893 msgid "B<int aio_suspend(const struct aiocb * const >I<aiocb_list>B<[],>\n"
1894 msgstr "B<int aio_suspend(const struct aiocb * const >I<aiocb_list>B<[],>\n"
1895
1896 #. type: Plain text
1897 #: build/C/man3/aio_suspend.3:35
1898 #, no-wrap
1899 msgid "B<                int >I<nitems>B<, const struct timespec *>I<timeout>B<);>\n"
1900 msgstr "B<                int >I<nitems>B<, const struct timespec *>I<timeout>B<);>\n"
1901
1902 #. type: Plain text
1903 #: build/C/man3/aio_suspend.3:37 build/C/man3/lio_listio.3:34
1904 #, no-wrap
1905 msgid "Link with I<-lrt>.\n"
1906 msgstr "I<-lrt> でリンクする。\n"
1907
1908 #. type: Plain text
1909 #: build/C/man3/aio_suspend.3:42
1910 msgid ""
1911 "The B<aio_suspend>()  function suspends the calling thread until one of the "
1912 "following occurs:"
1913 msgstr ""
1914
1915 #. type: Plain text
1916 #: build/C/man3/aio_suspend.3:46
1917 msgid ""
1918 "One or more of the asynchronous I/O requests in the list I<aiocb_list> has "
1919 "completed."
1920 msgstr ""
1921
1922 #. type: Plain text
1923 #: build/C/man3/aio_suspend.3:48
1924 msgid "A signal is delivered."
1925 msgstr ""
1926
1927 #. type: Plain text
1928 #: build/C/man3/aio_suspend.3:55
1929 msgid ""
1930 "I<timeout> is not NULL and the specified time interval has passed.  (For "
1931 "details of the I<timespec> structure, see B<nanosleep>(2).)"
1932 msgstr ""
1933
1934 #. type: Plain text
1935 #: build/C/man3/aio_suspend.3:73
1936 msgid ""
1937 "The I<nitems> argument specifies the number of items in I<aiocb_list>.  Each "
1938 "item in the list pointed to by I<aiocb_list> must be either NULL (and then "
1939 "is ignored), or a pointer to a control block on which I/O was initiated "
1940 "using B<aio_read>(3), B<aio_write>(3), or B<lio_listio>(3).  (See B<aio>(7)  "
1941 "for a description of the I<aiocb> structure.)"
1942 msgstr ""
1943 "I<nitems> 引き数は I<aiocb_list> の要素数を指定する。\n"
1944 "I<aiocb_list> が指すリストの各要素は、NULL (これは無視される) か、\n"
1945 "B<aio_read>(3), B<aio_write>(3), B<lio_listio>(3) を使って I/O が開始された\n"
1946 "制御ブロックへのポインタでなければならない。\n"
1947 "(I<aiocb> 構造体の説明は B<aio>(7) を参照)"
1948
1949 #. type: Plain text
1950 #: build/C/man3/aio_suspend.3:79
1951 msgid ""
1952 "If B<CLOCK_MONOTONIC> is supported, this clock is used to measure the "
1953 "timeout interval (see B<clock_gettime>(3))."
1954 msgstr ""
1955 "B<CLOCK_MONOTONIC> がサポートされる場合、 このクロックを使ってタイムアウトの\n"
1956 "間隔が計測される (B<clock_gettime>(3) を参照)。"
1957
1958 #. type: Plain text
1959 #: build/C/man3/aio_suspend.3:87
1960 msgid ""
1961 "If this function returns after completion of one of the I/O requests "
1962 "specified in I<aiocb_list>, 0 is returned.  Otherwise, -1 is returned, and "
1963 "I<errno> is set to indicate the error."
1964 msgstr ""
1965 "I<aiocb_list> で指定された I/O リクエストの 1 つが完了した後に\n"
1966 "この関数が返った場合は、0 が返される。\n"
1967 "それ以外の場合は、 -1 が返り、 I<errno> にエラーを示す値に設定される。"
1968
1969 #. type: Plain text
1970 #: build/C/man3/aio_suspend.3:92
1971 msgid ""
1972 "The call timed out before any of the indicated operations had completed."
1973 msgstr "指示された操作のどれも完了しないうちに、呼び出しがタイムアウトした。"
1974
1975 #. type: TP
1976 #: build/C/man3/aio_suspend.3:92 build/C/man2/io_getevents.2:69
1977 #: build/C/man3/lio_listio.3:168
1978 #, no-wrap
1979 msgid "B<EINTR>"
1980 msgstr "B<EINTR>"
1981
1982 #. type: Plain text
1983 #: build/C/man3/aio_suspend.3:98
1984 msgid ""
1985 "The call was ended by signal (possibly the completion signal of one of the "
1986 "operations we were waiting for); see B<signal>(7)."
1987 msgstr ""
1988 "この呼び出しがシグナルによって終了させられた (このシグナルは、完了を待っていた\n"
1989 "操作のいずれかの完了シグナルの可能性もある)。B<signal>(7) 参照。"
1990
1991 #. type: Plain text
1992 #: build/C/man3/aio_suspend.3:102
1993 msgid "The B<aio_suspend>()  function is available since glibc 2.1."
1994 msgstr ""
1995
1996 #. type: Plain text
1997 #: build/C/man3/aio_suspend.3:108
1998 msgid ""
1999 "One can achieve polling by using a non-NULL I<timeout> that specifies a zero "
2000 "time interval."
2001 msgstr ""
2002 "時間間隔が 0 であることを指定する NULL ではない I<timeout> を使って、ポーリン"
2003 "グを行うこともできる。"
2004
2005 #. type: Plain text
2006 #: build/C/man3/aio_suspend.3:114
2007 msgid ""
2008 "If one or more of the asynchronous I/O operations specified in I<aiocb_list> "
2009 "has already completed at the time of the call to B<aio_suspend>(), then the "
2010 "call returns immediately."
2011 msgstr ""
2012
2013 #. type: Plain text
2014 #: build/C/man3/aio_suspend.3:124
2015 msgid ""
2016 "To determine which I/O operations have completed after a successful return "
2017 "from B<aio_suspend>(), use B<aio_error>(3)  to scan the list of I<aiocb> "
2018 "structures pointed to by I<aiocb_list>."
2019 msgstr ""
2020
2021 #. type: Plain text
2022 #: build/C/man3/aio_suspend.3:133
2023 msgid ""
2024 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), "
2025 "B<aio_return>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7), B<time>(7)"
2026 msgstr "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_return>(3), B<aio_write>(3), B<lio_listio>(3), B<aio>(7), B<time>(7)"
2027
2028 #. type: TH
2029 #: build/C/man3/aio_write.3:23
2030 #, no-wrap
2031 msgid "AIO_WRITE"
2032 msgstr "AIO_WRITE"
2033
2034 #. type: Plain text
2035 #: build/C/man3/aio_write.3:26
2036 msgid "aio_write - asynchronous write"
2037 msgstr "aio_write - 非同期で書き込む"
2038
2039 #. type: Plain text
2040 #: build/C/man3/aio_write.3:30
2041 msgid "B<int aio_write(struct aiocb *>I<aiocbp>B<);>"
2042 msgstr "B<int aio_write(struct aiocb *>I<aiocbp>B<);>"
2043
2044 #. type: Plain text
2045 #: build/C/man3/aio_write.3:40
2046 msgid ""
2047 "The B<aio_write>()  function queues the I/O request described by the buffer "
2048 "pointed to by I<aiocb>.  This function is the asynchronous analog of B<write>"
2049 "(2).  The arguments of the call"
2050 msgstr ""
2051
2052 #. type: Plain text
2053 #: build/C/man3/aio_write.3:42
2054 #, no-wrap
2055 msgid "    write(fd, buf, count)\n"
2056 msgstr ""
2057
2058 #. type: Plain text
2059 #: build/C/man3/aio_write.3:68
2060 msgid ""
2061 "If B<O_APPEND> is not set, the data is written starting at the absolute file "
2062 "offset I<aiocbp-E<gt>aio_offset>, regardless of the current file offset.  If "
2063 "B<O_APPEND> is set, data is written at the end of the file in the same order "
2064 "as B<aio_write>()  calls are made.  After the call, the value of the current "
2065 "file offset is unspecified."
2066 msgstr ""
2067 "B<O_APPEND> が設定されない場合、カレントのファイルオフセットに関係なく、 \n"
2068 "データは絶対ファイルオフセット I<aiocbp-E<gt>aio_offset> を開始点として書き込まれる。\n"
2069 "B<O_APPEND> が設定されている場合、データはファイルの末尾に、\n"
2070 "B<aio_write>() の呼び出しが行われたのと同じ順序で書き込まれる。\n"
2071 "この呼び出しの後のカレントのファイルオフセットは規定されていない。"
2072
2073 #. type: Plain text
2074 #: build/C/man3/aio_write.3:81
2075 msgid ""
2076 "The \"asynchronous\" means that this call returns as soon as the request has "
2077 "been enqueued; the write may or may not have completed when the call "
2078 "returns.  One tests for completion using B<aio_error>(3).  The return status "
2079 "of a completed I/O operation can be obtained B<aio_return>(3).  Asynchronous "
2080 "notification of I/O completion can be obtained by setting I<aiocbp-"
2081 "E<gt>aio_sigevent> appropriately; see B<sigevent>(7)  for details."
2082 msgstr ""
2083 "「非同期」とは「リクエストがキューに入れられたら、この呼び出しはすぐに返る」\n"
2084 "ということである。 呼び出しから戻った時に、書き込みは完了しているかも知れないし、\n"
2085 "完了していないかも知れない。 B<aio_error>(3) を使うことで完了したかをテストできる。\n"
2086 "完了した I/O 操作の返り値は B<aio_return>(3) で取得できる。\n"
2087 "I<aiocbp-E<gt>aio_sigevent> を適切に設定することで、\n"
2088 "I/O 完了の非同期通知は受けることもできる。詳細は B<sigevent>(7) を参照。"
2089
2090 #. type: Plain text
2091 #: build/C/man3/aio_write.3:94
2092 msgid "No data is written to a regular file beyond its maximum offset."
2093 msgstr "最大オフセットを超えた通常のファイルには、何もデータが書き込まれない。"
2094
2095 #. type: TP
2096 #: build/C/man3/aio_write.3:117
2097 #, no-wrap
2098 msgid "B<EFBIG>"
2099 msgstr "B<EFBIG>"
2100
2101 #. type: Plain text
2102 #: build/C/man3/aio_write.3:121
2103 msgid ""
2104 "The file is a regular file, we want to write at least one byte, but the "
2105 "starting position is at or beyond the maximum offset for this file."
2106 msgstr ""
2107 "ファイルは通常のファイルであり、少なくとも 1 バイトを書き込もうとしている。 "
2108 "しかし開始位置が、このファイルの最大オフセットと同じかそれを超えている。"
2109
2110 #. type: Plain text
2111 #: build/C/man3/aio_write.3:128
2112 msgid ""
2113 "One or more of I<aio_offset>, I<aio_reqprio>, I<aio_nbytes> are invalid."
2114 msgstr ""
2115 "I<aio_offset>, I<aio_reqprio>, I<aio_nbytes> のうち 1 つ以上が無効である。"
2116
2117 #. type: Plain text
2118 #: build/C/man3/aio_write.3:135
2119 msgid "The B<aio_write>()  function is available since glibc 2.1."
2120 msgstr ""
2121
2122 #.  or the control block of the operation
2123 #. type: Plain text
2124 #: build/C/man3/aio_write.3:145
2125 msgid ""
2126 "It is a good idea to zero out the control block before use.  The control "
2127 "block must not be changed while the write operation is in progress.  The "
2128 "buffer area being written out must not be accessed during the operation or "
2129 "undefined results may occur.  The memory areas involved must remain valid."
2130 msgstr ""
2131 "使用する前に制御ブロックを 0 にしておくのは、よい考えである。 この制御ブロッ"
2132 "クは、読み込み操作が進行している間は変更すべきでない。 読み込まれるバッファ領"
2133 "域は 操作の最中にアクセスすべきではない。 さもないと起こる結果が不定になる。 "
2134 "これに含まれるメモリ領域は、有効なままにしなければならない。"
2135
2136 #. type: Plain text
2137 #: build/C/man3/aio_write.3:157
2138 msgid ""
2139 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), "
2140 "B<aio_return>(3), B<aio_suspend>(3), B<lio_listio>(3), B<aio>(7)"
2141 msgstr "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_read>(3), B<aio_return>(3), B<aio_suspend>(3), B<lio_listio>(3), B<aio>(7)"
2142
2143 #. type: TH
2144 #: build/C/man2/io_cancel.2:23
2145 #, no-wrap
2146 msgid "IO_CANCEL"
2147 msgstr "IO_CANCEL"
2148
2149 #. type: TH
2150 #: build/C/man2/io_cancel.2:23 build/C/man2/io_destroy.2:23
2151 #: build/C/man2/io_setup.2:23 build/C/man2/io_submit.2:23
2152 #, no-wrap
2153 msgid "2008-06-18"
2154 msgstr "2008-06-18"
2155
2156 #. type: Plain text
2157 #: build/C/man2/io_cancel.2:26
2158 msgid "io_cancel - cancel an outstanding asynchronous I/O operation"
2159 msgstr "io_cancel - 未処理の非同期 I/O 操作の取り消し"
2160
2161 #.  .ad l
2162 #.  .hy 0
2163 #.  #include <linux/aio.h>
2164 #. type: Plain text
2165 #: build/C/man2/io_cancel.2:33 build/C/man2/io_destroy.2:32
2166 #: build/C/man2/io_setup.2:32 build/C/man2/io_submit.2:32
2167 #, no-wrap
2168 msgid "B<#include E<lt>libaio.hE<gt>>\n"
2169 msgstr "B<#include E<lt>libaio.hE<gt>>\n"
2170
2171 #.  .HP 16
2172 #.  .ad
2173 #.  .hy
2174 #. type: Plain text
2175 #: build/C/man2/io_cancel.2:39
2176 #, no-wrap
2177 msgid ""
2178 "B<int io_cancel(aio_context_t >I<ctx_id>B<, struct iocb *>I<iocb>B<,>\n"
2179 "B<              struct io_event *>I<result>B<);>\n"
2180 msgstr ""
2181 "B<int io_cancel(aio_context_t >I<ctx_id>B<, struct iocb *>I<iocb>B<,>\n"
2182 "B<              struct io_event *>I<result>B<);>\n"
2183
2184 #. type: Plain text
2185 #: build/C/man2/io_cancel.2:41 build/C/man2/io_destroy.2:39
2186 #: build/C/man2/io_getevents.2:42 build/C/man2/io_setup.2:39
2187 #: build/C/man2/io_submit.2:40
2188 #, no-wrap
2189 msgid "Link with I<-laio>.\n"
2190 msgstr "I<-laio> とリンクする。\n"
2191
2192 #. type: Plain text
2193 #: build/C/man2/io_cancel.2:51
2194 msgid ""
2195 "B<io_cancel>()  attempts to cancel an asynchronous I/O operation previously "
2196 "submitted with B<io_submit>(2).  I<ctx_id> is the AIO context ID of the "
2197 "operation to be canceled.  If the AIO context is found, the event will be "
2198 "canceled and then copied into the memory pointed to by I<result> without "
2199 "being placed into the completion queue."
2200 msgstr ""
2201 "B<io_cancel>()  は、過去に B<io_submit>(2)  を使って登録された非同期 I/O "
2202 "(AIO) 操作の取り消しを行おうとする。 I<ctx_id> は、取り消しを行う操作の AIO "
2203 "コンテキストの ID である。 指定した AIO コンテキストが見つかると、 対象のイベ"
2204 "ントの取り消しが行われ、その後 I<result> で指されたメモリに コピーされる (こ"
2205 "のとき、完了キューへの移動は行われない)。"
2206
2207 #. type: Plain text
2208 #: build/C/man2/io_cancel.2:56
2209 msgid ""
2210 "On success, B<io_cancel>()  returns 0.  For the failure return, see NOTES."
2211 msgstr ""
2212 "成功した場合、 B<io_cancel>()  は 0 を返す。 失敗時の返り値については、「注"
2213 "意」の節を参照すること。"
2214
2215 #. type: Plain text
2216 #: build/C/man2/io_cancel.2:60
2217 msgid "The I<iocb> specified was not canceled."
2218 msgstr "指定された I<iocb> の取り消しが行われなかった。"
2219
2220 #. type: TP
2221 #: build/C/man2/io_cancel.2:60 build/C/man2/io_destroy.2:54
2222 #: build/C/man2/io_getevents.2:61 build/C/man2/io_setup.2:58
2223 #: build/C/man2/io_submit.2:61
2224 #, no-wrap
2225 msgid "B<EFAULT>"
2226 msgstr "B<EFAULT>"
2227
2228 #. type: Plain text
2229 #: build/C/man2/io_cancel.2:63 build/C/man2/io_submit.2:64
2230 msgid "One of the data structures points to invalid data."
2231 msgstr "データ構造の中に無効なデータを指しているものがある。"
2232
2233 #. type: Plain text
2234 #: build/C/man2/io_cancel.2:66
2235 msgid "The AIO context specified by I<ctx_id> is invalid."
2236 msgstr "I<ctx_id> で指定された AIO コンテキストが無効である。"
2237
2238 #. type: Plain text
2239 #: build/C/man2/io_cancel.2:70
2240 msgid "B<io_cancel>()  is not implemented on this architecture."
2241 msgstr "B<io_cancel>()  はこのアーキテクチャでは実装されていない。"
2242
2243 #. type: Plain text
2244 #: build/C/man2/io_cancel.2:73 build/C/man2/io_destroy.2:67
2245 #: build/C/man2/io_getevents.2:80 build/C/man2/io_setup.2:76
2246 #: build/C/man2/io_submit.2:78
2247 msgid ""
2248 "The asynchronous I/O system calls first appeared in Linux 2.5, August 2002."
2249 msgstr "非同期 I/O システム・コールは 2002年8月に Linux 2.5 で初めて登場した。"
2250
2251 #. type: Plain text
2252 #: build/C/man2/io_cancel.2:78
2253 msgid ""
2254 "B<io_cancel>()  is Linux-specific and should not be used in programs that "
2255 "are intended to be portable."
2256 msgstr ""
2257 "B<io_cancel>()  は Linux 固有であり、移植を想定したプログラムで使用すべきでは"
2258 "ない。"
2259
2260 #. type: Plain text
2261 #: build/C/man2/io_cancel.2:80 build/C/man2/io_destroy.2:74
2262 #: build/C/man2/io_getevents.2:87 build/C/man2/io_setup.2:83
2263 #: build/C/man2/io_submit.2:85
2264 msgid "Glibc does not provide a wrapper function for this system call."
2265 msgstr "glibc はこのシステムコール用のラッパー関数を提供していない。"
2266
2267 #. type: Plain text
2268 #: build/C/man2/io_cancel.2:94
2269 msgid ""
2270 "The wrapper provided in I<libaio> for B<io_cancel>()  does not follow the "
2271 "usual C library conventions for indicating error: on error it returns a "
2272 "negated error number (the negative of one of the values listed in ERRORS).  "
2273 "If the system call is invoked via B<syscall>(2), then the return value "
2274 "follows the usual conventions for indicating an error: -1, with I<errno> set "
2275 "to a (positive) value that indicates the error."
2276 msgstr ""
2277 "I<libaio> で B<io_cancel>()  用に提供されているラッパー関数は、エラーの通知が"
2278 "通常の C ライブラリの 慣習にしたがっておらず、エラーの場合には負のエラー番号 "
2279 "(エラーの節に列挙されている値の一つを負にしたもの) が返り値となる。 "
2280 "B<syscall>(2)  経由でシステムコールを起動すると、返り値は通常のエラー通知の慣"
2281 "習に したがってものとなり、エラーの場合には -1 が返り、 I<errno> にエラーを示"
2282 "す (正の) 値が設定される。"
2283
2284 #. type: Plain text
2285 #: build/C/man2/io_cancel.2:99
2286 msgid ""
2287 "B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), B<io_submit>(2), B<aio>"
2288 "(7)"
2289 msgstr ""
2290 "B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), B<io_submit>(2), B<aio>"
2291 "(7)"
2292
2293 #. type: TH
2294 #: build/C/man2/io_destroy.2:23
2295 #, no-wrap
2296 msgid "IO_DESTROY"
2297 msgstr "IO_DESTROY"
2298
2299 #. type: Plain text
2300 #: build/C/man2/io_destroy.2:26
2301 msgid "io_destroy - destroy an asynchronous I/O context"
2302 msgstr "io_destroy - 非同期 I/O コンテキストの消去"
2303
2304 #.  .HP 17
2305 #.  .ad
2306 #.  .hy
2307 #. type: Plain text
2308 #: build/C/man2/io_destroy.2:37
2309 #, no-wrap
2310 msgid "B<int io_destroy(aio_context_t >I<ctx>B<);>\n"
2311 msgstr "B<int io_destroy(aio_context_t >I<ctx>B<);>\n"
2312
2313 #. type: Plain text
2314 #: build/C/man2/io_destroy.2:48
2315 msgid ""
2316 "B<io_destroy>()  removes the asynchronous I/O context from the list of I/O "
2317 "contexts and then destroys it.  B<io_destroy>()  can also cancel any "
2318 "outstanding asynchronous I/O actions on I<ctx> and block on completion."
2319 msgstr ""
2320 "B<io_destroy>()  は、I/O コンテキストのリストから指定された非同期 I/O コンテ"
2321 "キストを削除した後、そのコンテキストを消去する。 B<io_destroy>()  は、I<ctx> "
2322 "上に未処理の非同期 I/O 命令及び 完了キューのブロックの取り消しも行うことがで"
2323 "きる。"
2324
2325 #. type: Plain text
2326 #: build/C/man2/io_destroy.2:53
2327 msgid ""
2328 "On success, B<io_destroy>()  returns 0.  For the failure return, see NOTES."
2329 msgstr ""
2330 "成功した場合、 B<io_destroy>()  は 0 を返す。 失敗時の返り値については、「注"
2331 "意」の節を参照すること。"
2332
2333 #. type: Plain text
2334 #: build/C/man2/io_destroy.2:57
2335 msgid "The context pointed to is invalid."
2336 msgstr "データ構造の中に無効なデータを指しているものがある。"
2337
2338 #. type: Plain text
2339 #: build/C/man2/io_destroy.2:60
2340 msgid "The AIO context specified by I<ctx> is invalid."
2341 msgstr "I<ctx> で指定された AIO コンテキストが無効である。"
2342
2343 #. type: Plain text
2344 #: build/C/man2/io_destroy.2:64
2345 msgid "B<io_destroy>()  is not implemented on this architecture."
2346 msgstr "B<io_destroy>()  はこのアーキテクチャでは実装されていない。"
2347
2348 #. type: Plain text
2349 #: build/C/man2/io_destroy.2:72
2350 msgid ""
2351 "B<io_destroy>()  is Linux-specific and should not be used in programs that "
2352 "are intended to be portable."
2353 msgstr ""
2354 "B<io_destroy>()  は Linux 固有であり、移植を想定したプログラムで使用すべきで"
2355 "はない。"
2356
2357 #. type: Plain text
2358 #: build/C/man2/io_destroy.2:88
2359 msgid ""
2360 "The wrapper provided in I<libaio> for B<io_destroy>()  does not follow the "
2361 "usual C library conventions for indicating error: on error it returns a "
2362 "negated error number (the negative of one of the values listed in ERRORS).  "
2363 "If the system call is invoked via B<syscall>(2), then the return value "
2364 "follows the usual conventions for indicating an error: -1, with I<errno> set "
2365 "to a (positive) value that indicates the error."
2366 msgstr ""
2367 "I<libaio> で B<io_destroy>()  用に提供されているラッパー関数は、エラーの通知"
2368 "が通常の C ライブラリの 慣習にしたがっておらず、エラーの場合には負のエラー番"
2369 "号 (エラーの節に列挙されている値の一つを負にしたもの) が返り値となる。 "
2370 "B<syscall>(2)  経由でシステムコールを起動すると、返り値は通常のエラー通知の慣"
2371 "習に したがってものとなり、エラーの場合には -1 が返り、 I<errno> にエラーを示"
2372 "す (正の) 値が設定される。"
2373
2374 #. type: Plain text
2375 #: build/C/man2/io_destroy.2:93
2376 msgid ""
2377 "B<io_cancel>(2), B<io_getevents>(2), B<io_setup>(2), B<io_submit>(2), B<aio>"
2378 "(7)"
2379 msgstr ""
2380 "B<io_cancel>(2), B<io_getevents>(2), B<io_setup>(2), B<io_submit>(2), B<aio>"
2381 "(7)"
2382
2383 #. type: TH
2384 #: build/C/man2/io_getevents.2:23
2385 #, no-wrap
2386 msgid "IO_GETEVENTS"
2387 msgstr "IO_GETEVENTS"
2388
2389 #. type: TH
2390 #: build/C/man2/io_getevents.2:23
2391 #, no-wrap
2392 msgid "2008-07-04"
2393 msgstr "2008-07-04"
2394
2395 #. type: Plain text
2396 #: build/C/man2/io_getevents.2:26
2397 msgid "io_getevents - read asynchronous I/O events from the completion queue"
2398 msgstr "io_getevents - 完了キューから非同期 I/O イベントを読み出す"
2399
2400 #.  .ad l
2401 #.  .hy 0
2402 #.  #include <linux/aio.h>
2403 #. type: Plain text
2404 #: build/C/man2/io_getevents.2:33
2405 #, no-wrap
2406 msgid ""
2407 "B<#include E<lt>linux/time.hE<gt>>\n"
2408 "B<#include E<lt>libaio.hE<gt>>\n"
2409 msgstr ""
2410 "B<#include E<lt>linux/time.hE<gt>>\n"
2411 "B<#include E<lt>libaio.hE<gt>>\n"
2412
2413 #.  .HP 19
2414 #.  .ad
2415 #.  .hy
2416 #. type: Plain text
2417 #: build/C/man2/io_getevents.2:40
2418 #, no-wrap
2419 msgid ""
2420 "B<int io_getevents(aio_context_t >I<ctx_id>B<, long >I<min_nr>B<, long >I<nr>B<,>\n"
2421 "B<                 struct io_event *>I<events>B<, struct timespec *>I<timeout>B<);>\n"
2422 msgstr ""
2423 "B<int io_getevents(aio_context_t >I<ctx_id>B<, long >I<min_nr>B<, long >I<nr>B<,>\n"
2424 "B<                 struct io_event *>I<events>B<, struct timespec *>I<timeout>B<);>\n"
2425
2426 #. type: Plain text
2427 #: build/C/man2/io_getevents.2:54
2428 msgid ""
2429 "B<io_getevents>()  attempts to read at least I<min_nr> events and up to "
2430 "I<nr> events from the completion queue of the AIO context specified by "
2431 "I<ctx_id>.  I<timeout> specifies the amount of time to wait for events, "
2432 "where a NULL timeout waits until at least I<min_nr> events have been seen.  "
2433 "Note that I<timeout> is relative and will be updated if not NULL and the "
2434 "operation blocks."
2435 msgstr ""
2436 "B<io_getevents>()  は、少なくとも I<min_nr> の、最大 I<nr> 個の イベントを、 "
2437 "I<ctx_id> で指定された AIO (非同期 I/O) コンテキストの 完了キューから読み出そ"
2438 "うとする。 I<timeout> はイベント読み出しの待ち時間の合計を指定する。 タイムア"
2439 "ウトに NULL を指定した場合、少なくとも I<min_nr> 個のイベントが 読み出される"
2440 "まで待つことを意味する。 注意点を以下にあげる: I<timeout> は相対的な指定であ"
2441 "る。 NULL でない場合更新されることもありえる。 呼び出し元の動作は停止する。"
2442
2443 #. type: Plain text
2444 #: build/C/man2/io_getevents.2:60
2445 msgid ""
2446 "On success, B<io_getevents>()  returns the number of events read: 0 if no "
2447 "events are available, or less than I<min_nr> if the I<timeout> has elapsed.  "
2448 "For the failure return, see NOTES."
2449 msgstr ""
2450 "成功すると、 B<io_getevents>()  は読み出したイベント数を返す。 イベントが一つ"
2451 "も読み出されなかった場合は 0 が返され、 I<timeout> 時間が経過した場合は "
2452 "I<min_nr> 未満の値が返される。 失敗時の返り値については、「注意」の節を参照す"
2453 "ること。"
2454
2455 #. type: Plain text
2456 #: build/C/man2/io_getevents.2:64
2457 msgid "Either I<events> or I<timeout> is an invalid pointer."
2458 msgstr "I<events> または I<timeout> が無効なポインタである。"
2459
2460 #. type: Plain text
2461 #: build/C/man2/io_getevents.2:69
2462 msgid ""
2463 "I<ctx_id> is invalid.  I<min_nr> is out of range or I<nr> is out of range."
2464 msgstr ""
2465 "I<ctx_id> が無効である。もしくは、I<min_nr> または I<nr> が 範囲外の値であ"
2466 "る。"
2467
2468 #. type: Plain text
2469 #: build/C/man2/io_getevents.2:73
2470 msgid "Interrupted by a signal handler; see B<signal>(7)."
2471 msgstr "シグナルハンドラにより割り込まれた。 B<signal>(7)  参照。"
2472
2473 #. type: Plain text
2474 #: build/C/man2/io_getevents.2:77
2475 msgid "B<io_getevents>()  is not implemented on this architecture."
2476 msgstr "B<io_getevents>()  がこのアーキテクチャでは実装されていない。"
2477
2478 #. type: Plain text
2479 #: build/C/man2/io_getevents.2:85
2480 msgid ""
2481 "B<io_getevents>()  is Linux-specific and should not be used in programs that "
2482 "are intended to be portable."
2483 msgstr ""
2484 "B<io_getevents>()  は Linux 固有であり、移植を想定したプログラムで 使用すべき"
2485 "ではない。"
2486
2487 #. type: Plain text
2488 #: build/C/man2/io_getevents.2:101
2489 msgid ""
2490 "The wrapper provided in I<libaio> for B<io_getevents>()  does not follow the "
2491 "usual C library conventions for indicating error: on error it returns a "
2492 "negated error number (the negative of one of the values listed in ERRORS).  "
2493 "If the system call is invoked via B<syscall>(2), then the return value "
2494 "follows the usual conventions for indicating an error: -1, with I<errno> set "
2495 "to a (positive) value that indicates the error."
2496 msgstr ""
2497 "I<libaio> で B<io_getevents>()  用に提供されているラッパー関数は、エラーの通"
2498 "知が通常の C ライブラリの 慣習にしたがっておらず、エラーの場合には負のエラー"
2499 "番号 (エラーの節に列挙されている値の一つを負にしたもの) が返り値となる。 "
2500 "B<syscall>(2)  経由でシステムコールを起動すると、返り値は通常のエラー通知の慣"
2501 "習に したがってものとなり、エラーの場合には -1 が返り、 I<errno> にエラーを示"
2502 "す (正の) 値が設定される。"
2503
2504 #. type: Plain text
2505 #: build/C/man2/io_getevents.2:108
2506 msgid ""
2507 "B<io_cancel>(2), B<io_destroy>(2), B<io_setup>(2), B<io_submit>(2), B<aio>"
2508 "(7), B<time>(7)"
2509 msgstr ""
2510 "B<io_cancel>(2), B<io_destroy>(2), B<io_setup>(2), B<io_submit>(2), B<aio>"
2511 "(7), B<time>(7)"
2512
2513 #. type: TH
2514 #: build/C/man2/io_setup.2:23
2515 #, no-wrap
2516 msgid "IO_SETUP"
2517 msgstr "IO_SETUP"
2518
2519 #. type: Plain text
2520 #: build/C/man2/io_setup.2:26
2521 msgid "io_setup - create an asynchronous I/O context"
2522 msgstr "io_setup - 非同期 I/O コンテキストを作成する"
2523
2524 #.  .HP 15
2525 #.  .ad
2526 #.  .hy
2527 #. type: Plain text
2528 #: build/C/man2/io_setup.2:37
2529 #, no-wrap
2530 msgid "B<int io_setup(unsigned >I<nr_events>B<, aio_context_t *>I<ctxp>B<);>\n"
2531 msgstr "B<int io_setup(unsigned >I<nr_events>B<, aio_context_t *>I<ctxp>B<);>\n"
2532
2533 #. type: Plain text
2534 #: build/C/man2/io_setup.2:49
2535 msgid ""
2536 "B<io_setup>()  creates an asynchronous I/O context capable of receiving at "
2537 "least I<nr_events>.  I<ctxp> must not point to an AIO context that already "
2538 "exists, and must be initialized to 0 prior to the call.  On successful "
2539 "creation of the AIO context, I<*ctxp> is filled in with the resulting handle."
2540 msgstr ""
2541 "B<io_setup>()  は、少なくとも I<nr_events> 個のイベントを受信可能な 非同期 I/"
2542 "O (AIO) コンテキストの作成を行う。 I<ctxp> は、すでに存在する AIO コンテキス"
2543 "トを指していてはならず、 B<io_setup>()  の呼び出しの前に 0 に初期化されていな"
2544 "ければならない。 AIO コンテキストの作成に成功すると、I<*ctxp> に作成された "
2545 "AIO コンテキストへのポインタがセットされる。"
2546
2547 #. type: Plain text
2548 #: build/C/man2/io_setup.2:54
2549 msgid ""
2550 "On success, B<io_setup>()  returns 0.  For the failure return, see NOTES."
2551 msgstr ""
2552 "成功した場合、 B<io_setup>()  は 0 を返す。 失敗時の返り値については、「注"
2553 "意」の節を参照すること。"
2554
2555 #. type: Plain text
2556 #: build/C/man2/io_setup.2:58
2557 msgid ""
2558 "The specified I<nr_events> exceeds the user's limit of available events."
2559 msgstr ""
2560 "指定された I<nr_events> がユーザが使用できるイベント数の上限を越えている。"
2561
2562 #. type: Plain text
2563 #: build/C/man2/io_setup.2:61
2564 msgid "An invalid pointer is passed for I<ctxp>."
2565 msgstr "I<ctxp> に無効なポインタが指定されている。"
2566
2567 #. type: Plain text
2568 #: build/C/man2/io_setup.2:66
2569 msgid ""
2570 "I<ctxp> is not initialized, or the specified I<nr_events> exceeds internal "
2571 "limits.  I<nr_events> should be greater than 0."
2572 msgstr ""
2573 "I<ctxp> が初期化されていないか、指定された I<nr_events> が 内部の制限値を越え"
2574 "ている。また、 I<nr_events> は 0 より大きい値に 設定すべきである。"
2575
2576 #. type: TP
2577 #: build/C/man2/io_setup.2:66
2578 #, no-wrap
2579 msgid "B<ENOMEM>"
2580 msgstr "B<ENOMEM>"
2581
2582 #. type: Plain text
2583 #: build/C/man2/io_setup.2:69
2584 msgid "Insufficient kernel resources are available."
2585 msgstr "必要なカーネル・リソースを得られない。"
2586
2587 #. type: Plain text
2588 #: build/C/man2/io_setup.2:73
2589 msgid "B<io_setup>()  is not implemented on this architecture."
2590 msgstr "B<io_setup>()  がこのアーキテクチャでは実装されていない。"
2591
2592 #. type: Plain text
2593 #: build/C/man2/io_setup.2:81
2594 msgid ""
2595 "B<io_setup>()  is Linux-specific and should not be used in programs that are "
2596 "intended to be portable."
2597 msgstr ""
2598 "B<io_setup>()  は Linux 固有であり、移植を想定したプログラムで 使用すべきでは"
2599 "ない。"
2600
2601 #. type: Plain text
2602 #: build/C/man2/io_setup.2:97
2603 msgid ""
2604 "The wrapper provided in I<libaio> for B<io_setup>()  does not follow the "
2605 "usual C library conventions for indicating error: on error it returns a "
2606 "negated error number (the negative of one of the values listed in ERRORS).  "
2607 "If the system call is invoked via B<syscall>(2), then the return value "
2608 "follows the usual conventions for indicating an error: -1, with I<errno> set "
2609 "to a (positive) value that indicates the error."
2610 msgstr ""
2611 "I<libaio> で B<io_setup>()  用に提供されているラッパー関数は、エラーの通知が"
2612 "通常の C ライブラリの 慣習にしたがっておらず、エラーの場合には負のエラー番号 "
2613 "(エラーの節に列挙されている値の一つを負にしたもの) が返り値となる。 "
2614 "B<syscall>(2)  経由でシステムコールを起動すると、返り値は通常のエラー通知の慣"
2615 "習に したがってものとなり、エラーの場合には -1 が返り、 I<errno> にエラーを示"
2616 "す (正の) 値が設定される。"
2617
2618 #. type: Plain text
2619 #: build/C/man2/io_setup.2:102
2620 msgid ""
2621 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_submit>(2), "
2622 "B<aio>(7)"
2623 msgstr ""
2624 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_submit>(2), "
2625 "B<aio>(7)"
2626
2627 #. type: TH
2628 #: build/C/man2/io_submit.2:23
2629 #, no-wrap
2630 msgid "IO_SUBMIT"
2631 msgstr "IO_SUBMIT"
2632
2633 #. type: Plain text
2634 #: build/C/man2/io_submit.2:26
2635 msgid "io_submit - submit asynchronous I/O blocks for processing"
2636 msgstr "io_submit - 非同期 I/O ブロックを処理待ちキューに登録する"
2637
2638 #.  .HP 16
2639 #.  .ad
2640 #.  .hy
2641 #. type: Plain text
2642 #: build/C/man2/io_submit.2:38
2643 #, no-wrap
2644 msgid "B<int io_submit(aio_context_t >I<ctx_id>B<, long >I<nr>B<, struct iocb **>I<iocbpp>B<);>\n"
2645 msgstr "B<int io_submit(aio_context_t >I<ctx_id>B<, long >I<nr>B<, struct iocb **>I<iocbpp>B<);>\n"
2646
2647 #. type: Plain text
2648 #: build/C/man2/io_submit.2:48
2649 msgid ""
2650 "B<io_submit>()  queues I<nr> I/O request blocks for processing in the AIO "
2651 "context I<ctx_id>.  I<iocbpp> should be an array of I<nr> AIO control "
2652 "blocks, which will be submitted to context I<ctx_id>."
2653 msgstr ""
2654 "B<io_submit>()  は、AIO コンテキスト I<ctx_id> に I<nr> 個の I/O リクエストを"
2655 "処理待ちとしてキューに追加する。 I<iocbpp> は、AIO コンテキスト I<ctx_id> に"
2656 "登録される I<nr> 個の AIO 制御ブロックの配列になっていなければならない。"
2657
2658 #. type: Plain text
2659 #: build/C/man2/io_submit.2:54
2660 msgid ""
2661 "On success, B<io_submit>()  returns the number of I<iocb>s submitted (which "
2662 "may be 0 if I<nr> is zero).  For the failure return, see NOTES."
2663 msgstr ""
2664 "成功すると、 B<io_submit>()  は登録した I<iocb> の個数を返す (I<nr> が 0 の場"
2665 "合は 0 を返す)。 失敗時の返り値については、「注意」の節を参照すること。"
2666
2667 #. type: Plain text
2668 #: build/C/man2/io_submit.2:58
2669 msgid "Insufficient resources are available to queue any I<iocb>s."
2670 msgstr "何個かの I<iocb> をキューに入れるのに必要なリソースが得られない。"
2671
2672 #. type: Plain text
2673 #: build/C/man2/io_submit.2:61
2674 msgid "The file descriptor specified in the first I<iocb> is invalid."
2675 msgstr "先頭の I<iocb> に指定されたファイル・ディスクリプタが無効である。"
2676
2677 #. type: Plain text
2678 #: build/C/man2/io_submit.2:71
2679 msgid ""
2680 "The I<aio_context> specified by I<ctx_id> is invalid.  I<nr> is less than "
2681 "0.  The I<iocb> at *iocbpp[0] is not properly initialized, or the operation "
2682 "specified is invalid for the file descriptor in the I<iocb>."
2683 msgstr ""
2684 "I<ctx_id> で指定された I<aio_context> が無効である。 I<nr> が 0 未満である。 "
2685 "*iocbpp[0] の I<iocb> が適切に初期化されていないか、 指定された操作がその "
2686 "I<iocb> 中のファイル・ディスクリプタに対して 無効である。"
2687
2688 #. type: Plain text
2689 #: build/C/man2/io_submit.2:75
2690 msgid "B<io_submit>()  is not implemented on this architecture."
2691 msgstr "B<io_submit>()  はこのアーキテクチャでは実装されていない。"
2692
2693 #. type: Plain text
2694 #: build/C/man2/io_submit.2:83
2695 msgid ""
2696 "B<io_submit>()  is Linux-specific and should not be used in programs that "
2697 "are intended to be portable."
2698 msgstr ""
2699 "B<io_submit>()  は Linux 固有であり、移植を想定したプログラムで 使用すべきで"
2700 "はない。"
2701
2702 #. type: Plain text
2703 #: build/C/man2/io_submit.2:99
2704 msgid ""
2705 "The wrapper provided in I<libaio> for B<io_submit>()  does not follow the "
2706 "usual C library conventions for indicating error: on error it returns a "
2707 "negated error number (the negative of one of the values listed in ERRORS).  "
2708 "If the system call is invoked via B<syscall>(2), then the return value "
2709 "follows the usual conventions for indicating an error: -1, with I<errno> set "
2710 "to a (positive) value that indicates the error."
2711 msgstr ""
2712 "I<libaio> で B<io_submit>()  用に提供されているラッパー関数は、エラーの通知が"
2713 "通常の C ライブラリの 慣習にしたがっておらず、エラーの場合には負のエラー番号 "
2714 "(エラーの節に列挙されている値の一つを負にしたもの) が返り値となる。 "
2715 "B<syscall>(2)  経由でシステムコールを起動すると、返り値は通常のエラー通知の慣"
2716 "習に したがってものとなり、エラーの場合には -1 が返り、 I<errno> にエラーを示"
2717 "す (正の) 値が設定される。"
2718
2719 #. type: Plain text
2720 #: build/C/man2/io_submit.2:104
2721 msgid ""
2722 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), B<aio>"
2723 "(7)"
2724 msgstr ""
2725 "B<io_cancel>(2), B<io_destroy>(2), B<io_getevents>(2), B<io_setup>(2), B<aio>"
2726 "(7)"
2727
2728 #. type: TH
2729 #: build/C/man3/lio_listio.3:23
2730 #, no-wrap
2731 msgid "LIO_LISTIO"
2732 msgstr "LIO_LISTIO"
2733
2734 #. type: TH
2735 #: build/C/man3/lio_listio.3:23
2736 #, no-wrap
2737 msgid "2010-10-20"
2738 msgstr "2010-10-20"
2739
2740 #. type: Plain text
2741 #: build/C/man3/lio_listio.3:26
2742 msgid "lio_listio - initiate a list of I/O requests"
2743 msgstr ""
2744
2745 #. type: Plain text
2746 #: build/C/man3/lio_listio.3:32
2747 #, no-wrap
2748 msgid ""
2749 "B<int lio_listio(int >I<mode>B<, struct aiocb *const >I<aiocb_list>B<[],>\n"
2750 "B<               int >I<nitems>B<, struct sigevent *>I<sevp>B<);>\n"
2751 msgstr ""
2752 "B<int lio_listio(int >I<mode>B<, struct aiocb *const >I<aiocb_list>B<[],>\n"
2753 "B<               int >I<nitems>B<, struct sigevent *>I<sevp>B<);>\n"
2754
2755 #. type: Plain text
2756 #: build/C/man3/lio_listio.3:40
2757 msgid ""
2758 "The B<lio_listio>()  function initiates the list of I/O operations described "
2759 "by the array I<aiocb_list>."
2760 msgstr ""
2761
2762 #. type: Plain text
2763 #: build/C/man3/lio_listio.3:44
2764 msgid "The I<mode> operation has one of the following values:"
2765 msgstr ""
2766
2767 #. type: TP
2768 #: build/C/man3/lio_listio.3:44
2769 #, no-wrap
2770 msgid "B<LIO_WAIT>"
2771 msgstr "B<LIO_WAIT>"
2772
2773 #. type: Plain text
2774 #: build/C/man3/lio_listio.3:50
2775 msgid ""
2776 "The call blocks until all operations are complete.  The I<sevp> argument is "
2777 "ignored."
2778 msgstr ""
2779
2780 #. type: TP
2781 #: build/C/man3/lio_listio.3:50
2782 #, no-wrap
2783 msgid "B<LIO_NOWAIT>"
2784 msgstr "B<LIO_NOWAIT>"
2785
2786 #. type: Plain text
2787 #: build/C/man3/lio_listio.3:62
2788 msgid ""
2789 "The I/O operations are queued for processing and the call returns "
2790 "immediately.  When the I/O operations complete, asynchronous notification "
2791 "occurs, as specified by the I<sevp> argument; see B<sigevent>(7)  for "
2792 "details.  If I<sevp> is NULL, no asynchronous notification occurs."
2793 msgstr ""
2794
2795 #. type: Plain text
2796 #: build/C/man3/lio_listio.3:76
2797 msgid ""
2798 "The I<aiocb_list> argument is an array of pointers to I<aiocb> structures "
2799 "that describe I/O operations.  These operations are executed in an "
2800 "unspecified order.  The I<nitems> argument specifies the size of the array "
2801 "I<aiocb_list>.  NULL pointers in I<aiocb_list> are ignored."
2802 msgstr ""
2803
2804 #. type: Plain text
2805 #: build/C/man3/lio_listio.3:82
2806 msgid ""
2807 "In each control block in I<aiocb_list>, the I<aio_lio_opcode> field "
2808 "specifies the I/O operation to be initiated, as follows:"
2809 msgstr ""
2810
2811 #. type: TP
2812 #: build/C/man3/lio_listio.3:82
2813 #, no-wrap
2814 msgid "B<LIO_READ>"
2815 msgstr "B<LIO_READ>"
2816
2817 #. type: Plain text
2818 #: build/C/man3/lio_listio.3:88
2819 msgid ""
2820 "Initiate a read operation.  The operation is queued as for a call to "
2821 "B<aio_read>(3)  specifying this control block."
2822 msgstr ""
2823
2824 #. type: TP
2825 #: build/C/man3/lio_listio.3:88
2826 #, no-wrap
2827 msgid "B<LIO_WRITE>"
2828 msgstr "B<LIO_WRITE>"
2829
2830 #. type: Plain text
2831 #: build/C/man3/lio_listio.3:94
2832 msgid ""
2833 "Initiate a write operation.  The operation is queued as for a call to "
2834 "B<aio_write>(3)  specifying this control block."
2835 msgstr ""
2836
2837 #. type: TP
2838 #: build/C/man3/lio_listio.3:94
2839 #, no-wrap
2840 msgid "B<LIO_NOP>"
2841 msgstr "B<LIO_NOP>"
2842
2843 #. type: Plain text
2844 #: build/C/man3/lio_listio.3:97
2845 msgid "Ignore this control block."
2846 msgstr ""
2847
2848 #. type: Plain text
2849 #: build/C/man3/lio_listio.3:107
2850 msgid ""
2851 "The remaining fields in each control block have the same meanings as for "
2852 "B<aio_read>(3)  and B<aio_write>(3).  The I<aio_sigevent> fields of each "
2853 "control block can be used to specify notifications for the individual I/O "
2854 "operations (see B<sigevent>(7))."
2855 msgstr ""
2856
2857 #. type: Plain text
2858 #: build/C/man3/lio_listio.3:117
2859 msgid ""
2860 "If I<mode> is B<LIO_NOWAIT>, B<lio_listio>()  returns 0 if all I/O "
2861 "operations are successfully queued.  Otherwise, -1 is returned, and I<errno> "
2862 "is set to indicate the error."
2863 msgstr ""
2864
2865 #. type: Plain text
2866 #: build/C/man3/lio_listio.3:127
2867 msgid ""
2868 "If I<mode> is B<LIO_WAIT>, B<lio_listio>()  returns 0 when all of the I/O "
2869 "operations have completed successfully.  Otherwise, -1 is returned, and "
2870 "I<errno> is set to indicate the error."
2871 msgstr ""
2872
2873 #. type: Plain text
2874 #: build/C/man3/lio_listio.3:145
2875 msgid ""
2876 "The return status from B<lio_listio>()  provides information only about the "
2877 "call itself, not about the individual I/O operations.  One or more of the I/"
2878 "O operations may fail, but this does not prevent other operations "
2879 "completing.  The status of individual I/O operations in I<aiocb_list> can be "
2880 "determined using B<aio_error>(3).  When an operation has completed, its "
2881 "return status can be obtained using B<aio_return>(3).  Individual I/O "
2882 "operations can fail for the reasons described in B<aio_read>(3)  and "
2883 "B<aio_write>(3)."
2884 msgstr ""
2885
2886 #. type: Plain text
2887 #: build/C/man3/lio_listio.3:149
2888 msgid "The B<lio_listio>()  function may fail for the following reasons:"
2889 msgstr ""
2890
2891 #.  Doesn't happen in glibc(?)
2892 #. type: Plain text
2893 #: build/C/man3/lio_listio.3:160
2894 msgid ""
2895 "The number of I/O operations specified by I<nitems> would cause the limit "
2896 "B<AIO_MAX> to be exceeded."
2897 msgstr ""
2898
2899 #.  Doesn't happen in glibc(?)
2900 #. type: Plain text
2901 #: build/C/man3/lio_listio.3:168
2902 msgid "I<mode> is invalid, or I<nitems> exceeds the limit B<AIO_LISTIO_MAX>."
2903 msgstr ""
2904
2905 #. type: Plain text
2906 #: build/C/man3/lio_listio.3:177
2907 msgid ""
2908 "I<mode> was B<LIO_WAIT> and a signal was caught before all I/O operations "
2909 "completed.  (This may even be one of the signals used for asynchronous I/O "
2910 "completion notification.)"
2911 msgstr ""
2912
2913 #. type: TP
2914 #: build/C/man3/lio_listio.3:177
2915 #, no-wrap
2916 msgid "B<EIO>"
2917 msgstr "B<EIO>"
2918
2919 #.  e.g., ioa_reqprio or aio_lio_opcode was invalid
2920 #. type: Plain text
2921 #: build/C/man3/lio_listio.3:185
2922 msgid ""
2923 "One of more of the operations specified by I<aiocb_list> failed.  The "
2924 "application can check the status of each operation using B<aio_return>(3)."
2925 msgstr ""
2926
2927 #. type: Plain text
2928 #: build/C/man3/lio_listio.3:200
2929 msgid ""
2930 "If B<lio_listio>()  fails with the error B<EAGAIN>, B<EINTR>, or B<EIO>, "
2931 "then some of the operations in I<aiocb_list> may have been initiated.  If "
2932 "B<lio_listio>()  fails for any other reason, then none of the I/O operations "
2933 "has been initiated."
2934 msgstr ""
2935
2936 #. type: Plain text
2937 #: build/C/man3/lio_listio.3:204
2938 msgid "The B<lio_listio>()  function is available since glibc 2.1."
2939 msgstr ""
2940
2941 #.  or the control block of the operation
2942 #. type: Plain text
2943 #: build/C/man3/lio_listio.3:214
2944 msgid ""
2945 "It is a good idea to zero out the control blocks before use.  The control "
2946 "blocks must not be changed while the I/O operations are in progress.  The "
2947 "buffer areas being read into or written from must not be accessed during the "
2948 "operations or undefined results may occur.  The memory areas involved must "
2949 "remain valid."
2950 msgstr ""
2951
2952 #. type: Plain text
2953 #: build/C/man3/lio_listio.3:225
2954 msgid ""
2955 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_return>(3), "
2956 "B<aio_suspend>(3), B<aio_write>(3), B<aio>(7)"
2957 msgstr ""
2958 "B<aio_cancel>(3), B<aio_error>(3), B<aio_fsync>(3), B<aio_return>(3), "
2959 "B<aio_suspend>(3), B<aio_write>(3), B<aio>(7)"
2960
2961 #~ msgid "COLOPHON"
2962 #~ msgstr "この文書について"
2963
2964 #~ msgid ""
2965 #~ "This page is part of release 3.38 of the Linux I<man-pages> project.  A "
2966 #~ "description of the project, and information about reporting bugs, can be "
2967 #~ "found at http://www.kernel.org/doc/man-pages/."
2968 #~ msgstr ""
2969 #~ "この man ページは Linux I<man-pages> プロジェクトのリリース 3.38 の一部で"
2970 #~ "ある。\n"
2971 #~ "プロジェクトの説明とバグ報告に関する情報は\n"
2972 #~ "http://www.kernel.org/doc/man-pages/ に書かれている。"
2973
2974 #~ msgid ""
2975 #~ "This function returns B<EINPROGRESS> if the request has not been "
2976 #~ "completed yet.  It returns B<ECANCELED> if the request was canceled.  It "
2977 #~ "returns 0 if the request completed successfully.  Otherwise an error "
2978 #~ "value is returned, the same value that would have been stored in the "
2979 #~ "I<errno> variable in case of a synchronous I<read>, I<write>, I<fsync>, "
2980 #~ "or I<fdatasync> request.  On error, the error value is returned."
2981 #~ msgstr ""
2982 #~ "リクエストがまだ完了していない場合、この関数は B<EINPROGRESS> を返す。リク"
2983 #~ "エストがキャンセルされた場合、この関数は B<ECANCELED> を返す。リクエストが"
2984 #~ "成功して完了した場合、この関数は 0 を返す。 それ以外の場合はエラー値が返さ"
2985 #~ "れる。 このエラー値は、同期 I<read>, I<write>, I<fsync>, I<fdatasync> リク"
2986 #~ "エストの場合に I<errno> に格納されるのと同じ値である。 エラーの場合はエ"
2987 #~ "ラー値が返される。"
2988
2989 #~ msgid ""
2990 #~ "The B<aio_read>()  function requests an asynchronous \"n = read(fd, buf, "
2991 #~ "count)\" with fd, buf, count given by I<aiocbp-E<gt>aio_fildes>, I<aiocbp-"
2992 #~ "E<gt>aio_buf>, I<aiocbp-E<gt>aio_nbytes>, respectively.  The return "
2993 #~ "status n can be retrieved upon completion using B<aio_return>(3)."
2994 #~ msgstr ""
2995 #~ "B<aio_read>()  関数は非同期の \"n = read(fd, buf, count)\" をリクエストす"
2996 #~ "る。 ここで fd, buf, count は、それぞれ I<aiocbp-E<gt>aio_fildes>, "
2997 #~ "I<aiocbp-E<gt>aio_buf>, I<aiocbp-E<gt>aio_nbytes> で与えられる。 返り値 "
2998 #~ "(return status) n は、完了時に B<aio_return>(3)  を使って取得できる。"
2999
3000 #~ msgid ""
3001 #~ "The B<aio_suspend>()  function suspends the calling process until at "
3002 #~ "least one of the asynchronous I/O requests in the list I<cblist> of "
3003 #~ "length I<n> have completed, a signal is delivered, or I<timeout> is not "
3004 #~ "NULL and the time interval it indicates has passed."
3005 #~ msgstr ""
3006 #~ "B<aio_suspend>()  関数は、長さ I<n> のリスト I<cblist> に含まれる非同期 I/"
3007 #~ "O リクエストのうち少なくとも 1 つが完了するか、 シグナルが配送されるか、 "
3008 #~ "I<timeout> が NULL でなく、かつその時間が過ぎるまで、 呼び出したプロセスを"
3009 #~ "停止 (suspend) する。"
3010
3011 #~ msgid ""
3012 #~ "The B<aio_write>()  function requests an asynchronous \"n = write(fd, "
3013 #~ "buf, count)\" with fd, buf, count given by I<aiocbp-E<gt>aio_fildes>, "
3014 #~ "I<aiocbp-E<gt>aio_buf>, I<aiocbp-E<gt>aio_nbytes>, respectively.  The "
3015 #~ "return status n can be retrieved upon completion using B<aio_return>(3)."
3016 #~ msgstr ""
3017 #~ "B<aio_write>()  関数は非同期の \"n = write(fd, buf, count)\" をリクエスト"
3018 #~ "する。 ここで fd, buf, count は、それぞれ I<aiocbp-E<gt>aio_fildes>, "
3019 #~ "I<aiocbp-E<gt>aio_buf>, I<aiocbp-E<gt>aio_nbytes> で与えられる。 返り値 "
3020 #~ "(return status) n は、完了時に B<aio_return>(3)  を使って取得できる。"