The Sun Studio 12 Update 1 Release Notes contain last-minute installation details and other information about the software.

Information in this document updates and extends information in the component readme files.

You can access the readme files on the Sun Developer Network (SDN) Sun Studio portal at http://developers.sun.com/sunstudio/documentation/ss12u1.

Contents 

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

A. System Requirements

The Sun Studio 12 Update 1 software can be installed on the Solaris^TM 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.

To check or add swap space, see the instructions in Appendix B of the Sun Studio 12 Update 1 Installation Guide.

B. Disk Space Requirements

The suggested available disk space you need to install the Sun Studio 12 Update 1 software on the Solaris OS on SPARC platforms is 1.35 GBytes. The suggested available disk space you need to install the Sun Studio 12 Update 1 software on the Solaris OS on x86 platforms is 926 MBytes. The suggested available disk space you need to install the Sun Studio 12 Update 1 software on the Linux OS is 633 MBytes. The following table shows the size of the installed Sun Studio 12 Update 1 software.

C. Patches

This section lists the required patches for this Sun Studio 12 Update 1 release.

Operating System Patches

Operating system (OS) patches are provided for Sun Studio 12 Update 1 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 Sun Studio 12 Update 1 release. You can install these patches with the install_patches.sh utility that is included when you download the installer. For more information, see Sun Studio 12 Update 1 Installation Guide.

The following Kernel patches are recommended to resolve specific issues that might or might not affect your use of the Sun Studio 12 Update 1 software. These patches are not provided with the Sun Studio 12 Update 1 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.

D. Installation Information

This section describes known installation issues for this Sun Studio 12 Update 1 release.

Installing the Sun Studio 12 Update 1 Software

To install the Sun Studio 12 Update 1 software on a system running the Solaris 10 OS or a Linux OS that uses RPMs, you can use the Sun Studio 12 Update 1 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 in the default installation directory. For complete instructions, see the Sun Studio 12 Update 1 Installation Guide.

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 installer.

To install the software on a system running the OpenSolaris OS, see the Sun Studio Software in the OpenSolaris Repositories page.

Determining Which Installer You Have

Before running the package installer, it is important to know which version of the installer you have. The English-only version of the installer installs the English-only release of the Sun Studio 12 Update 1 software. The multi-language version installs the multi-language release of the software. The two versions provide slightly different options, so be sure that you know which one you have before you start it from the command line.

To determine which installer you have, in the directory that contains the installer, type:

./SunStudio12u1-OS-platform-packages.sh --help

If you have the multi-language installer, the first line of the help output is:

Sun Studio 12 Update 1 multi-language installer

If you have the English-only installer, the line above is not included in the help output.

Installing in the Global Zone With Access from Local Zones

If you install the software in the global zone and want to be able to run the IDE from non-global zones, you must copy the /installation_directory/netbeans directory from the global zone to each non-global zone.

Uninstalling the Sun Studio 12 Update 1 Software

If you want to uninstall an installation of the Sun Studio 12 Update 1 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 Sun Studio 12 Update 1 Installation Guide.

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 Sun Studio 12 Update 1 package installer is placed at the following locations:

