aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndrew G. Morgan <morgan@kernel.org>2023-03-18 18:02:44 -0700
committerAndrew G. Morgan <morgan@kernel.org>2023-03-18 18:02:44 -0700
commit8c435a6fecece9e1c0e1625c2add7eaa546bb93c (patch)
tree5ccc222206a887ed312578fc11d136c3d4139390
parent9c084eceb21250d3ffd4cf1c368dd39f99ef4df1 (diff)
downloadlibcap-8c435a6fecece9e1c0e1625c2add7eaa546bb93c.tar.gz
Some formatting fixes for the libpsx man page.
Signed-off-by: Andrew G. Morgan <morgan@kernel.org>
-rw-r--r--doc/libpsx.334
1 files changed, 20 insertions, 14 deletions
diff --git a/doc/libpsx.3 b/doc/libpsx.3
index ef80fee..4a0b5b6 100644
--- a/doc/libpsx.3
+++ b/doc/libpsx.3
@@ -5,15 +5,17 @@ psx_syscall3, psx_syscall6, psx_set_sensitivity \- POSIX semantics for system ca
.nf
#include <sys/psx_syscall.h>
-long int psx_syscall3(long int syscall_nr, long int arg1, long int arg2, long int arg3);
-long int psx_syscall6(long int syscall_nr, long int arg1, long int arg2, long int arg3,
- long int arg4, long int arg5, long int arg6);
+long int psx_syscall3(long int syscall_nr,
+ long int arg1, long int arg2, long int arg3);
+long int psx_syscall6(long int syscall_nr,
+ long int arg1, long int arg2, long int arg3,
+ long int arg4, long int arg5, long int arg6);
int psx_set_sensitivity(psx_sensitivity_t sensitivity);
void psx_load_syscalls(long int (**syscall_fn)(long int,
- long int, long int, long int),
- long int (**syscall6_fn)(long int,
- long int, long int, long int,
- long int, long int, long int));
+ long int, long int, long int),
+ long int (**syscall6_fn)(long int,
+ long int, long int, long int,
+ long int, long int, long int));
.fi
.sp
Link with one of these:
@@ -28,7 +30,7 @@ library attempts to fill a gap left by the
.BR pthreads (7)
implementation on Linux. To be compliant POSIX threads, via the
.BR nptl "(7) " setxid
-mechanism glibc maintains consistent UID and GID credentials amongst
+mechanism, glibc maintains consistent UID and GID credentials amongst
all of the threads associated with the current process. However, other
credential state is not supported by this abstraction. To support
these extended kernel managed security attributes,
@@ -41,10 +43,12 @@ mechanism, the coordination of thread state is mediated by a realtime
signal. Whereas the
.B nptl:setxid
mechanism uses signo=33 (which is hidden by glibc below a redefined
-SIGRTMIN),
-.B libpsx
-inserts itself in the SIGSYS handler stack. It goes to great length to
-be the first such handler but acts as a pass-through for other SIGSYS
+.BR SIGRTMIN "), " libpsx
+inserts itself in the
+.B SIGSYS
+handler stack. It goes to great length to be the first such handler
+but acts as a pass-through for other
+.B SIGSYS
uses.
.PP
A linker trick of
@@ -85,13 +89,15 @@ signal.
.PP
.BR psx_load_syscalls ()
can be used to set caller defined function pointers for invoking 3 and
-6 argument syscalls. This function can be used to configure a library, or program to change behavior when linked against
+6 argument syscalls. This function can be used to configure a library,
+or program to change behavior when linked against
.BR libpsx .
Indeed,
.B libcap
uses this function from
.B libpsx
-to override its thread scoped default system call based API. When linked with
+to override its thread scoped default system call based API. When
+linked with
.BR libpsx ", " libcap
can operate on all the threads of a multithreaded program to operate
with POSIX semantics.