| Updated 2004/12/06 |
Sun[tm] Studio 10: Math Libraries Readme |
Contents
- Introduction
- About the Sun Studio Math Libraries
- New and Changed Features
- Software Corrections
- Problems and Workarounds
- Limitations and Incompatibilities
- Documentation Errors
- Shippable Libraries
A. Introduction
This document contains information about the math libraries provided with the Sun[tm] Studio compilers and tools.
This document describes the software corrections, known problems, limitations, and incompatibilities of this release.
Information in this document updates and extends information in the software manuals.
Product Documentation
- Release Notes: Available on the developer portal at http://developers.sun.com/tools/cc/documentation/ss10_docs/release_notes.html. Information in the release notes updates and extends information in all readme files.
- Sun Studio Documentation: Product man pages, HTML versions of readmes, and manuals can be accessed from /installation_directory/docs/index.html. The default installation directory is /opt/SUNWspro.
- IDE Documentation: Online help for all components of the Sun Studio IDE can be accessed from the Help menu in the IDE.
- Developer Resources Portal: For technical articles, code samples, documentation, and a knowledge base, see the developers portal at http://developers.sun.com/prodtech/cc.
Note - If your Sun Studio compilers and tools have not been installed in the default /opt directory, ask your system administrator for the equivalent path on your system.
B. About the Sun Studio Math Libraries
This release of the math libraries is available on the Solaris[tm] Operating System (Solaris OS) versions 8, 9, and 10.
For information on using the Sun Studio math libraries, see the Numerical Computation Guide or the section 3m man pages.
C. New and Changed Features
The following features were added or changed in this release.
- Features added in the Solaris 10 OS:
- All of the math and floating point environment functions required by the latest version of the C language (C99) are now available in libm in the Solaris 10 OS. Previously, float and long double math functions were available only in libsunmath and the C99 floating point environment functions were available only in libm9x.
- The vector math function library libmvec is now included in the Solaris 10 OS. This library is provided as a shared object only.
- Deprecated Libraries:
- The following libraries are provided with the Sun Studio 10 software for backward compatibility, but their use is discouraged: libcopt, libmvec (static archive), libm9x.
- libcopt is classified Obsolete and will be removed from the Sun Studio product in a future release.
- The static archive versions of libmvec are still provided for programs compiled for the Solaris 8 OS and Solaris 9 OS. Programs compiled for the Solaris 10 OS should use the shared object version of this library. The static archive libmvec might be classified Obsolete and removed in a future release.
- As noted above, the contents of libm9x have been moved into libm in the Solaris 10 OS. libm9x is still provided for programs compiled for the Solaris 8 OS and Solaris 9 OS. Programs compiled for the Solaris 10 OS should use libm. libm9x might be classified Obsolete and removed in a future release.
The following features were added or changed in the previous release.
_Complex Support. The Sun Studio C compiler includes support for the _Complex and _Imaginary floating point types introduced in C99. In the Solaris 8 OS and Solaris 9 OS, support routines for arithmetic operations on _Complex and _Imaginary types are contained in the library libcplxsupp.a. You must specify -lcplxsupp when linking a program that uses these types. In the Solaris 10 OS, the complex support routines are contained in the system library, libc, which is linked automatically by the compiler.
See the C Compiler Readme for more information about support for C99 features.
Removal of <fenv96.h>. As noted in the documentation for the previous release, the <fenv96.h> header file has been classified obsolete. The Sun Studio math libraries no longer include this header file. See the attributes(5) man page for more information about interface stability classifications.
D. Software Corrections
There is no new information at this time.
E. Problems and Workarounds
This section discusses known software problems and possible workarounds for those problems.
There is no new information at this time.
For updates or patches, check the updated information at http://developers.sun.com/prodtech/cc/support_index.html.
F. Limitations and Incompatibilities
This section discusses limitations and incompatibilities with systems or other software.
There is no new information at this time.
For last-minute information, see the release notes at http://developers.sun.com/tools/cc/documentation/ss10_docs/release_notes.html
G. Documentation Errors
Note on round-to-nearest requirements omitted.
A note has been added to the man pages libmvec(3m) and clibmvec(3m) indicating that it is the user's responsibility to ensure the default round-to-nearest mode is in effect when routines in -lmvec and -lmopt are called. The libmvec(3m) man page also includes a note on how users of the Solaris 10 OS can link to the shared-object library, libmvec.so.
H. Shippable Libraries
If your executable uses a Sun dynamic library listed in the file named below, your license includes the right to redistribute the library to your customer.
/opt/SUNWspro/READMEs/runtime.libraries
Note - If your Sun Studio compilers and tools are not installed in the /opt directory, ask your system administrator for the equivalent path on your system.
You cannot redistribute or otherwise disclose the header files, source code, object modules, or static libraries of object modules in any form.
The License to Use appears in the End User Object Code License, which you can view from the back of the plastic case containing the CD-ROM.
Copyright © 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.