diff options
Diffstat (limited to 'usr/src/man/man3m')
-rw-r--r-- | usr/src/man/man3m/fex_set_log.3m | 23 | ||||
-rw-r--r-- | usr/src/man/man3m/modf.3m | 17 |
2 files changed, 7 insertions, 33 deletions
diff --git a/usr/src/man/man3m/fex_set_log.3m b/usr/src/man/man3m/fex_set_log.3m index 13f774228f..80ff310d3d 100644 --- a/usr/src/man/man3m/fex_set_log.3m +++ b/usr/src/man/man3m/fex_set_log.3m @@ -3,12 +3,11 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH FEX_SET_LOG 3M "Jul 12, 2006" "SunOS 5.11" "Mathematical Library Functions" +.TH FEX_SET_LOG 3M "June 20, 2021" "SunOS 5.11" "Mathematical Library Functions" .SH NAME fex_set_log, fex_get_log, fex_set_log_depth, fex_get_log_depth, fex_log_entry \- log retrospective diagnostics for floating point exceptions .SH SYNOPSIS -.LP .nf c99 [ \fIflag\fR... ] \fIfile\fR... -lm [ \fIlibrary\fR... ] #include <fenv.h> @@ -37,8 +36,6 @@ c99 [ \fIflag\fR... ] \fIfile\fR... -lm [ \fIlibrary\fR... ] .fi .SH DESCRIPTION -.sp -.LP The \fBfex_set_log()\fR function enables logging of retrospective diagnostic messages regarding floating point exceptions to the file specified by \fIfp\fR. If \fIfp\fR is \fINULL\fR, logging is disabled. When a program starts, logging @@ -47,7 +44,7 @@ is initially disabled. .LP The occurrence of any of the twelve exceptions listed in \fBfex_set_handling\fR(3M) constitutes an event that can be logged. To prevent -the log from becoming exhorbitantly long, the logging mechanism eliminates +the log from becoming exorbitantly long, the logging mechanism eliminates redundant entries by two methods. First, each exception is associated with a \fIsite\fR in the program. The site is identified by the address of the instruction that caused the exception together with a stack trace. Only the @@ -81,12 +78,12 @@ stack trace are followed by the names of the corresponding symbols. The \fBfex_get_log()\fR function returns the current log file. .sp .LP -The \fBfex_set_log_depth()\fR sets the maximum depth of the stack trace +The \fBfex_set_log_depth()\fR function sets the maximum depth of the stack trace recorded with each exception to \fIdepth\fR stack frames. The default depth is 100. .sp .LP -The\fBfex_get_log_depth()\fR function returns the current maximum stack trace +The \fBfex_get_log_depth()\fR function returns the current maximum stack trace depth. .sp .LP @@ -98,15 +95,11 @@ requested from a given site will be logged. For the purpose of a user-supplied entry, the site is defined only by the stack trace, which begins with the function that called \fBfex_log_entry()\fR. .SH RETURN VALUES -.sp -.LP The \fBfex_set_log()\fR function returns a non-zero value if logging is enabled or disabled accordingly and returns 0 otherwise. The \fBfex_set_log_depth()\fR returns a non-zero value if the requested stack trace depth is established (regardless of whether logging is enabled) and returns 0 otherwise. .SH EXAMPLES -.sp -.LP The following example demonstrates the output generated when a floating point overflow occurs in \fBsscanf\fR(3C). .sp @@ -156,8 +149,6 @@ n, nonstop mode Recompiling the program or running it on another system can produce different text addresses from those shown above. .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -174,16 +165,12 @@ MT-Level MT-Safe (see NOTES) .TE .SH SEE ALSO -.sp -.LP \fBfeclearexcept\fR(3M), \fBfegetenv\fR(3M), \fBferaiseexcept\fR(3M), \fBfeupdateenv\fR(3M), \fBfex_set_handling\fR(3M), \fBattributes\fR(5) .sp .LP \fINumerical Computation Guide\fR .SH NOTES -.sp -.LP All threads in a process share the same log file. Each call to \fBfex_set_log()\fR preempts the previous one. .sp @@ -192,7 +179,7 @@ In addition to the log file itself, two additional file descriptors are used during the creation of a log entry in order to obtain symbol names from the executable and any shared objects it uses. These file descriptors are relinquished once the log entry is written. If the file descriptors cannot be -allocated, symbols names are omitted from the stack trace. +allocated, symbol names are omitted from the stack trace. .sp .LP The functions described on this page automatically install and deinstall diff --git a/usr/src/man/man3m/modf.3m b/usr/src/man/man3m/modf.3m index 6cf1b7a46e..3a830d64e6 100644 --- a/usr/src/man/man3m/modf.3m +++ b/usr/src/man/man3m/modf.3m @@ -44,11 +44,10 @@ .\" Copyright (c) 2001, The IEEE and The Open Group. All Rights Reserved. .\" Portions Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved. .\" -.TH MODF 3M "Jul 12, 2006" "SunOS 5.11" "Mathematical Library Functions" +.TH MODF 3M "June 20, 2021" "SunOS 5.11" "Mathematical Library Functions" .SH NAME modf, modff, modfl \- decompose floating-point number .SH SYNOPSIS -.LP .nf c99 [ \fIflag\fR... ] \fIfile\fR... \fB-lm\fR [ \fIlibrary\fR... ] #include <math.h> @@ -67,16 +66,12 @@ c99 [ \fIflag\fR... ] \fIfile\fR... \fB-lm\fR [ \fIlibrary\fR... ] .fi .SH DESCRIPTION -.sp -.LP These functions break the argument \fIx\fR into integral and fractional parts, each of which has the same sign as the argument. It stores the integral part as a \fBdouble\fR for the \fBmodf()\fR function, a float for the \fBmodff()\fR -function, or a long double for the\fBmodfl()\fR function in the object pointed +function, or a long double for the \fBmodfl()\fR function in the object pointed to by \fIiptr\fR. .SH RETURN VALUES -.sp -.LP Upon successful completion, these functions return the signed fractional part of \fIx\fR. .sp @@ -86,12 +81,8 @@ If \fIx\fR is NaN, a NaN is returned and *\fIiptr\fR is set to NaN. .LP If \fIx\fR is \(+-Inf, \(+-0 is returned and *\fIiptr\fR is set to \(+-Inf. .SH ERRORS -.sp -.LP No errors are defined. .SH USAGE -.sp -.LP These functions compute the function result and *\fIiptr\fR such that: .sp .in +2 @@ -102,8 +93,6 @@ x == a+*iptr ; .in -2 .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -121,7 +110,5 @@ MT-Level MT-Safe .TE .SH SEE ALSO -.sp -.LP \fBfrexp\fR(3M), \fBisnan\fR(3M), \fBldexp\fR(3M), \fBattributes\fR(5), \fBstandards\fR(5) |