Updated 2009/10/20 |
Sun[tm] Studio 12 Update 1 Release Notes |
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.
The Sun Studio 12 Update 1 software can be installed on the SolarisTM 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.
Solaris OS on SPARC based systems |
Solaris OS on x86 based systems |
Linux OS | |
Operating System |
Solaris OS 10 1/06 and subsequent updates OpenSolaris 2008.11 and 2009.06 |
SuSE Linux Enterprise Server 10 RedHat Enterprise Linux 5 CentOS 5 Oracle Enterprise Linux 5.3 | |
CPU |
|
32 and 64 bit systems (Pentium class or newer) based on AMD and Intel x86 CPUs | |
Memory |
Recommended: 1 to 2 Gbyte Minimum: 512 Mbytes (more may be needed for working with large projects in the IDE) |
||
Swap Space |
Recommended: 2 to 4 Gbytes Minimum: 1 Gbyte |
||
Disk Space Usage | Disk space usage varies by platform. See Disk Space Requirements. | ||
OS Configurations | Entire Solaris Software Group, Entire Solaris Software Group Plus OEM Support, or Developer Solaris Software Group (To determine your operating system configuration, you need to verify the installed packages. Specific packages are installed for each configuration. See the Solaris OS installation documentation for details.) | Must include the Development/Libraries Package Group |
To check or add swap space, see the instructions in Appendix B of the Sun Studio 12 Update 1 Installation Guide.
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.
Approximate Disk Space You Need in Megabytes | |||
---|---|---|---|
If You Install This Component |
Solaris OS on SPARC based systems | Solaris OS on x86 based systems | Linux OS |
Sun Studio 12 Update 1 Compilers and Tools |
783 | 522 | 350 |
Sun Performance Library software |
500 | 301 | 280 |
Third-Party Source Code |
2.4 | 2.3 | 2 |
NetBeans IDE 6.5.1 |
100 | 100 | 100 |
This section lists the required patches for this Sun Studio 12 Update 1 release.
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.
SPARC based systems Patch Number | x86 based systems Patch Number | |
---|---|---|
SUNWlibC |
||
119963-13 | 119964-13 | |
libmtsk | ||
120753-06 | 120754-06 | |
Assembler | ||
118683-03 | 119961-05 |
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.
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 | 137122-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. |
This section describes known installation issues for this Sun Studio 12 Update 1 release.
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.
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 --helpIf you have the multi-language installer, the first line of the help output is:
Sun Studio 12 Update 1 multi-language installerIf you have the English-only installer, the line above is not included in the help output.
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.
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.
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
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.
The following installer features are not available on Linux:
- Installation in zones
- Adding symbolic links to /usr/bin and /usr/share/man
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.
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 man3xTo 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.3mTo access these Sun Studio man pages, use the -M path> option in the man command. For example:
man -M /opt/sunstudio12.1/man exp2deprecated binaries
/usr/bin/ptclean symlink is not created. /usr/share/man/man1/ptclean.1 symlink is not created.
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.
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).
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 ofvi
. 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 obtaingvim
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 obtainvim
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 obtainXEmacs
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 obtainXEmacs
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).
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 SolarisTM 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.
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.
You can access these documents in HTML through the documentation index page at http://developers.sun.com/sunstudio/documentation/ss12u1.
You can access these documents in HTML through the documentation index page at http://developers.sun.com/sunstudio/documentation/ss12u1.
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
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.
This product is covered and controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited.
DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Copyright © 2009 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, Etats-Unis. Tous droits r�serv�s.
L'utilisation est soumise aux termes de la Licence.
Cette distribution peut comprendre des composants d�velopp�s par des tierces parties.Des parties de ce produit pourront �tre d�riv�es des syst�mes Berkeley BSD licenci�s par l'Universit� de Californie. UNIX est une marque d�pos�e aux Etats-Unis et dans d'autres pays et licenci�e exclusivement par X/Open Company, Ltd.
Sun, Sun Microsystems, le logo Sun, Java, et JavaHelp sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.Toutes les marques SPARC sont utilis�es sous licence et sont des marques de fabrique ou des marques d�pos�es de SPARC International, Inc. aux Etats-Unis et dans d'autres pays. Les produits portant les marques SPARC sont bas�s sur une architecture d�velopp�e par Sun Microsystems, Inc.
CETTE PUBLICATION EST FOURNIE "EN L'ETAT" ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N'EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERN/ANT LA VALEUR MARCHANDE, L'APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU'ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S'APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU.