diff options
author | Tom Hromatka <tom.hromatka@oracle.com> | 2021-08-17 14:28:30 -0600 |
---|---|---|
committer | Paul Moore <paul@paul-moore.com> | 2021-08-23 11:11:29 -0400 |
commit | 3796e2789ba829983551787bfc41ea0636af8541 (patch) | |
tree | e09da50c5d68e84fbb5714bd89b9372cda4923e6 | |
parent | 6e66206a8e687aa86c00e9b470b56d1be79b6c01 (diff) | |
download | libseccomp-3796e2789ba829983551787bfc41ea0636af8541.tar.gz |
doc: Add BUGS section to seccomp_rule_add.3
Add BUGS section to seccomp_rule_add.3 and add a warning about
adding a seccomp filter to syscalls that are always expected to
succeed.
PowerPC's glibc behaves differently from other architectures and
will not return a negative number for the getpid() syscall.
Fixes: https://github.com/seccomp/libseccomp/issues/313
Acked-by: Paul Moore <paul@paul-moore.com>
Signed-off-by: Tom Hromatka <tom.hromatka@oracle.com>
(imported from commit b9a8f3dbdfe84bfe7802bb9532253cc0a46b5b8a)
-rw-r--r-- | doc/man/man3/seccomp_rule_add.3 | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/man/man3/seccomp_rule_add.3 b/doc/man/man3/seccomp_rule_add.3 index 4d8ef3f..3ad80c7 100644 --- a/doc/man/man3/seccomp_rule_add.3 +++ b/doc/man/man3/seccomp_rule_add.3 @@ -425,6 +425,24 @@ repository, can be found at https://github.com/seccomp/libseccomp. This tool, as well as the libseccomp library, is currently under development, please report any bugs at the project site or directly to the author. .\" ////////////////////////////////////////////////////////////////////////// +.SH BUGS +.\" ////////////////////////////////////////////////////////////////////////// +.P +The runtime behavior of seccomp filters is dependent upon the kernel +version, the processor architecture, and other libraries including libc. +This could affect the return code of a seccomp filter. + +.TP +.B * +PowerPC glibc will not return a negative number when the +.B getpid() +syscall is invoked. If a seccomp filter has been created where +.B getpid() +will return a negative number from the kernel, then PowerPC glibc will +return the absolute value of the errno. In this case, it is very difficult +for an application to distinguish between the errno and a valid pid. + +.\" ////////////////////////////////////////////////////////////////////////// .SH AUTHOR .\" ////////////////////////////////////////////////////////////////////////// Paul Moore <paul@paul-moore.com> |