diff options
Diffstat (limited to 'templates/man2/process_vm_readv.2.pot')
| -rw-r--r-- | templates/man2/process_vm_readv.2.pot | 600 |
1 files changed, 600 insertions, 0 deletions
diff --git a/templates/man2/process_vm_readv.2.pot b/templates/man2/process_vm_readv.2.pot new file mode 100644 index 00000000..cf6e6573 --- /dev/null +++ b/templates/man2/process_vm_readv.2.pot @@ -0,0 +1,600 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-03-01 17:04+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "process_vm_readv" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"process_vm_readv, process_vm_writev - transfer data between process address " +"spaces" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "LIBRARY" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Standard C library (I<libc>, I<-lc>)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +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<#include E<lt>sys/uio.hE<gt>>\n" +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<ssize_t process_vm_readv(pid_t >I<pid>B<,>\n" +"B< const struct iovec *>I<local_iov>B<,>\n" +"B< unsigned long >I<liovcnt>B<,>\n" +"B< const struct iovec *>I<remote_iov>B<,>\n" +"B< unsigned long >I<riovcnt>B<,>\n" +"B< unsigned long >I<flags>B<);>\n" +"B<ssize_t process_vm_writev(pid_t >I<pid>B<,>\n" +"B< const struct iovec *>I<local_iov>B<,>\n" +"B< unsigned long >I<liovcnt>B<,>\n" +"B< const struct iovec *>I<remote_iov>B<,>\n" +"B< unsigned long >I<riovcnt>B<,>\n" +"B< unsigned long >I<flags>B<);>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<process_vm_readv>(), B<process_vm_writev>():" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid " _GNU_SOURCE\n" +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 "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"These system calls transfer data between the address space of the calling " +"process (\"the local process\") and the process identified by I<pid> (\"the " +"remote process\"). The data moves directly between the address spaces of " +"the two processes, without passing through kernel space." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<process_vm_readv>() system call transfers data from the remote " +"process to the local process. The data to be transferred is identified by " +"I<remote_iov> and I<riovcnt>: I<remote_iov> is a pointer to an array " +"describing address ranges in the process I<pid>, and I<riovcnt> specifies " +"the number of elements in I<remote_iov>. The data is transferred to the " +"locations specified by I<local_iov> and I<liovcnt>: I<local_iov> is a " +"pointer to an array describing address ranges in the calling process, and " +"I<liovcnt> specifies the number of elements in I<local_iov>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<process_vm_writev>() system call is the converse of " +"B<process_vm_readv>()\\[em]it transfers data from the local process to the " +"remote process. Other than the direction of the transfer, the arguments " +"I<liovcnt>, I<local_iov>, I<riovcnt>, and I<remote_iov> have the same " +"meaning as for B<process_vm_readv>()." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The I<local_iov> and I<remote_iov> arguments point to an array of I<iovec> " +"structures, described in B<iovec>(3type)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Buffers are processed in array order. This means that " +"B<process_vm_readv>() completely fills I<local_iov[0]> before proceeding to " +"I<local_iov[1]>, and so on. Likewise, I<remote_iov[0]> is completely read " +"before proceeding to I<remote_iov[1]>, and so on." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Similarly, B<process_vm_writev>() writes out the entire contents of " +"I<local_iov[0]> before proceeding to I<local_iov[1]>, and it completely " +"fills I<remote_iov[0]> before proceeding to I<remote_iov[1]>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The lengths of I<remote_iov[i].iov_len> and I<local_iov[i].iov_len> do not " +"have to be the same. Thus, it is possible to split a single local buffer " +"into multiple remote buffers, or vice versa." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The I<flags> argument is currently unused and must be set to 0." +msgstr "" + +#. In time, glibc might provide a wrapper that works around this limit, +#. as is done for readv()/writev() +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The values specified in the I<liovcnt> and I<riovcnt> arguments must be less " +"than or equal to B<IOV_MAX> (defined in I<E<lt>limits.hE<gt>> or accessible " +"via the call I<sysconf(_SC_IOV_MAX)>)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The count arguments and I<local_iov> are checked before doing any " +"transfers. If the counts are too big, or I<local_iov> is invalid, or the " +"addresses refer to regions that are inaccessible to the local process, none " +"of the vectors will be processed and an error will be returned immediately." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Note, however, that these system calls do not check the memory regions in " +"the remote process until just before doing the read/write. Consequently, a " +"partial read/write (see RETURN VALUE) may result if one of the " +"I<remote_iov> elements points to an invalid memory region in the remote " +"process. No further reads/writes will be attempted beyond that point. Keep " +"this in mind when attempting to read data of unknown length (such as C " +"strings that are null-terminated) from a remote process, by avoiding " +"spanning memory pages (typically 4\\ KiB) in a single remote I<iovec> " +"element. (Instead, split the remote read into two I<remote_iov> elements " +"and have them merge back into a single write I<local_iov> entry. The first " +"read entry goes up to the page boundary, while the second starts on the next " +"page boundary.)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Permission to read from or write to another process is governed by a ptrace " +"access mode B<PTRACE_MODE_ATTACH_REALCREDS> check; see B<ptrace>(2)." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "RETURN VALUE" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On success, B<process_vm_readv>() returns the number of bytes read and " +"B<process_vm_writev>() returns the number of bytes written. This return " +"value may be less than the total number of requested bytes, if a partial " +"read/write occurred. (Partial transfers apply at the granularity of " +"I<iovec> elements. These system calls won't perform a partial transfer that " +"splits a single I<iovec> element.) The caller should check the return value " +"to determine whether a partial read/write occurred." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "On error, -1 is returned and I<errno> is set to indicate the error." +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 "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EFAULT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The memory described by I<local_iov> is outside the caller's accessible " +"address space." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The memory described by I<remote_iov> is outside the accessible address " +"space of the process I<pid>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EINVAL>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The sum of the I<iov_len> values of either I<local_iov> or I<remote_iov> " +"overflows a I<ssize_t> value." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<flags> is not 0." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<liovcnt> or I<riovcnt> is too large." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOMEM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Could not allocate memory for internal copies of the I<iovec> structures." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EPERM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The caller does not have permission to access the address space of the " +"process I<pid>." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ESRCH>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "No process with ID I<pid> exists." +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 "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "Linux." +msgstr "" + +#. type: SH +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "HISTORY" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "Linux 3.2, glibc 2.15." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The data transfers performed by B<process_vm_readv>() and " +"B<process_vm_writev>() are not guaranteed to be atomic in any way." +msgstr "" + +#. Original user is MPI, http://www.mcs.anl.gov/research/projects/mpi/ +#. See also some benchmarks at http://lwn.net/Articles/405284/ +#. and http://marc.info/?l=linux-mm&m=130105930902915&w=2 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"These system calls were designed to permit fast message passing by allowing " +"messages to be exchanged with a single copy operation (rather than the " +"double copy that would be required when using, for example, shared memory or " +"pipes)." +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 "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The following code sample demonstrates the use of B<process_vm_readv>(). It " +"reads 20 bytes at the address 0x10000 from the process with PID 10 and " +"writes the first 10 bytes into I<buf1> and the second 10 bytes into I<buf2>." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"#define _GNU_SOURCE\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>sys/types.hE<gt>\n" +"#include E<lt>sys/uio.hE<gt>\n" +"\\&\n" +"int\n" +"main(void)\n" +"{\n" +" char buf1[10];\n" +" char buf2[10];\n" +" pid_t pid = 10; /* PID of remote process */\n" +" ssize_t nread;\n" +" struct iovec local[2];\n" +" struct iovec remote[1];\n" +"\\&\n" +" local[0].iov_base = buf1;\n" +" local[0].iov_len = 10;\n" +" local[1].iov_base = buf2;\n" +" local[1].iov_len = 10;\n" +" remote[0].iov_base = (void *) 0x10000;\n" +" remote[0].iov_len = 20;\n" +"\\&\n" +" nread = process_vm_readv(pid, local, 2, remote, 1, 0);\n" +" if (nread != 20)\n" +" exit(EXIT_FAILURE);\n" +"\\&\n" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. SRC END +#. 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 "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<readv>(2), B<writev>(2)" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2023-02-05" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: SH +#: debian-bookworm +#, no-wrap +msgid "VERSIONS" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"These system calls were added in Linux 3.2. Support is provided since glibc " +"2.15." +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "These system calls are nonstandard Linux extensions." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"#define _GNU_SOURCE\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>sys/types.hE<gt>\n" +"#include E<lt>sys/uio.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(void)\n" +"{\n" +" char buf1[10];\n" +" char buf2[10];\n" +" pid_t pid = 10; /* PID of remote process */\n" +" ssize_t nread;\n" +" struct iovec local[2];\n" +" struct iovec remote[1];\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" local[0].iov_base = buf1;\n" +" local[0].iov_len = 10;\n" +" local[1].iov_base = buf2;\n" +" local[1].iov_len = 10;\n" +" remote[0].iov_base = (void *) 0x10000;\n" +" remote[0].iov_len = 20;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" nread = process_vm_readv(pid, local, 2, remote, 1, 0);\n" +" if (nread != 20)\n" +" exit(EXIT_FAILURE);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "2023-05-03" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2023-03-30" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |