diff --git a/man2/prctl.2 b/man2/prctl.2 index ae1fbc5fe..954641c12 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -263,6 +263,98 @@ or Return the endian-ness of the calling process, in the location pointed to by .IR "(int\ *) arg2" . +.\" 9791554b45a2acc28247f66a5fd5bbc212a6b8c8 +.TP +.BR PR_SET_FP_MODE " (since Linux 4.0, only on MIPS)" +On MIPS, user land code can be built using ABI which permits linking with a code +with a more restrictive floating point requirements. For example, user land +code may be built to target the O32 FPXX ABI and linked with code built for +either one of the more restrictive FP32 or FP64. When more restrictive code is +linked in, the overall requirement for the process is to use this more +restrictive floating point mode. Since kernel has no means of knowing in advance +which mode process should be executed in, and having possibility that these +restrictions can be changed during the process' lifetime, the ability to control +it from the user space via this option is provided. + +.\" https://dmz-portal.mips.com/wiki/MIPS_O32_ABI_-_FR0_and_FR1_Interlinking +The +.I (unsigned int) arg2 +argument is a bit mask describing floating point mode used: +.RS +.TP +.BR PR_FP_MODE_FR " = " "(1 << 0)" +When this bit is +.I unset +(so called +.BR FR=0 " or " FR0 +mode), 32 FP registers are 32-bit wide, and 64-bit registers are represented as +pair of registers (even- and odd- numbered, with even-numbered register +containing lower 32 bits, and odd-numbered register containing higher 32 bits). +When this bit is +.I set +(on supported hardware), 32 FP registers are 64-bit wide (so called +.BR FR=1 " or " FR1 +mode). Note that modern MIPS implementations (MIPS R6 and newer) support +.B FR=1 +mode only. + +Applications that use O32 FP32 ABI can operate only when this bit is +.I unset +.RB ( FR=0 ; +or they can be used with FRE enabled, see below). +Applications that use O32 FP64 ABI (and O32 FP64A ABI, which exists for +providing ability to operate with existing FP32 code; see below) can operate +only when this bit is +.I set +.RB ( FR=1 ). +Applications that use O32 FPXX ABI can operate in both cases. +.TP +.BR PR_FP_MODE_FRE " = " "(1 << 1)" +Compatibility with 32-bit FP mode. When this mode is enabled, it emulates 32-bit +FP operations by raising reserved instruction exception on every instruction +that uses 32-bit formats and kernel then handles the instruction in software +(the problem lies in discrepancy of handling odd-numbered registers which are +high 32 bits of 64-bit registers with even numbers in +.B FR=0 +mode and lower 32-bit parts of odd-numbered 64-bit registers in +.B FR=1 +mode). Enabling of this bit is needed when code with O32 FP32 ABI should operate +with code with compatible O32 FPXX or O32 FP64A ABIs (which require +.B FR=1 +FPU mode) or when it is executed on newer hardware (MIPS R6 onwards) which lacks +.B FR=0 +mode support when binary with FP32 ABI is used. +.IP +Note that this mode only makes sense when FPU is in 64-bit mode +.RB ( FR=1 .) +.IP +Note that usage of emulation inherently has a significant performance hit and +should be avoided if possible. +.RE +.IP +Note that for N32/N64 ABI is a different story and does not need FPU emulation +and always operates in +.B FR=1 +mode. +.IP +This option is mainly intended for use by dynamic loader, but may be of use by +applications in case library loading during runtime (via +.BR dlopen (3), +for example) is used. +.IP +Arguments +.IR arg3 ", " arg4 " and " arg5 +are ignored. +.TP +.BR PR_GET_FP_MODE " (since Linux 4.0, only on MIPS)" +Get current floating point mode (see description for +.B PR_SET_FP_MODE +for details). + +Call returns bit mask which represents current FP mode in case of success. +Arguments +.IR arg2 ", " arg3 ", " arg4 " and " arg5 +are ignored. .TP .BR PR_SET_FPEMU " (since Linux 2.4.18, 2.5.9, only on ia64)" Set floating-point emulation control bits to \fIarg2\fP. @@ -1285,6 +1377,14 @@ or and the kernel or the CPU does not support MPX management. Check that the kernel and processor have MPX support. .TP +.B EOPNOTSUPP +.I option +is +.B PR_SET_FP_MODE +and +.I arg2 +has invalid or unsupported value. +.TP .B EPERM .I option is