Sun Studio 12 Update 1 software	[/alternate_root]/installation_directory/sunstudio12.1/*
NetBeans 6.5.1 IDE and NetBeans C/C++ Plugin 6.5.1	[/alternate_root]/installation-directory/sunstudio12.1/netbeans

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

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/SS12u1, and do not override the default installation directory path /opt. The effective installation directory path is:

  /export/home/SS12u1/opt
  

• On a Solaris system, you specify the installation directory /opt/myss12/, with no alternate root directory, and request that the Sun Studio 12 Update 1 software and NetBeans IDE software be installed. This installation creates the following directories:

  /opt/myss12/sunstudio12.1
  /opt/myss12/sunstudio12.1/netbeans
  

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

  /opt/sun/sunstudio12.1
  /opt/sun/sunstudio12.1/netbeans
  

Restrictions on Multiple Sun Studio Installations

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

• Each release (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 Sun Studio software in a different installation directory.
• If you have installed one or more components of Sun Studio 12 Update 1 software, any future installations of Sun Studio 12 Update 1 components will be installed in the same directory.
• If you have installed one or more components of the English-only release of Sun Studio 12 Update 1 software with the English-only installer, you can install additional components for the English locale with either the English-only installer or the multi-language installer. However, before using the multi-language installer to install Sun Studio 12 Update 1 software for additional locales, you must uninstall all English-only Sun Studio Update 1 software installed with the English-only installer.

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 Sun Studio 12 Update 1 installer does not remove previous versions of the Sun Studio software. For example, if you want to install the Sun Studio 12 Update 1 software in the same installation directory in which the Sun Studio 12 software is installed, you must explicitly uninstall the Sun Studio 12 software.

To uninstall a previous release of Sun 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 Sun 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 Sun Studio 12 Update 1 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 Sun Studio 12 Update 1 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 Sun Studio man pages, use the -M path> option in the man command. For example:

  man -M /opt/sunstudio12.1/man exp2
  

• deprecated binaries

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

Installing Sun Studio 12 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, or Sun Studio 12 software installed, be sure to follow the installation instructions and install the Sun Studio 12 software in a different directory.

E. Third-Party Software Information

Sun Studio 12 Update 1 software includes third-party technologies governed by the Sun Studio 12 Update 1 THIRDPARTYLICENSEREADME (http://developers.sun.com/sunstudio/documentation/ss12u1/THIRDPARTYLICENSEREADME.txt) and the NetBeans IDE 6.5.1 THIRDPARTYLICENSEREADME (http://developers.sun.com/sunstudio/documentation/ss12u1/NetBeans651_THIRDPARTYLICENSEREADME.txt). For information on the location of the third-party source code that we provide, see the Sun Studio 12 Update 1 Legal Information page (http://developers.sun.com/sunstudio/documentation/ss12u1/legal.html).

F. Features That Have Been Removed in This Release

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

gvim

gvim is an advanced and configurable tool built to enable efficient text editing. It is an improved version of vi. In the Sun Studio 8 through Sun Studio 11 releases, gvim is integrated with the IDE as an optional editor. In the Sun Studio 12 release, gvim is a stand-alone component.

The gvim editor will not be supported in this release or future releases of Sun Studio software. Developers using the Solaris OS can obtain gvim from the Solaris companion CD or from the »Open Source Software for Solaris web site. Developers on both the Solaris OS and Linux OS can obtain vim directly from the »vim open source community.

XEmacs

XEmacs is an advanced and highly customizable open source text editor and application development environment. XEmacs is a graphical tool that is often used as an IDE. In the Sun Studio 8 through Sun Studio 11 releases, XEmacs is integrated tightly with the IDE. In the Sun Studio 12 release, XEmacs is a stand-alone component.

The XEmacs editor will not be supported in this release or future releases of Sun Studio software. Developers using the Solaris OS can obtain XEmacs from the Solaris companion CD or from the »Open Source Software for Solaris web site. Developers on both the Solaris OS and Linux OS can obtain XEmacs directly from the »XEmacs open source community.

X-Designer

X-Designer is an interactive tool for creating Motif-based graphical user interfaces. It provides facilities to design user interfaces, edit layout, and create custom icons. X-Designer creates portable code that can be compiled to run on both the Solaris OS and the Linux OS. In the Sun Studio 8 through Sun Studio 11 releases, X-Designer was loosely integrated with the IDE and could be called from an IDE menu. The tool is bundled with the Sun Studio 12 software and is not callable from the IDE.

X-Designer will not be supported in this release or future releases of Sun Studio software. Developers might be able to obtain the tool and contract for support directly from »Imperial Software Technology, Inc. (IST).

G. Features That Might Be Removed in a Future Release

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

tools.h++ Library

Tools.h++ is a C++ foundation class library. Sun Studio 12 Update 1 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.

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.

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 default directory for a standard installation of libm9x is /Sun_Studio_installation_directory/lib/lib9mx.so.

libmvec provides routines that evaluate common mathematical functions for an entire vector of arguments. The default directories for a standard installation of libmvec are /Sun_Studio_installation_directory/lib/libmvec.a and /Sun_Studio_installation_directory/lib/libmvec_mt.a. libmvec_mt.a provides parallel versions of the vector functions that rely on multiprocessor parallelization.

H. Documentation Information

This section gives information about the documentation for this Sun Studio 12 Update 1 release. Information in these release notes supersedes information in any of the other documentation.

Documentation Included With the Sun Studio 12 Update 1 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 and DLight. Online help for the Performance Analyzer is available through the Help menu in the Performance Analyzer GUI.
• Readmes. These documents describe the new features, performance enhancements, problems and workarounds, and software corrections in the Sun Studio 12 Update 1 release. The release notes might contain additional information on problems and workarounds.

  You can access these documents in HTML through the documentation index page at http://developers.sun.com/sunstudio/documentation/ss12u1.

• 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 in HTML through the documentation index page at http://developers.sun.com/sunstudio/documentation/ss12u1.

• Sun Studio 12 Update 1 manuals.

  You can access the Sun Studio 12 Update 1 manuals in PDF format or HTML format on docs.sun.com through the documentation index page at http://developers.sun.com/sunstudio/documentation/ss12u1

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 © 2009 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.

U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements. Use is subject to license terms.

This distribution may include materials developed by third parties.Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and in other countries, exclusively licensed through X/Open Company, Ltd.