aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKees Cook <keescook@chromium.org>2013-01-10 23:54:12 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2013-01-11 00:31:53 +0100
commit491b2e75a3533b9bb65636ea80cd82bbc60227d8 (patch)
treeec732fe7748b9a2c52186e3647899b42a9c422c3
parent7f26805b7e9a5ee2fcf6bb597d56899b9e56c8b4 (diff)
downloadman-pages-491b2e75a3533b9bb65636ea80cd82bbc60227d8.tar.gz
prctl.2: Document PR_SET_PTRACER
Document the Yama LSM's prctl handler that allows processes to declare ptrace restriction exception relationships via PR_SET_PTRACER. Signed-off-by: Kees Cook <keescook@chromium.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man2/prctl.218
1 files changed, 17 insertions, 1 deletions
diff --git a/man2/prctl.2 b/man2/prctl.2
index c8a4919c26..506c7b3a03 100644
--- a/man2/prctl.2
+++ b/man2/prctl.2
@@ -45,9 +45,10 @@
.\" 2012-09-20 Kees Cook, document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
.\" 2012-10-25 Michael Kerrisk, Document PR_SET_TIMERSLACK and
.\" PR_GET_TIMERSLACK
+.\" 2013-01-10 Kees Cook, document PR_SET_PTRACER
.\"
.\"
-.TH PRCTL 2 2012-10-25 "Linux" "Linux Programmer's Manual"
+.TH PRCTL 2 2013-01-10 "Linux" "Linux Programmer's Manual"
.SH NAME
prctl \- operations on a process
.SH SYNOPSIS
@@ -270,6 +271,21 @@ Return the current value of the parent process death signal,
in the location pointed to by
.IR "(int\ *) arg2" .
.TP
+.BR PR_SET_PTRACER " (since Linux 3.4)"
+This is only meaningful when the Yama LSM is enabled and in mode 1
+("restricted ptrace", visible via
+.IR /proc/sys/kernel/yama/ptrace_scope ).
+When a "ptracer process id" is passed in \fIarg2\fP, the caller is declaring
+that the ptracer process can ptrace the current process as if it were a
+direct process ancestor. When set to 0, this relationship is removed. When
+set to
+.BR PR_SET_PTRACER_ANY,
+the ptrace restrictions introduced by Yama are effectively disabled for the
+current process.
+
+For further information, see the kernel source file
+.IR Documentation/security/Yama.txt .
+.TP
.BR PR_SET_SECCOMP " (since Linux 2.6.23)"
.\" See http://thread.gmane.org/gmane.linux.kernel/542632
.\" [PATCH 0 of 2] seccomp updates