The Oracle Solaris Studio 12.2 Release Notes contain last-minute installation details and other information about the software.

Contents 

1. System Requirements
2. Disk Space Requirements
3. Patches
4. Installation Information
5. Third-Party Software Information
6. Usage Data to Oracle
7. Features That Have Been Removed in This Release
8. Features That Might Be Removed in Future Releases
9. Documentation Information

A. System Requirements

The Oracle Solaris Studio 12.2 software can be installed on the Solaris 10 Operating System (Solaris OS) on SPARC® based systems, the Solaris 10 OS on x86 based systems, and the Linux operating system. The system requirements are as follows.

Java SE Development Kit (JDK) 6 Update 13 or later is required to run the IDE, dbxtool, DLight, and Performance Analyzer. If you plan to use these tools and do not have the required JDK, you can download the JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html

To check or add swap space, see the instructions in Appendix B of the Oracle Solaris Studio 12.2 Installation Guide at http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/index.html.

B. Disk Space Requirements

The suggested available disk space you need to install Oracle Solaris Studio 12.2 software on the Solaris OS on SPARC platforms is 1.8 GBytes. The suggested available disk space you need to install the Oracle Solaris Studio 12.2 software on the Solaris OS on x86 platforms is 1.5 GBytes. The suggested available disk space you need to install the Oracle Solaris Studio 12.2 software on the Linux OS is 1 GByte. The following table shows the size of the installed Oracle Solaris Studio 12.2 software.

	Approximate Disk Space You Need in Megabytes
If You Install These Components	Solaris OS on SPARC based systems	Solaris OS on x86 based systems	Linux OS
All Components	1431	1159	1146
C & C++ Compilers and Support Files	401	351	180
IDE and dbx Debugger	199	207	193
Sun Performance Library, Fortran Compiler and Support Files	324	353	349

C. Patches

This section lists the required patches for this Oracle Solaris Studio 12.2 release.

Operating System Patches

Operating system (OS) patches are provided for Oracle Solaris Studio 12.2 software. These patches are required for the proper operation of the compilers and tools in this release.

The following required Solaris OS patches are included in this Oracle Solaris Studio 12.2 release. You can install these patches with the install_patches.sh utility that is included when you download the installer. For more information, see the Oracle Solaris Studio 12.2 Installation Guide at http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/index.html.

SPARC based systems Patch Number	x86 based systems Patch Number
SUNWlibC
119963-20	119964-20
libmtsk
120753-08	120754-08
Assembler
118683-05	119961-07

