diff options
Diffstat (limited to 'templates/man2/ptrace.2.pot')
| -rw-r--r-- | templates/man2/ptrace.2.pot | 442 |
1 files changed, 335 insertions, 107 deletions
diff --git a/templates/man2/ptrace.2.pot b/templates/man2/ptrace.2.pot index 4127ee8e..f4d9c6fe 100644 --- a/templates/man2/ptrace.2.pot +++ b/templates/man2/ptrace.2.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-03-01 17:05+0100\n" +"POT-Creation-Date: 2024-06-01 06:13+0200\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" @@ -24,15 +24,15 @@ msgid "ptrace" msgstr "" #. type: TH -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable opensuse-tumbleweed #, no-wrap -msgid "2023-10-31" +msgid "2024-05-02" msgstr "" #. type: TH -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable #, no-wrap -msgid "Linux man-pages 6.06" +msgid "Linux man-pages 6.8" msgstr "" #. type: SH @@ -76,11 +76,10 @@ msgid "B<#include E<lt>sys/ptrace.hE<gt>>\n" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed #, no-wrap msgid "" -"B<long ptrace(enum __ptrace_request >I<request>B<, pid_t >I<pid>B<,>\n" +"B<long ptrace(enum __ptrace_request >I<op>B<, pid_t >I<pid>B<,>\n" "B< void *>I<addr>B<, void *>I<data>B<);>\n" msgstr "" @@ -145,8 +144,7 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "While being traced, the tracee will stop each time a signal is delivered, " "even if the signal is being ignored. (An exception is B<SIGKILL>, which has " @@ -154,7 +152,7 @@ msgid "" "B<waitpid>(2) (or one of the related \"wait\" system calls); that call will " "return a I<status> value containing information that indicates the cause of " "the stop in the tracee. While the tracee is stopped, the tracer can use " -"various ptrace requests to inspect and modify the tracee. The tracer then " +"various ptrace operations to inspect and modify the tracee. The tracer then " "causes the tracee to continue, optionally ignoring the delivered signal (or " "even delivering a different signal instead)." msgstr "" @@ -178,9 +176,8 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed -msgid "The value of I<request> determines the action to be performed:" +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "The value of I<op> determines the operation to be performed:" msgstr "" #. type: TP @@ -191,44 +188,43 @@ msgid "B<PTRACE_TRACEME>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Indicate that this process is to be traced by its parent. A process " -"probably shouldn't make this request if its parent isn't expecting to trace " -"it. (I<pid>, I<addr>, and I<data> are ignored.)" +"probably shouldn't make this operation if its parent isn't expecting to " +"trace it. (I<pid>, I<addr>, and I<data> are ignored.)" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"The B<PTRACE_TRACEME> request is used only by the tracee; the remaining " -"requests are used only by the tracer. In the following requests, I<pid> " -"specifies the thread ID of the tracee to be acted on. For requests other " +"The B<PTRACE_TRACEME> operation is used only by the tracee; the remaining " +"operations are used only by the tracer. In the following operations, I<pid> " +"specifies the thread ID of the tracee to be acted on. For operations other " "than B<PTRACE_ATTACH>, B<PTRACE_SEIZE>, B<PTRACE_INTERRUPT>, and " "B<PTRACE_KILL>, the tracee must be stopped." msgstr "" #. type: TP -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_PEEKTEXT>" msgstr "" #. type: TQ -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_PEEKDATA>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Read a word at the address I<addr> in the tracee's memory, returning the " "word as the result of the B<ptrace>() call. Linux does not have separate " -"text and data address spaces, so these two requests are currently " +"text and data address spaces, so these two operations are currently " "equivalent. (I<data> is ignored; but see NOTES.)" msgstr "" @@ -253,24 +249,25 @@ msgid "" msgstr "" #. type: TP -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_POKETEXT>" msgstr "" #. type: TQ -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_POKEDATA>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Copy the word I<data> to the address I<addr> in the tracee's memory. As for " -"B<PTRACE_PEEKTEXT> and B<PTRACE_PEEKDATA>, these two requests are currently " -"equivalent." +"B<PTRACE_PEEKTEXT> and B<PTRACE_PEEKDATA>, these two operations are " +"currently equivalent." msgstr "" #. type: TP @@ -295,13 +292,15 @@ msgid "" msgstr "" #. type: TP -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_GETREGS>" msgstr "" #. type: TQ -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_GETFPREGS>" msgstr "" @@ -341,13 +340,15 @@ msgid "" msgstr "" #. type: TP -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_SETREGS>" msgstr "" #. type: TQ -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_SETFPREGS>" msgstr "" @@ -829,13 +830,15 @@ msgid "" msgstr "" #. type: TP -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_SYSCALL>" msgstr "" #. type: TQ -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_SINGLESTEP>" msgstr "" @@ -868,41 +871,41 @@ msgstr "" #. see change_syscall in tools/testing/selftests/seccomp/seccomp_bpf.c #. and also strace's linux/*/set_scno.c files. #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "When in syscall-enter-stop, change the number of the system call that is " "about to be executed to the number specified in the I<data> argument. The " -"I<addr> argument is ignored. This request is currently supported only on " +"I<addr> argument is ignored. This operation is currently supported only on " "arm (and arm64, though only for backwards compatibility), but most other " "architectures have other means of accomplishing this (usually by changing " "the register that the userland code passed the system call number in)." msgstr "" #. type: TP -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_SYSEMU>" msgstr "" #. type: TQ -#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed #, no-wrap msgid "B<PTRACE_SYSEMU_SINGLESTEP> (since Linux 2.6.14)" msgstr "" #. As at 3.7 #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "For B<PTRACE_SYSEMU>, continue and stop on entry to the next system call, " "which will not be executed. See the documentation on syscall-stops below. " "For B<PTRACE_SYSEMU_SINGLESTEP>, do the same but also singlestep if not a " "system call. This call is used by programs like User Mode Linux that want " "to emulate all the tracee's system calls. The I<data> argument is treated " -"as for B<PTRACE_CONT>. The I<addr> argument is ignored. These requests are " -"currently supported only on x86." +"as for B<PTRACE_CONT>. The I<addr> argument is ignored. These operations " +"are currently supported only on x86." msgstr "" #. type: TP @@ -1385,8 +1388,7 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "The tracer cannot assume that the ptrace-stopped tracee exists. There are " "many scenarios when the tracee may die while stopped (such as B<SIGKILL>). " @@ -1400,7 +1402,7 @@ msgid "" "there is no guarantee that I<waitpid(WNOHANG)> will reliably report the " "tracee's death status if a ptrace operation returned B<ESRCH>. " "I<waitpid(WNOHANG)> may return 0 instead. In other words, the tracee may be " -"\"not yet fully dead\", but already refusing ptrace requests." +"\"not yet fully dead\", but already refusing ptrace operations." msgstr "" #. type: Plain text @@ -1548,8 +1550,7 @@ msgid "Signal-delivery-stop" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "When a (possibly multithreaded) process receives any signal except " "B<SIGKILL>, the kernel selects an arbitrary thread which handles the " @@ -1558,7 +1559,7 @@ msgid "" "traced, it enters signal-delivery-stop. At this point, the signal is not " "yet delivered to the process, and can be suppressed by the tracer. If the " "tracer doesn't suppress the signal, it passes the signal to the tracee in " -"the next ptrace restart request. This second step of signal delivery is " +"the next ptrace restart operation. This second step of signal delivery is " "called I<signal injection> in this manual page. Note that if the signal is " "blocked, signal-delivery-stop doesn't happen until the signal is unblocked, " "with the usual exception that B<SIGSTOP> can't be blocked." @@ -1599,12 +1600,11 @@ msgid "ptrace(PTRACE_restart, pid, 0, sig)\n" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"where B<PTRACE_restart> is one of the restarting ptrace requests. If I<sig> " -"is 0, then a signal is not delivered. Otherwise, the signal I<sig> is " -"delivered. This operation is called I<signal injection> in this manual " +"where B<PTRACE_restart> is one of the restarting ptrace operations. If " +"I<sig> is 0, then a signal is not delivered. Otherwise, the signal I<sig> " +"is delivered. This operation is called I<signal injection> in this manual " "page, to distinguish it from signal-delivery-stop." msgstr "" @@ -1643,10 +1643,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"The fact that signal injection requests may be ignored when restarting the " +"The fact that signal injection operations may be ignored when restarting the " "tracee after ptrace stops that are not signal-delivery-stops is a cause of " "confusion among ptrace users. One typical scenario is that the tracer " "observes group-stop, mistakes it for signal-delivery-stop, restarts the " @@ -2056,13 +2055,12 @@ msgid "I<si_code> E<lt>= 0" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "B<SIGTRAP> was delivered as a result of a user-space action, for example, a " "system call (B<tgkill>(2), B<kill>(2), B<sigqueue>(3), etc.), expiration of " "a POSIX timer, change of state on a POSIX message queue, or completion of an " -"asynchronous I/O request." +"asynchronous I/O operation." msgstr "" #. type: TP @@ -2426,9 +2424,8 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed -msgid "The request" +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed +msgid "The operation" msgstr "" #. type: Plain text @@ -2748,23 +2745,21 @@ msgid "RETURN VALUE" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"On success, the B<PTRACE_PEEK*> requests return the requested data (but see " -"NOTES), the B<PTRACE_SECCOMP_GET_FILTER> request returns the number of " -"instructions in the BPF program, the B<PTRACE_GET_SYSCALL_INFO> request " +"On success, the B<PTRACE_PEEK*> operations return the requested data (but " +"see NOTES), the B<PTRACE_SECCOMP_GET_FILTER> operation returns the number of " +"instructions in the BPF program, the B<PTRACE_GET_SYSCALL_INFO> operation " "returns the number of bytes available to be written by the kernel, and other " -"requests return zero." +"operations return zero." msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"On error, all requests return -1, and I<errno> is set to indicate the " -"error. Since the value returned by a successful B<PTRACE_PEEK*> request may " -"be -1, the caller must clear I<errno> before the call, and then check it " +"On error, all operations return -1, and I<errno> is set to indicate the " +"error. Since the value returned by a successful B<PTRACE_PEEK*> operation " +"may be -1, the caller must clear I<errno> before the call, and then check it " "afterward to determine whether or not an error occurred." msgstr "" @@ -2827,13 +2822,11 @@ msgid "B<EIO>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" -"I<request> is invalid, or an attempt was made to read from or write to an " -"invalid area in the tracer's or the tracee's memory, or there was a word-" -"alignment violation, or an invalid signal was specified during a restart " -"request." +"I<op> is invalid, or an attempt was made to read from or write to an invalid " +"area in the tracer's or the tracee's memory, or there was a word-alignment " +"violation, or an invalid signal was specified during a restart operation." msgstr "" #. type: TP @@ -2863,11 +2856,10 @@ msgid "B<ESRCH>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "The specified process does not exist, or is not currently being traced by " -"the caller, or is not stopped (for requests that require a stopped tracee)." +"the caller, or is not stopped (for operations that require a stopped tracee)." msgstr "" #. type: SH @@ -2912,14 +2904,13 @@ msgid "NOTES" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "Although arguments to B<ptrace>() are interpreted according to the " "prototype given, glibc currently declares B<ptrace>() as a variadic " -"function with only the I<request> argument fixed. It is recommended to " -"always supply four arguments, even if the requested operation does not use " -"them, setting unused/ignored arguments to I<0L> or I<(void\\ *)\\ 0>." +"function with only the I<op> argument fixed. It is recommended to always " +"supply four arguments, even if the requested operation does not use them, " +"setting unused/ignored arguments to I<0L> or I<(void\\ *)\\ 0>." msgstr "" #. type: Plain text @@ -3526,11 +3517,10 @@ msgid "C library/kernel differences" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable fedora-rawhide opensuse-tumbleweed msgid "" "At the system call level, the B<PTRACE_PEEKTEXT>, B<PTRACE_PEEKDATA>, and " -"B<PTRACE_PEEKUSER> requests have a different API: they store the result at " +"B<PTRACE_PEEKUSER> operations have a different API: they store the result at " "the address specified by the I<data> parameter, and the return value is the " "error flag. The glibc wrapper function provides the API given in " "DESCRIPTION above, with the result being returned via the function return " @@ -3705,52 +3695,284 @@ msgstr "" msgid "Linux man-pages 6.03" msgstr "" +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "" +"B<long ptrace(enum __ptrace_request >I<request>B<, pid_t >I<pid>B<,>\n" +"B< void *>I<addr>B<, void *>I<data>B<);>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"While being traced, the tracee will stop each time a signal is delivered, " +"even if the signal is being ignored. (An exception is B<SIGKILL>, which has " +"its usual effect.) The tracer will be notified at its next call to " +"B<waitpid>(2) (or one of the related \"wait\" system calls); that call will " +"return a I<status> value containing information that indicates the cause of " +"the stop in the tracee. While the tracee is stopped, the tracer can use " +"various ptrace requests to inspect and modify the tracee. The tracer then " +"causes the tracee to continue, optionally ignoring the delivered signal (or " +"even delivering a different signal instead)." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "The value of I<request> determines the action to be performed:" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"Indicate that this process is to be traced by its parent. A process " +"probably shouldn't make this request if its parent isn't expecting to trace " +"it. (I<pid>, I<addr>, and I<data> are ignored.)" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"The B<PTRACE_TRACEME> request is used only by the tracee; the remaining " +"requests are used only by the tracer. In the following requests, I<pid> " +"specifies the thread ID of the tracee to be acted on. For requests other " +"than B<PTRACE_ATTACH>, B<PTRACE_SEIZE>, B<PTRACE_INTERRUPT>, and " +"B<PTRACE_KILL>, the tracee must be stopped." +msgstr "" + #. type: TP -#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "B<PTRACE_PEEKTEXT>, B<PTRACE_PEEKDATA>" msgstr "" +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"Read a word at the address I<addr> in the tracee's memory, returning the " +"word as the result of the B<ptrace>() call. Linux does not have separate " +"text and data address spaces, so these two requests are currently " +"equivalent. (I<data> is ignored; but see NOTES.)" +msgstr "" + #. type: TP -#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "B<PTRACE_POKETEXT>, B<PTRACE_POKEDATA>" msgstr "" +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"Copy the word I<data> to the address I<addr> in the tracee's memory. As for " +"B<PTRACE_PEEKTEXT> and B<PTRACE_PEEKDATA>, these two requests are currently " +"equivalent." +msgstr "" + #. type: TP -#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "B<PTRACE_GETREGS>, B<PTRACE_GETFPREGS>" msgstr "" #. type: TP -#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "B<PTRACE_SETREGS>, B<PTRACE_SETFPREGS>" msgstr "" #. type: TP -#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "B<PTRACE_SYSCALL>, B<PTRACE_SINGLESTEP>" msgstr "" +#. commit 3f471126ee53feb5e9b210ea2f525ed3bb9b7a7f +#. As of 4.19-rc2 +#. commit 27aa55c5e5123fa8b8ad0156559d34d7edff58ca +#. see change_syscall in tools/testing/selftests/seccomp/seccomp_bpf.c +#. and also strace's linux/*/set_scno.c files. +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"When in syscall-enter-stop, change the number of the system call that is " +"about to be executed to the number specified in the I<data> argument. The " +"I<addr> argument is ignored. This request is currently supported only on " +"arm (and arm64, though only for backwards compatibility), but most other " +"architectures have other means of accomplishing this (usually by changing " +"the register that the userland code passed the system call number in)." +msgstr "" + #. type: TP -#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "B<PTRACE_SYSEMU>, B<PTRACE_SYSEMU_SINGLESTEP> (since Linux 2.6.14)" msgstr "" +#. As at 3.7 +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"For B<PTRACE_SYSEMU>, continue and stop on entry to the next system call, " +"which will not be executed. See the documentation on syscall-stops below. " +"For B<PTRACE_SYSEMU_SINGLESTEP>, do the same but also singlestep if not a " +"system call. This call is used by programs like User Mode Linux that want " +"to emulate all the tracee's system calls. The I<data> argument is treated " +"as for B<PTRACE_CONT>. The I<addr> argument is ignored. These requests are " +"currently supported only on x86." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"The tracer cannot assume that the ptrace-stopped tracee exists. There are " +"many scenarios when the tracee may die while stopped (such as B<SIGKILL>). " +"Therefore, the tracer must be prepared to handle an B<ESRCH> error on any " +"ptrace operation. Unfortunately, the same error is returned if the tracee " +"exists but is not ptrace-stopped (for commands which require a stopped " +"tracee), or if it is not traced by the process which issued the ptrace " +"call. The tracer needs to keep track of the stopped/running state of the " +"tracee, and interpret B<ESRCH> as \"tracee died unexpectedly\" only if it " +"knows that the tracee has been observed to enter ptrace-stop. Note that " +"there is no guarantee that I<waitpid(WNOHANG)> will reliably report the " +"tracee's death status if a ptrace operation returned B<ESRCH>. " +"I<waitpid(WNOHANG)> may return 0 instead. In other words, the tracee may be " +"\"not yet fully dead\", but already refusing ptrace requests." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"When a (possibly multithreaded) process receives any signal except " +"B<SIGKILL>, the kernel selects an arbitrary thread which handles the " +"signal. (If the signal is generated with B<tgkill>(2), the target thread " +"can be explicitly selected by the caller.) If the selected thread is " +"traced, it enters signal-delivery-stop. At this point, the signal is not " +"yet delivered to the process, and can be suppressed by the tracer. If the " +"tracer doesn't suppress the signal, it passes the signal to the tracee in " +"the next ptrace restart request. This second step of signal delivery is " +"called I<signal injection> in this manual page. Note that if the signal is " +"blocked, signal-delivery-stop doesn't happen until the signal is unblocked, " +"with the usual exception that B<SIGSTOP> can't be blocked." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"where B<PTRACE_restart> is one of the restarting ptrace requests. If I<sig> " +"is 0, then a signal is not delivered. Otherwise, the signal I<sig> is " +"delivered. This operation is called I<signal injection> in this manual " +"page, to distinguish it from signal-delivery-stop." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"The fact that signal injection requests may be ignored when restarting the " +"tracee after ptrace stops that are not signal-delivery-stops is a cause of " +"confusion among ptrace users. One typical scenario is that the tracer " +"observes group-stop, mistakes it for signal-delivery-stop, restarts the " +"tracee with" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"B<SIGTRAP> was delivered as a result of a user-space action, for example, a " +"system call (B<tgkill>(2), B<kill>(2), B<sigqueue>(3), etc.), expiration of " +"a POSIX timer, change of state on a POSIX message queue, or completion of an " +"asynchronous I/O request." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "The request" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"On success, the B<PTRACE_PEEK*> requests return the requested data (but see " +"NOTES), the B<PTRACE_SECCOMP_GET_FILTER> request returns the number of " +"instructions in the BPF program, the B<PTRACE_GET_SYSCALL_INFO> request " +"returns the number of bytes available to be written by the kernel, and other " +"requests return zero." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"On error, all requests return -1, and I<errno> is set to indicate the " +"error. Since the value returned by a successful B<PTRACE_PEEK*> request may " +"be -1, the caller must clear I<errno> before the call, and then check it " +"afterward to determine whether or not an error occurred." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<request> is invalid, or an attempt was made to read from or write to an " +"invalid area in the tracer's or the tracee's memory, or there was a word-" +"alignment violation, or an invalid signal was specified during a restart " +"request." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"The specified process does not exist, or is not currently being traced by " +"the caller, or is not stopped (for requests that require a stopped tracee)." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"Although arguments to B<ptrace>() are interpreted according to the " +"prototype given, glibc currently declares B<ptrace>() as a variadic " +"function with only the I<request> argument fixed. It is recommended to " +"always supply four arguments, even if the requested operation does not use " +"them, setting unused/ignored arguments to I<0L> or I<(void\\ *)\\ 0>." +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6 +msgid "" +"At the system call level, the B<PTRACE_PEEKTEXT>, B<PTRACE_PEEKDATA>, and " +"B<PTRACE_PEEKUSER> requests have a different API: they store the result at " +"the address specified by the I<data> parameter, and the return value is the " +"error flag. The glibc wrapper function provides the API given in " +"DESCRIPTION above, with the result being returned via the function return " +"value." +msgstr "" + #. type: TH -#: debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#: fedora-40 mageia-cauldron #, no-wrap -msgid "2023-03-30" +msgid "2023-10-31" msgstr "" #. type: TH -#: debian-unstable opensuse-tumbleweed +#: fedora-40 mageia-cauldron #, no-wrap -msgid "Linux man-pages 6.05.01" +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: TH +#: fedora-rawhide +#, no-wrap +msgid "2024-03-03" +msgstr "" + +#. type: TH +#: fedora-rawhide +#, no-wrap +msgid "Linux man-pages 6.7" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2023-03-30" msgstr "" #. type: TH @@ -3758,3 +3980,9 @@ msgstr "" #, no-wrap msgid "Linux man-pages 6.04" msgstr "" + +#. type: TH +#: opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages (unreleased)" +msgstr "" |