# Spanish translation of manpages # This file is distributed under the same license as the manpages-l10n package. # Copyright © of this file: msgid "" msgstr "" "Project-Id-Version: manpages-l10n 4.11.0\n" "POT-Creation-Date: 2024-06-01 05:41+0200\n" "PO-Revision-Date: 2021-09-03 21:22+0200\n" "Last-Translator: Automatically generated\n" "Language-Team: Spanish \n" "Language: es\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #. type: TH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "AIO" msgstr "" #. type: TH #: archlinux debian-unstable opensuse-tumbleweed #, no-wrap msgid "2024-05-02" msgstr "2 Mayo 2024" #. type: TH #: archlinux debian-unstable #, no-wrap msgid "Linux man-pages 6.8" msgstr "Páginas de Manual de Linux 6.8" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "NAME" msgstr "NOMBRE" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "aio - POSIX asynchronous I/O overview" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "DESCRIPTION" msgstr "DESCRIPCIÓN" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The POSIX asynchronous I/O (AIO) interface allows applications to initiate " "one or more I/O operations that are performed asynchronously (i.e., in the " "background). The application can elect to be notified of completion of the " "I/O operation in a variety of ways: by delivery of a signal, by " "instantiation of a thread, or no notification at all." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The POSIX AIO interface consists of the following functions:" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Enqueue a read request. This is the asynchronous analog of B(2)." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Enqueue a write request. This is the asynchronous analog of B(2)." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Enqueue a sync request for the I/O operations on a file descriptor. This is " "the asynchronous analog of B(2) and B(2)." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Obtain the error status of an enqueued I/O request." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Obtain the return status of a completed I/O request." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Suspend the caller until one or more of a specified set of I/O requests " "completes." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Attempt to cancel outstanding I/O requests on a specified file descriptor." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Enqueue multiple I/O requests using a single function call." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The I (\"asynchronous I/O control block\") structure defines " "parameters that control an I/O operation. An argument of this type is " "employed with all of the functions listed above. This structure has the " "following form:" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "#include Eaiocb.hE\n" "\\&\n" "struct aiocb {\n" " /* The order of these fields is implementation-dependent */\n" "\\&\n" " int aio_fildes; /* File descriptor */\n" " off_t aio_offset; /* File offset */\n" " volatile void *aio_buf; /* Location of buffer */\n" " size_t aio_nbytes; /* Length of transfer */\n" " int aio_reqprio; /* Request priority */\n" " struct sigevent aio_sigevent; /* Notification method */\n" " int aio_lio_opcode; /* Operation to be performed;\n" " lio_listio() only */\n" "\\&\n" " /* Various implementation-internal fields not shown */\n" "};\n" "\\&\n" "/* Operation codes for \\[aq]aio_lio_opcode\\[aq]: */\n" "\\&\n" "enum { LIO_READ, LIO_WRITE, LIO_NOP };\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The fields of this structure are as follows:" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The file descriptor on which the I/O operation is to be performed." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "This is the file offset at which the I/O operation is to be performed." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "This is the buffer used to transfer data for a read or write operation." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "This is the size of the buffer pointed to by I." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "This field specifies a value that is subtracted from the calling thread's " "real-time priority in order to determine the priority for execution of this " "I/O request (see B(3)). The specified value must be " "between 0 and the value returned by I. " "This field is ignored for file synchronization operations." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "This field is a structure that specifies how the caller is to be notified " "when the asynchronous I/O operation completes. Possible values for " "I are B, B, and " "B. See B(3type) for further details." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The type of operation to be performed; used only for B(3)." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "In addition to the standard functions listed above, the GNU C library " "provides the following extension to the POSIX AIO API:" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Set parameters for tuning the behavior of the glibc POSIX AIO implementation." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "ERRORS" msgstr "ERRORES" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "B" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The I field of the I structure was less than 0, or was " "greater than the limit returned by the call " "I." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "STANDARDS" msgstr "ESTÁNDARES" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "POSIX.1-2008." msgstr "POSIX.1-2008." #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "HISTORY" msgstr "HISTORIAL" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, fuzzy #| msgid "POSIX.1-2001." msgid "POSIX.1-2001. glibc 2.1." msgstr "POSIX.1-2001." #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "NOTES" msgstr "NOTAS" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "It is a good idea to zero out the control block buffer before use (see " "B(3)). The control block buffer and the buffer pointed to by " "I must not be changed while the I/O operation is in progress. " "These buffers must remain valid until the I/O operation completes." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Simultaneous asynchronous read or write operations using the same I " "structure yield undefined results." msgstr "" #. http://lse.sourceforge.net/io/aio.html #. http://lse.sourceforge.net/io/aionotes.txt #. http://lwn.net/Articles/148755/ #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The current Linux POSIX AIO implementation is provided in user space by " "glibc. This has a number of limitations, most notably that maintaining " "multiple threads to perform I/O operations is expensive and scales poorly. " "Work has been in progress for some time on a kernel state-machine-based " "implementation of asynchronous I/O (see B(2), B(2), " "B(2), B(2), B(2)), but this " "implementation hasn't yet matured to the point where the POSIX AIO " "implementation can be completely reimplemented using the kernel system calls." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "EXAMPLES" msgstr "EJEMPLOS" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The program below opens each of the files named in its command-line " "arguments and queues a request on the resulting file descriptor using " "B(3). The program then loops, periodically monitoring each of the " "I/O operations that is still in progress using B(3). Each of the " "I/O requests is set up to provide notification by delivery of a signal. " "After all I/O requests have completed, the program retrieves their status " "using B(3)." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The B signal (generated by typing control-\\e) causes the program " "to request cancelation of each of the outstanding requests using " "B(3)." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Here is an example of what we might see when running this program. In this " "example, the program queues two requests to standard input, and these are " "satisfied by two lines of input containing \"abc\" and \"x\"." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "$ B<./a.out /dev/stdin /dev/stdin>\n" "opened /dev/stdin on descriptor 3\n" "opened /dev/stdin on descriptor 4\n" "aio_error():\n" " for request 0 (descriptor 3): In progress\n" " for request 1 (descriptor 4): In progress\n" "B\n" "I/O completion signal received\n" "aio_error():\n" " for request 0 (descriptor 3): I/O succeeded\n" " for request 1 (descriptor 4): In progress\n" "aio_error():\n" " for request 1 (descriptor 4): In progress\n" "B\n" "I/O completion signal received\n" "aio_error():\n" " for request 1 (descriptor 4): I/O succeeded\n" "All I/O requests completed\n" "aio_return():\n" " for request 0 (descriptor 3): 4\n" " for request 1 (descriptor 4): 2\n" msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Program source" msgstr "Código fuente" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "#include Efcntl.hE\n" "#include Estdlib.hE\n" "#include Eunistd.hE\n" "#include Estdio.hE\n" "#include Eerrno.hE\n" "#include Eaio.hE\n" "#include Esignal.hE\n" "\\&\n" "#define BUF_SIZE 20 /* Size of buffers for read operations */\n" "\\&\n" "#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); } while (0)\n" "\\&\n" "struct ioRequest { /* Application-defined structure for tracking\n" " I/O requests */\n" " int reqNum;\n" " int status;\n" " struct aiocb *aiocbp;\n" "};\n" "\\&\n" "static volatile sig_atomic_t gotSIGQUIT = 0;\n" " /* On delivery of SIGQUIT, we attempt to\n" " cancel all outstanding I/O requests */\n" "\\&\n" "static void /* Handler for SIGQUIT */\n" "quitHandler(int sig)\n" "{\n" " gotSIGQUIT = 1;\n" "}\n" "\\&\n" "#define IO_SIGNAL SIGUSR1 /* Signal used to notify I/O completion */\n" "\\&\n" "static void /* Handler for I/O completion signal */\n" "aioSigHandler(int sig, siginfo_t *si, void *ucontext)\n" "{\n" " if (si-Esi_code == SI_ASYNCIO) {\n" " write(STDOUT_FILENO, \"I/O completion signal received\\en\", 31);\n" "\\&\n" " /* The corresponding ioRequest structure would be available as\n" " struct ioRequest *ioReq = si-Esi_value.sival_ptr;\n" " and the file descriptor would then be available via\n" " ioReq-Eaiocbp-Eaio_fildes */\n" " }\n" "}\n" "\\&\n" "int\n" "main(int argc, char *argv[])\n" "{\n" " struct sigaction sa;\n" " int s;\n" " int numReqs; /* Total number of queued I/O requests */\n" " int openReqs; /* Number of I/O requests still in progress */\n" "\\&\n" " if (argc E 2) {\n" " fprintf(stderr, \"Usage: %s EpathnameE EpathnameE...\\en\",\n" " argv[0]);\n" " exit(EXIT_FAILURE);\n" " }\n" "\\&\n" " numReqs = argc - 1;\n" "\\&\n" " /* Allocate our arrays. */\n" "\\&\n" " struct ioRequest *ioList = calloc(numReqs, sizeof(*ioList));\n" " if (ioList == NULL)\n" " errExit(\"calloc\");\n" "\\&\n" " struct aiocb *aiocbList = calloc(numReqs, sizeof(*aiocbList));\n" " if (aiocbList == NULL)\n" " errExit(\"calloc\");\n" "\\&\n" " /* Establish handlers for SIGQUIT and the I/O completion signal. */\n" "\\&\n" " sa.sa_flags = SA_RESTART;\n" " sigemptyset(&sa.sa_mask);\n" "\\&\n" " sa.sa_handler = quitHandler;\n" " if (sigaction(SIGQUIT, &sa, NULL) == -1)\n" " errExit(\"sigaction\");\n" "\\&\n" " sa.sa_flags = SA_RESTART | SA_SIGINFO;\n" " sa.sa_sigaction = aioSigHandler;\n" " if (sigaction(IO_SIGNAL, &sa, NULL) == -1)\n" " errExit(\"sigaction\");\n" "\\&\n" " /* Open each file specified on the command line, and queue\n" " a read request on the resulting file descriptor. */\n" "\\&\n" " for (size_t j = 0; j E numReqs; j++) {\n" " ioList[j].reqNum = j;\n" " ioList[j].status = EINPROGRESS;\n" " ioList[j].aiocbp = &aiocbList[j];\n" "\\&\n" " ioList[j].aiocbp-Eaio_fildes = open(argv[j + 1], O_RDONLY);\n" " if (ioList[j].aiocbp-Eaio_fildes == -1)\n" " errExit(\"open\");\n" " printf(\"opened %s on descriptor %d\\en\", argv[j + 1],\n" " ioList[j].aiocbp-Eaio_fildes);\n" "\\&\n" " ioList[j].aiocbp-Eaio_buf = malloc(BUF_SIZE);\n" " if (ioList[j].aiocbp-Eaio_buf == NULL)\n" " errExit(\"malloc\");\n" "\\&\n" " ioList[j].aiocbp-Eaio_nbytes = BUF_SIZE;\n" " ioList[j].aiocbp-Eaio_reqprio = 0;\n" " ioList[j].aiocbp-Eaio_offset = 0;\n" " ioList[j].aiocbp-Eaio_sigevent.sigev_notify = SIGEV_SIGNAL;\n" " ioList[j].aiocbp-Eaio_sigevent.sigev_signo = IO_SIGNAL;\n" " ioList[j].aiocbp-Eaio_sigevent.sigev_value.sival_ptr =\n" " &ioList[j];\n" "\\&\n" " s = aio_read(ioList[j].aiocbp);\n" " if (s == -1)\n" " errExit(\"aio_read\");\n" " }\n" "\\&\n" " openReqs = numReqs;\n" "\\&\n" " /* Loop, monitoring status of I/O requests. */\n" "\\&\n" " while (openReqs E 0) {\n" " sleep(3); /* Delay between each monitoring step */\n" "\\&\n" " if (gotSIGQUIT) {\n" "\\&\n" " /* On receipt of SIGQUIT, attempt to cancel each of the\n" " outstanding I/O requests, and display status returned\n" " from the cancelation requests. */\n" "\\&\n" " printf(\"got SIGQUIT; canceling I/O requests: \\en\");\n" "\\&\n" " for (size_t j = 0; j E numReqs; j++) {\n" " if (ioList[j].status == EINPROGRESS) {\n" " printf(\" Request %zu on descriptor %d:\", j,\n" " ioList[j].aiocbp-Eaio_fildes);\n" " s = aio_cancel(ioList[j].aiocbp-Eaio_fildes,\n" " ioList[j].aiocbp);\n" " if (s == AIO_CANCELED)\n" " printf(\"I/O canceled\\en\");\n" " else if (s == AIO_NOTCANCELED)\n" " printf(\"I/O not canceled\\en\");\n" " else if (s == AIO_ALLDONE)\n" " printf(\"I/O all done\\en\");\n" " else\n" " perror(\"aio_cancel\");\n" " }\n" " }\n" "\\&\n" " gotSIGQUIT = 0;\n" " }\n" "\\&\n" " /* Check the status of each I/O request that is still\n" " in progress. */\n" "\\&\n" " printf(\"aio_error():\\en\");\n" " for (size_t j = 0; j E numReqs; j++) {\n" " if (ioList[j].status == EINPROGRESS) {\n" " printf(\" for request %zu (descriptor %d): \",\n" " j, ioList[j].aiocbp-Eaio_fildes);\n" " ioList[j].status = aio_error(ioList[j].aiocbp);\n" "\\&\n" " switch (ioList[j].status) {\n" " case 0:\n" " printf(\"I/O succeeded\\en\");\n" " break;\n" " case EINPROGRESS:\n" " printf(\"In progress\\en\");\n" " break;\n" " case ECANCELED:\n" " printf(\"Canceled\\en\");\n" " break;\n" " default:\n" " perror(\"aio_error\");\n" " break;\n" " }\n" "\\&\n" " if (ioList[j].status != EINPROGRESS)\n" " openReqs--;\n" " }\n" " }\n" " }\n" "\\&\n" " printf(\"All I/O requests completed\\en\");\n" "\\&\n" " /* Check status return of all I/O requests. */\n" "\\&\n" " printf(\"aio_return():\\en\");\n" " for (size_t j = 0; j E numReqs; j++) {\n" " ssize_t s;\n" "\\&\n" " s = aio_return(ioList[j].aiocbp);\n" " printf(\" for request %zu (descriptor %d): %zd\\en\",\n" " j, ioList[j].aiocbp-Eaio_fildes, s);\n" " }\n" "\\&\n" " exit(EXIT_SUCCESS);\n" "}\n" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SEE ALSO" msgstr "VÉASE TAMBIÉN" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B(2), B(2), B(2), B(2), " "B(2), B(3), B(3), B(3), " "B(3), B(3), B(3), B(3)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "\"Asynchronous I/O Support in Linux 2.5\", Bhattacharya, Pratt, Pulavarty, " "and Morgan, Proceedings of the Linux Symposium, 2003, E<.UR https://www." "kernel.org/doc/ols/2003/ols2003-pages-351-366.pdf> E<.UE>" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "2023-02-05" msgstr "5 Febrero 2023" #. type: TH #: debian-bookworm #, no-wrap msgid "Linux man-pages 6.03" msgstr "Páginas de Manual de Linux 6.03" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "#include Eaiocb.hE\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "struct aiocb {\n" " /* The order of these fields is implementation-dependent */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " int aio_fildes; /* File descriptor */\n" " off_t aio_offset; /* File offset */\n" " volatile void *aio_buf; /* Location of buffer */\n" " size_t aio_nbytes; /* Length of transfer */\n" " int aio_reqprio; /* Request priority */\n" " struct sigevent aio_sigevent; /* Notification method */\n" " int aio_lio_opcode; /* Operation to be performed;\n" " lio_listio() only */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* Various implementation-internal fields not shown */\n" "};\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "/* Operation codes for \\[aq]aio_lio_opcode\\[aq]: */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "enum { LIO_READ, LIO_WRITE, LIO_NOP };\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "This field is a structure that specifies how the caller is to be notified " "when the asynchronous I/O operation completes. Possible values for " "I are B, B, and " "B. See B(7) for further details." msgstr "" #. type: SH #: debian-bookworm #, no-wrap msgid "VERSIONS" msgstr "VERSIONES" #. type: Plain text #: debian-bookworm msgid "The POSIX AIO interfaces are provided by glibc since glibc 2.1." msgstr "" #. type: Plain text #: debian-bookworm msgid "POSIX.1-2001, POSIX.1-2008." msgstr "POSIX.1-2001, POSIX.1-2008." #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "#include Efcntl.hE\n" "#include Estdlib.hE\n" "#include Eunistd.hE\n" "#include Estdio.hE\n" "#include Eerrno.hE\n" "#include Eaio.hE\n" "#include Esignal.hE\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "#define BUF_SIZE 20 /* Size of buffers for read operations */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); } while (0)\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "struct ioRequest { /* Application-defined structure for tracking\n" " I/O requests */\n" " int reqNum;\n" " int status;\n" " struct aiocb *aiocbp;\n" "};\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "static volatile sig_atomic_t gotSIGQUIT = 0;\n" " /* On delivery of SIGQUIT, we attempt to\n" " cancel all outstanding I/O requests */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "static void /* Handler for SIGQUIT */\n" "quitHandler(int sig)\n" "{\n" " gotSIGQUIT = 1;\n" "}\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "#define IO_SIGNAL SIGUSR1 /* Signal used to notify I/O completion */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "static void /* Handler for I/O completion signal */\n" "aioSigHandler(int sig, siginfo_t *si, void *ucontext)\n" "{\n" " if (si-Esi_code == SI_ASYNCIO) {\n" " write(STDOUT_FILENO, \"I/O completion signal received\\en\", 31);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* The corresponding ioRequest structure would be available as\n" " struct ioRequest *ioReq = si-Esi_value.sival_ptr;\n" " and the file descriptor would then be available via\n" " ioReq-Eaiocbp-Eaio_fildes */\n" " }\n" "}\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "int\n" "main(int argc, char *argv[])\n" "{\n" " struct sigaction sa;\n" " int s;\n" " int numReqs; /* Total number of queued I/O requests */\n" " int openReqs; /* Number of I/O requests still in progress */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (argc E 2) {\n" " fprintf(stderr, \"Usage: %s EpathnameE EpathnameE...\\en\",\n" " argv[0]);\n" " exit(EXIT_FAILURE);\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " numReqs = argc - 1;\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " /* Allocate our arrays. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " struct ioRequest *ioList = calloc(numReqs, sizeof(*ioList));\n" " if (ioList == NULL)\n" " errExit(\"calloc\");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " struct aiocb *aiocbList = calloc(numReqs, sizeof(*aiocbList));\n" " if (aiocbList == NULL)\n" " errExit(\"calloc\");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " /* Establish handlers for SIGQUIT and the I/O completion signal. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " sa.sa_flags = SA_RESTART;\n" " sigemptyset(&sa.sa_mask);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " sa.sa_handler = quitHandler;\n" " if (sigaction(SIGQUIT, &sa, NULL) == -1)\n" " errExit(\"sigaction\");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " sa.sa_flags = SA_RESTART | SA_SIGINFO;\n" " sa.sa_sigaction = aioSigHandler;\n" " if (sigaction(IO_SIGNAL, &sa, NULL) == -1)\n" " errExit(\"sigaction\");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* Open each file specified on the command line, and queue\n" " a read request on the resulting file descriptor. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " for (size_t j = 0; j E numReqs; j++) {\n" " ioList[j].reqNum = j;\n" " ioList[j].status = EINPROGRESS;\n" " ioList[j].aiocbp = &aiocbList[j];\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " ioList[j].aiocbp-Eaio_fildes = open(argv[j + 1], O_RDONLY);\n" " if (ioList[j].aiocbp-Eaio_fildes == -1)\n" " errExit(\"open\");\n" " printf(\"opened %s on descriptor %d\\en\", argv[j + 1],\n" " ioList[j].aiocbp-Eaio_fildes);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " ioList[j].aiocbp-Eaio_buf = malloc(BUF_SIZE);\n" " if (ioList[j].aiocbp-Eaio_buf == NULL)\n" " errExit(\"malloc\");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " ioList[j].aiocbp-Eaio_nbytes = BUF_SIZE;\n" " ioList[j].aiocbp-Eaio_reqprio = 0;\n" " ioList[j].aiocbp-Eaio_offset = 0;\n" " ioList[j].aiocbp-Eaio_sigevent.sigev_notify = SIGEV_SIGNAL;\n" " ioList[j].aiocbp-Eaio_sigevent.sigev_signo = IO_SIGNAL;\n" " ioList[j].aiocbp-Eaio_sigevent.sigev_value.sival_ptr =\n" " &ioList[j];\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " s = aio_read(ioList[j].aiocbp);\n" " if (s == -1)\n" " errExit(\"aio_read\");\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " openReqs = numReqs;\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " /* Loop, monitoring status of I/O requests. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " while (openReqs E 0) {\n" " sleep(3); /* Delay between each monitoring step */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " if (gotSIGQUIT) {\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* On receipt of SIGQUIT, attempt to cancel each of the\n" " outstanding I/O requests, and display status returned\n" " from the cancelation requests. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " printf(\"got SIGQUIT; canceling I/O requests: \\en\");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " for (size_t j = 0; j E numReqs; j++) {\n" " if (ioList[j].status == EINPROGRESS) {\n" " printf(\" Request %zu on descriptor %d:\", j,\n" " ioList[j].aiocbp-Eaio_fildes);\n" " s = aio_cancel(ioList[j].aiocbp-Eaio_fildes,\n" " ioList[j].aiocbp);\n" " if (s == AIO_CANCELED)\n" " printf(\"I/O canceled\\en\");\n" " else if (s == AIO_NOTCANCELED)\n" " printf(\"I/O not canceled\\en\");\n" " else if (s == AIO_ALLDONE)\n" " printf(\"I/O all done\\en\");\n" " else\n" " perror(\"aio_cancel\");\n" " }\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " gotSIGQUIT = 0;\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* Check the status of each I/O request that is still\n" " in progress. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " printf(\"aio_error():\\en\");\n" " for (size_t j = 0; j E numReqs; j++) {\n" " if (ioList[j].status == EINPROGRESS) {\n" " printf(\" for request %zu (descriptor %d): \",\n" " j, ioList[j].aiocbp-Eaio_fildes);\n" " ioList[j].status = aio_error(ioList[j].aiocbp);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " switch (ioList[j].status) {\n" " case 0:\n" " printf(\"I/O succeeded\\en\");\n" " break;\n" " case EINPROGRESS:\n" " printf(\"In progress\\en\");\n" " break;\n" " case ECANCELED:\n" " printf(\"Canceled\\en\");\n" " break;\n" " default:\n" " perror(\"aio_error\");\n" " break;\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (ioList[j].status != EINPROGRESS)\n" " openReqs--;\n" " }\n" " }\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " printf(\"All I/O requests completed\\en\");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " /* Check status return of all I/O requests. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " printf(\"aio_return():\\en\");\n" " for (size_t j = 0; j E numReqs; j++) {\n" " ssize_t s;\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " s = aio_return(ioList[j].aiocbp);\n" " printf(\" for request %zu (descriptor %d): %zd\\en\",\n" " j, ioList[j].aiocbp-Eaio_fildes, s);\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " exit(EXIT_SUCCESS);\n" "}\n" msgstr "" " exit(EXIT_SUCCESS);\n" "}\n" #. type: TH #: fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "2023-10-31" msgstr "31 Octubre 2023" #. type: TH #: fedora-40 mageia-cauldron #, no-wrap msgid "Linux man-pages 6.06" msgstr "Páginas de Manual de Linux 6.06" #. type: TH #: fedora-rawhide #, no-wrap msgid "Linux man-pages 6.7" msgstr "Páginas de Manual de Linux 6.7" #. type: TH #: opensuse-leap-15-6 #, no-wrap msgid "2023-03-30" msgstr "30 Marzo 2023" #. type: TH #: opensuse-leap-15-6 #, no-wrap msgid "Linux man-pages 6.04" msgstr "Páginas de Manual de Linux 6.04" #. type: TH #: opensuse-tumbleweed #, no-wrap msgid "Linux man-pages (unreleased)" msgstr "Páginas de Manual de Linux (no publicadas)"