The following Kernel patches are recommended to resolve specific issues that might or might not affect your use of the Oracle Solaris Studio 12.2 software. These patches are not provided with the Oracle Solaris Studio 12.2 software and are not installed by the install_patches.sh utility. You can download these patches from SunSolve (http://sunsolve.sun.com). Before installing a Kernel patch, read the README file included with the patch for important information on risks and proper procedure.

SPARC based systems Patch Number	x86 based systems Patch Number
Kernel
127127-11 This patch is required on systems running Solaris 10 OS releases earlier than the Solaris 10 08/07 release in order for compiler annotations (-xannotate=yes) to work.	127128-11 This patch is required on systems running Solaris 10 OS releases earlier than the Solaris 10 08/07 release in order for compiler annotations (-xannotate=yes) to work.
N/A	137138-01 This patch is required on system running Solaris 10 OS releases earlier than the Solaris 10 10/08 release on which patch 127112 or 127128 has been installed in order to use the dbx debugger to debug applications that use signal handling.

D. Installation Information

This section describes known installation issues for this Oracle Solaris Studio 12.2 release.

Installing the Oracle Solaris Studio 12.2 Software

To install the Oracle Solaris Studio 12.2 software on a system running the Solaris 10 OS or a Linux OS that uses RPMs, you can use the Oracle Solaris Studio 12.2 package installer. The package installer requires that you have root privileges on the system where you are installing the software. The graphical user interface (GUI) installer lets you choose the installation directory and which components of the software you want to install. The non-GUI installer installs all of the components of the software. You can install the runtime libraries only by starting either the GUI or non-GUI installer with the --libraries-only option. For complete instructions, see the Oracle Solaris Studio 12.2 Installation Guide at http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/index.html.

To install the software on a system on which you do not have root privileges or on a system running a Linux OS that does not use RPMs, you can use the tarfile.

Uninstalling the Oracle Solaris Studio 12.2 Software

If you want to uninstall an installation of the Oracle Solaris Studio 12.2 software that was done with the package installer, use the provided uninstaller, rather than attempting to uninstall the software manually. The use of the uninstaller is described in Chapter 3 of the Oracle Solaris Studio 12.2 Installation Guide at http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/index.html.

If you experience difficulties using the uninstaller, and cannot successfully uninstall the software using it, a safe procedure for uninstalling manually is described in Chapter 4 of the Installation Guide.

Installation Directory

Software installed by the Oracle Solaris Studio 12.2 package installer is placed at the following locations:

Oracle Solaris Studio 12.2 software	[/alternate_root]/installation_directory/solstudio12.2/*
NetBeans 6.9 IDE and NetBeans C/C++ Plugin 6.9	[/alternate_root]/installation-directory/solstudio12.2/netbeans

On Solaris platforms, the default installation_directory is /opt. On Linux platforms, the default installation_directory is /opt/oracle.

If you specified an alternate root directory, the full path to the actual installation directory is constructed by concatenating the alternate root path followed by the installation directory path.

For example:

• On a Solaris system, you specify an alternate root path of /export/home/OSS12.2, and do not override the default installation directory path /opt. The effective installation directory path is:

  /export/home/OSS12.2/opt
  

• On a Solaris system, you specify the installation directory /opt/myoss12.2/, with no alternate root directory, and request that the Oracle Solaris Studio 12.2 software and NetBeans IDE software be installed. This installation creates the following directories:

  /opt/myoss12.2/solstudio12.2
  /opt/myoss12.2/solstudio12.2/netbeans
  

• On a Linux system, you do not specify an installation directory (leaving the default /opt/oracle), nor an alternate root directory, and request that the Oracle Solaris Studio 12.2 software and NetBeans IDE software be installed. This installation creates the following directories:

  /opt/oracle/solstudio12.2
  /opt/oracle/solstudio12.2/netbeans
  

Restrictions on Multiple Oracle Solaris Studio Installations

You can have several installations of Oracle Solaris Studio software on the same system with the following restrictions:

• Each release (Oracle Solaris Studio 12.2 software, Sun Studio 12 Update 1 software, Sun Studio 12 software, Sun Studio 11 software, etc.) can be installed only once on a given system.
• You must install each release of Studio software in a different installation directory.
• If you have installed one or more components of Oracle Solaris Studio 12.2 software, any future installations of Oracle Solaris Studio 12.2 components will be installed in the same directory.

Installer Features Not Available on Linux Platforms

The following installer features are not available on Linux:

• Installation in zones
• Adding symbolic links to /usr/bin and /usr/share/man

Uninstalling Previous Versions of Sun Studio Software

The Oracle Solaris Studio 12.2 installer does not remove previous versions of Studio software. For example, if you want to install the Oracle Solaris Studio 12.2 software in the same installation directory in which the Sun Studio 12 Update 1 software is installed, you must explicitly uninstall the Sun Studio 12 Update 1 software.

To uninstall a previous release of the Studio software, refer to the installation documentation for that release.

Effects of /usr/bin and /usr/share/man Symbolic Links, and Workarounds for Missing Links

When the installer creates symbolic links in the /usr/bin and /usr/share/man directories, it does not create links to certain binaries and man page sections. Here are the links that are not created and workarounds for accessing the unlinked binaries and man pages:

• man page sections unique to Studio software

  Symbolic links to /usr/share/man/man3c++/* are not created. The man pages displayed for the sections in this directory do not contain up-to-date information. The man command does not by default search the following Oracle Solaris Studio 12.2 man page sections:

  man3cc4
  man3f
  man3p
  man3pi
  man3x
  

  To see an up-to-date man page in any of these sections, use the -s option of the man command to specify the section. For example:

  man -s 3x rtc_api
  

• man page conflicts

  Some Oracle Solaris Studio 12.2 man pages conflict with existing Solaris OS man pages. Symbolic links for the following man pages are not created; links to the Solaris versions are preserved.

  /usr/share/man/man1 symlinks not created: intro.1, ctags.1
  
  /usr/share/man/man3m symlinks not created: exp2.3m, feclearexcept.3m
     fegetenv.3m, fegetexceptflag.3m, fegetprec.3m, fegetround.3m,
     feholdexcept.3m, feraiseexcept.3m, fesetenv.3m, fesetexceptflag.3m,
     fesetprec.3m, fesetround.3m, fetestexcept.3m, feupdateenv.3m,
     fex_get_handling.3m, fex_get_log.3m, fex_get_log_depth.3m,
     fex_getexcepthandler.3m, fex_log_entry.3m, fex_merge_flags.3m'
     fex_set_handling.3m, fex_set_log.3m, fex_set_log_depth.3m,
     fex_setexcepthandler.3m, isinf.3m, isnormal.3m, log2.3m,
     signbit.3m, sincos.3m
  

  To access these Studio man pages, use the -M path> option in the man command. For example:

  man -M /opt/solstudio12.2/man exp2
  

• deprecated binaries

  /usr/bin/ptclean symlink is not created.
  /usr/share/man/man1/ptclean.1 symlink is not created. 
  

Installing Oracle Solaris Studio 12.2 Software in a Different Directory

If you have Forte Developer 6 software, Sun ONE Studio 7 software, Sun ONE Studio 8 software, Sun Studio 8 software, Sun Studio 9 software, Sun Studio 10 software, Sun Studio 11 software, Sun Studio 12 software, or Sun Studio 12 Update 1 software installed, be sure to follow the installation instructions and install the Oracle Solaris Studio 12.2 software in a different directory.

Extracting Installation Data Might Fail With No Error Message

Running the non-GUI installer with the --extract-installation-data option can fail with no user-readable error message.

E. Third-Party Software Information

Oracle Solaris Studio 12.2 software includes third-party technologies governed by the Oracle Solaris Studio 12.2 THIRDPARTYLICENSEREADME (http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/default-169691.html) and the NetBeans IDE 6.9 THIRDPARTYLICENSEREADME (http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/oss-netbeans-license-169692.html). For additional legal details, including information on distributable libraries, see the Oracle Solaris Studio 12.2 Legal page (http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/oss-122-docs-169726.html).

F. Usage Data to Oracle

The Usage Data to Oracle feature periodically sends information on your usage of Oracle Solaris Studio components to Oracle Corporation. The information consists of the product version, the platform you are running it on, and a list of the components you used with their usage counts. This information is used by Oracle Corporation to improve future Oracle Solaris Studio software releases. This information is anonymous and cannot be associated to any individual or organization.

However, if you wish to disable Usage Data to Oracle, set the SUNW_NO_UPDATE_NOTIFY environment variable to any value other than false.

G. Features That Have Been Removed in This Release

The following features have been removed in this release of the Oracle Solaris Studio software.

libm9x.so.0, libmvec.a, and libmvec_mt.a

The libm9x math library contains some of the math and floating-point related functions specified in C99. This library contains the fenv.h Floating-Point Exceptions as well as enhancements to support improved handling of floating-point exceptions.

The contents of libm9x.so.0 are available in the system library libc.

libmvec provides routines that evaluate common mathematical functions for an entire vector of arguments. libmvec_mt.a provides parallel versions of the vector functions that rely on multiprocessor parallelization.

The contents of libmvec.a are available in the system library libmvec.so.

Interval BLAS (IBLAS) library

The Interval BLAS library (libsuniperf) was provided for users of interval arithmetic and is no longer used.

Fortran 77 Libraries

The Fortran 77 compiler is no longer supported so these libraries not needed. Full Fortran 77 compatibility is provided by the Fortran 95 libraries.

collector_thread_pause and collector_thread_resume

The collector_thread_pause() function turns off the writing of event-specific data from a particular thread to the experiment. If the experiment is already terminated, or no experiment is active, or writing of data for that thread is already turned off, the call is ignored. The function argument is the POSIX thread ID, as returned by thr_self(3THR) for Solaris^TM operating system threads and pthread_self(3THR) for POSIX threads.

The collector_thread_resume() function turns on the writing of event-specific data from a particular thread to the experiment. If the experiment is already terminated, or no experiment is active, or writing of data for that thread is already turned on, the call is ignored. The function argument is the POSIX thread ID, as returned by thr_self(3THR) for Solaris operating system threads and pthread_self(3THR) for POSIX threads.

G. Features That Might Be Removed in a Future Release

The following features might not be supported in a future release of the Oracle Solaris Studio software.

libcx

This library is now considered obsolete. The contents of libcx are available in the system library libc.

-compat=4 option in the C++ compiler

The -compat=4 option sets the C++ compiler to compatibility mode. That is, it sets language and binary compatibility to that of the 4.0.1, 4.1, and 4.2 compilers. It sets the __cplusplus preprocessor macro to 1 and the __SUNPRO_CC_COMPAT preprocessor macro to 4.

The default value for the -compat option is 5, which sets language and binary compatibility to ANSI/ISO standard mode.

Runtime Checking in the dbx Debugger

Runtime checking (RTC) lets you automatically detect runtime errors, such as memory access errors and memory leak, in a C, C++, or Fortran application during the development phase. It also lets you monitor memory usage.

Much of the data generated by runtime checking is now available through the Sun Memory Error Discovery Tool (Discover), which is included in the Oracle Solaris Studio 12.1 release.

tools.h++ Library

Tools.h++ is a C++ foundation class library. Oracle Studio 12.2 software, as well as previous releases of Sun Studio software, includes version 7.1.0 of this library. The functionality in Tools.h++ is available in the C++ Standard Library or in the BOOST libraries, but with a different programming interface (API).For information on more recent versions of Tools.h++, see the Rogue Wave software web site at http://www.roguewave.com.

-xarch=v7/v8/v8a Compiler Options

-xarch=v7: Compile for the SPARC-V7 ISA. This option is obsolete. Current Solaris operating systems no longer support the SPARC V7 architecture, and programs compiled with this option run slower on current platforms.

-xarch=v8: Compile for the SPARC-V8 ISA. Enables the compiler to generate code for good performance on the V8 architecture. This option is obsolete.

-xarch=v8a: Compile for the V8a version of the SPARC-V8 ISA. By definition, V8a means the V8 ISA, but without the fsmuld instruction. This option enables the compiler to generate code for good performance on the V8a ISA. This option is obsolete.

The current default value for the -xarch option is v8plus. This value compiles for the V8plus version of the SPARC-V9 ISA. By definition, V8plus means the V9 ISA, but limited to the 32-bit subset defined by the V8plus ISA specification, without the Visual Instruction Set (VIS), and without other implementation-specific ISA extensions.

-xdebugformat=stabs Compiler Option

-xdebugformat=stabs generates debugging information using the stabs standard format. The default format for debugger information is now the dwarf format. The stabs format is not fully supported. Programs using the -xdebugformat=stabs option might not compile, and might not work properly with the dbx debugger.

H. Documentation Information

This section gives information about the documentation for this Oracle Solaris Studio 12.2 release. Information in these release notes supersedes information in any of the other documentation.

Documentation Included With the Oracle Solaris Studio 12.2 Release

The following documentation is available with this Oracle Solaris Studio 12.2 release.

• Online help. The online help available through the Help menu in the IDE provides task-oriented information on using all of the components of the IDE. Online help for the Performance Analyzer and the Thread Analyzer is available through the Help menu in the Performance Analyzer GUI. Online help for DLight and dbxtool is available through the Help menus in these tools.
• What's New in the Oracle Solaris Studio 12.2 Release This document describes the new features, performance enhancements, problems and workarounds, and limitations in the Oracle Solaris Studio 12.2 release. The release notes might contain additional information on problems and workarounds.

  You can access this document in HTML format or PDF format through the documentation index page at http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/index.html.

• Man pages. These online reference manual pages describe user commands, libraries that are supplied with the compilers, and other types of commands. Man pages contain reference information, including command syntax, usage, and related commands.

  You can access these documents through the man command in the installed Oracle Solaris Studio 12.2 software.

• Oracle Solaris Studio 12.2 manuals and tutorials. You can access the Oracle Solaris Studio 12.2 manuals and tutorials in PDF format or HTML format through the documentation index page at http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/index.html

Documentation Requirements

To view the documentation that is available in PDF format, you need Adobe® Acrobat Reader software. To download the software, go to http://www.adobe.com/products/acrobat/readstep.html.

Copyright � 2010, Oracle and/or its affiliates. All rights reserved.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.