Print this page
11582 3SCF isn't the object-caching memory allocation library

@@ -1,17 +1,16 @@
 '\" te
-.\" Copyright 2017 Peter Tribble
+.\" Copyright 2019 Peter Tribble
 .\" Copyright 2015 Joyent, Inc.
 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved.
 .\" 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 INTRO 3 "Nov 26, 2017"
+.TH INTRO 3 "Aug 19, 2019"
 .SH NAME
 Intro, intro \- introduction to functions and libraries
 .SH DESCRIPTION
-.LP
 This section describes functions found in various Solaris libraries, other than
 those functions described in Section 2 of this manual that directly invoke UNIX
 system primitives. Function declarations can be obtained from the
 \fB#include\fR files indicated on each page. Pages are grouped by library and
 are identified by the library name (or an abbreviation of the library name)

@@ -18,11 +17,10 @@
 after the section number. Collections of related libraries are grouped into
 volumes as described below. The first volume contains pages describing the
 contents of each shared library and each header used by the functions, macros,
 and external variables described in the remaining volumes.
 .SS "Library Interfaces and Headers"
-.LP
 This volume describes the contents of each shared library and each header used
 by functions, macros, and external variables described in the remaining
 volumes.
 .sp
 .ne 2

@@ -56,11 +54,10 @@
 only one header is required. These headers are present on an application
 development system; they do have to be present on the target execution system.
 .RE
 
 .SS "Basic Library Functions"
-.LP
 The functions described in this volume are the core C library functions that
 are basic to application development.
 .sp
 .ne 2
 .na

@@ -115,11 +112,10 @@
 \fBlibmalloc\fR(3LIB), \fBlibbsdmalloc\fR(3LIB), \fBlibmapmalloc\fR(3LIB),
 \fBlibmtmalloc\fR(3LIB), and \fBlibumem\fR(3LIB).
 .RE
 
 .SS "Networking Library Functions"
-.LP
 The functions described in this volume comprise the various networking
 libraries.
 .sp
 .ne 2
 .na

@@ -311,11 +307,10 @@
 portability is not required, the sockets interfaces in \fBlibsocket\fR and
 \fBlibnsl\fR are recommended over those in \fBlibxnet\fR. Between the XTI and
 TLI APIs, the \fBXTI\fR interfaces (available with \fBlibxnet\fR) are
 recommended over the \fBTLI\fR interfaces (available with \fBlibnsl\fR).
 .SS "Curses Library Functions"
-.LP
 The functions described in this volume comprise the libraries that provide
 graphics and character screen updating capabilities.
 .sp
 .ne 2
 .na

@@ -394,11 +389,10 @@
 update activities. The X/Open Curses library conforms fully with Issue 4 of the
 X/Open Extended Curses specification. See \fBlibcurses\fR(3XCURSES).
 .RE
 
 .SS "Extended Library Functions"
-.LP
 The functions described in this volume comprise the following specialized
 libraries:
 .sp
 .ne 2
 .na

@@ -828,11 +822,11 @@
 .na
 \fB(3SCF)\fR
 .ad
 .sp .6
 .RS 4n
-These functions constitute the object-caching memory allocation library,
+These functions constitute the service configuration facility library,
 \fBlibscf\fR. This library is implemented as a shared object, \fBlibscf.so\fR,
 but is not automatically linked by the C compilation system. Specify
 \fB-lscf\fR on the \fBcc\fR command line to link with this library. See
 \fBlibscf\fR(3LIB).
 .RE

@@ -963,11 +957,10 @@
 automatically linked by the C compilation system. Specify \fB-lvolmgt\fR on the
 \fBcc\fR command line to link with this library. See \fBlibvolmgt\fR(3LIB).
 .RE
 
 .SH DEFINITIONS
-.LP
 A character is any bit pattern able to fit into a byte on the machine. In some
 international languages, however, a "character" might require more than one
 byte, and is represented in multi-bytes.
 .sp
 .LP

@@ -980,11 +973,10 @@
 value will not match that of any legitimate pointer, so many functions that
 return pointers return \fINULL\fR to indicate an error. The macro \fINULL\fR is
 defined in <\fBstdio.h\fR>. Types of the form \fBsize_t\fR are defined in the
 appropriate headers.
 .SH MULTITHREADED APPLICATIONS
-.LP
 Both POSIX threads and Solaris threads can be used within the same application.
 Their implementations are completely compatible with each other; however, only
 POSIX threads guarantee portability to other POSIX-conforming environments.
 .sp
 .LP

@@ -1044,11 +1036,10 @@
 MT-Safe interfaces are denoted in the \fBATTRIBUTES\fR section of the functions
 and libraries manual pages (see \fBattributes\fR(5)). If a manual page does not
 state explicitly that an interface is MT-Safe, the user should assume that the
 interface is unsafe.
 .SH REALTIME APPLICATIONS
-.LP
 The environment variable \fBLD_BIND_NOW\fR must be set to a non-null value to
 enable early binding. Refer to the "When Relocations are Processed" chapter in
 \fILinker and Libraries Guide\fR for additional information.
 .SH FILES
 .ne 2

@@ -1077,11 +1068,10 @@
 .RS 15n
 shared libraries
 .RE
 
 .SH ACKNOWLEDGMENTS
-.LP
 Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to
 reproduce portions of its copyrighted documentation. Original documentation
 from The Open Group can be obtained online at
 http://www.opengroup.org/bookstore/\&.
 .sp

@@ -1105,11 +1095,10 @@
 http://www.opengroup.org/unix/online.html\&.
 .sp
 .LP
 This notice shall appear on any product containing this material.
 .SH SEE ALSO
-.LP
 \fBar\fR(1), \fBld\fR(1), \fBfork\fR(2), \fBstdio\fR(3C), \fBattributes\fR(5),
 \fBstandards\fR(5)
 .sp
 .LP
 \fILinker and Libraries Guide\fR

@@ -1118,21 +1107,19 @@
 \fIPerformance Profiling Tools\fR
 .sp
 .LP
 \fIANSI C Programmer's Guide\fR
 .SH DIAGNOSTICS
-.LP
 For functions that return floating-point values, error handling varies
 according to compilation mode. Under the \fB-Xt\fR (default) option to
 \fBcc\fR, these functions return the conventional values \fB0\fR,
 \fB\(+-HUGE\fR, or \fBNaN\fR when the function is undefined for the given
 arguments or when the value is not representable. In the \fB-Xa\fR and
 \fB-Xc\fR compilation modes, \fB\(+-HUGE_VAL\fR is returned instead of
 \fB\(+-HUGE\fR\&. (\fBHUGE_VAL\fR and \fBHUGE\fR are defined in \fBmath.h\fR to
 be infinity and the largest-magnitude single-precision number, respectively.)
 .SH NOTES
-.LP
 None of the functions, external variables, or macros should be redefined in the
 user's programs. Any other name can be redefined without affecting the behavior
 of other library functions, but such redefinition might conflict with a
 declaration in an included header.
 .sp