NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | STANDARDS | HISTORY | SEE ALSO | COLOPHON |
|
|
PR_SET_PTRACER(2const) PR_SET_PTRACER(2const)
PR_SET_PTRACER - allow processes to ptrace(2) the calling process
Standard C library (libc, -lc)
#include <linux/prctl.h> /* Definition of PR_* constants */ #include <sys/prctl.h> int prctl(PR_SET_PTRACER, long pid);
This is meaningful only when the Yama LSM is enabled and in mode 1 ("restricted ptrace", visible via /proc/sys/kernel/yama/ ptrace_scope). When a "ptracer process ID" is passed in pid, the caller is declaring that the ptracer process can ptrace(2) the calling process as if it were a direct process ancestor. Each PR_SET_PTRACER operation replaces the previous "ptracer process ID". Employing PR_SET_PTRACER with pid set to 0 clears the caller's "ptracer process ID". If pid is PR_SET_PTRACER_ANY, the ptrace restrictions introduced by Yama are effectively disabled for the calling process.
On success, 0 is returned. On error, -1 is returned, and errno is set to indicate the error.
EINVAL pid is not 0, PR_SET_PTRACER_ANY, nor the PID of an existing process.
Linux.
Linux 3.4.
prctl(2), For further information, see the kernel source file Documentation/admin-guide/LSM/Yama.rst (or Documentation/ security/Yama.txt before Linux 4.13).
This page is part of the man-pages (Linux kernel and C library
user-space interface documentation) project. Information about
the project can be found at
⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report
for this manual page, see
⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
This page was obtained from the tarball man-pages-6.9.1.tar.gz
fetched from
⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
2024-06-26. If you discover any rendering problems in this HTML
version of the page, or you believe there is a better or more up-
to-date source for the page, or you have corrections or
improvements to the information in this COLOPHON (which is not
part of the original manual page), send a mail to
[email protected]
Linux man-pages 6.9.1 2024-06-02 PR_SET_PTRACER(2const)
Pages that refer to this page: prctl(2)