# Copyright (C) Christopher Currie 2003. Permission to copy, use,
# modify, sell and distribute this software is granted provided this
# copyright notice appears in all copies. This software is provided
# "as is" without express or implied warranty, and with no claim as
# to its suitability for any purpose.
#| tag::doc[]
[[bbv2.reference.tools.compiler.sun]]
= Sun Studio
The `sun` module supports the
http://developers.sun.com/sunstudio/index.jsp[Sun Studio] C++ compilers
for the Solaris OS.
The module is initialized using the following syntax:
----
using sun : [version] : [c++-compile-command] : [compiler options] ;
----
This statement may be repeated several times, if you want to configure
several versions of the compiler.
If the command is not specified, B2 will search for a binary
named `CC` in `/opt/SUNWspro/bin` and in PATH.
When using this compiler on complex C++ code, such as the
http://boost.org[Boost C++ library], it is recommended to specify the
following options when initializing the `sun` module:
----
-library=stlport4 -features=tmplife -features=tmplrefstatic
----
See the http://blogs.sun.com/sga/entry/command_line_options[Sun C++
Frontend Tales] for details.
The following options can be provided, using
_`option-value syntax`_:
`cflags`::
Specifies additional compiler flags that will be used when compiling C
sources.
`cxxflags`::
Specifies additional compiler flags that will be used when compiling C++
sources.
`compileflags`::
Specifies additional compiler flags that will be used when compiling both C
and C++ sources.
`linkflags`::
Specifies additional command line options that will be passed to the linker.
Starting with Sun Studio 12, you can create 64-bit applications by using
the `address-model=64` property.
|# # end::doc[]
import property ;
import generators ;
import os ;
import toolset : flags ;
import feature ;
import type ;
import common ;
feature.extend toolset : sun ;
toolset.inherit sun : unix ;
generators.override sun.prebuilt : builtin.lib-generator ;
generators.override sun.prebuilt : builtin.prebuilt ;
generators.override sun.searched-lib-generator : searched-lib-generator ;
rule init ( version ? : command * : options * )
{
local condition = [
common.check-init-parameters sun : version $(version) ] ;
command = [ common.get-invocation-command sun : CC
: $(command) : "/opt/SUNWspro/bin" ] ;
# Even if the real compiler is not found, put CC to
# command line so that user see command line that would have being executed.
command ?= CC ;
common.handle-options sun : $(condition) : $(command) : $(options) ;
command_c = $(command[1--2]) $(command[-1]:B=cc) ;
toolset.flags sun CONFIG_C_COMMAND $(condition) : $(command_c) ;
}
# Declare generators
generators.register-c-compiler sun.compile.c : C : OBJ : sun ;
generators.register-c-compiler sun.compile.c++ : CPP : OBJ : sun ;
# Declare flags and actions for compilation
flags sun.compile OPTIONS on : -g ;
flags sun.compile OPTIONS on : -xprofile=tcov ;
flags sun.compile OPTIONS speed : -xO4 ;
flags sun.compile OPTIONS space : -xO2 -xspace ;
flags sun.compile OPTIONS multi : -mt ;
flags sun.compile OPTIONS off : -erroff ;
flags sun.compile OPTIONS on : -erroff=%none ;
flags sun.compile OPTIONS all : -erroff=%none ;
flags sun.compile OPTIONS extra : -erroff=%none ;
flags sun.compile OPTIONS pedantic : -erroff=%none ;
flags sun.compile OPTIONS on : -errwarn ;
flags sun.compile OPTIONS hidden : -xldscope=hidden ;
flags sun.compile OPTIONS protected : -xldscope=symbolic ;
flags sun.compile OPTIONS global : -xldscope=global ;
flags sun.compile.c++ OPTIONS off : +d ;
# There are no less than 5 standard library options:
# 1) The default, which uses an old version of the Rogue Wave std lib,
# also available via -std=sun03.
# 2) C++03 mode + STLport, selected via the -library option.
# 3) C++03 mode plus the Apache std lib, selected via the -library option.
# 4) C++03 or C++11 in g++ compatibility mode, and GNU libstdc++3, selected via -std=c++03/11.
#
# Note that the -std, -library and -compat compiler switches appear to be largely mutually
# incompatible, and that going forward the -std switch seems to be the preferred one.
#
# See http://docs.oracle.com/cd/E37069_01/html/E37075/bkamw.html#OSSCPgnaof
#
flags sun.compile.c++ OPTIONS sun-stlport : -library=stlport4 -compat=5 -features=zla ;
flags sun.link OPTIONS sun-stlport : -library=stlport4 -compat=5 ;
flags sun.compile.c++ OPTIONS apache : -library=stdcxx4 -compat=5 -features=zla ;
flags sun.link OPTIONS apache : -library=stdcxx4 -compat=5 ;
flags sun.compile.c++ OPTIONS gnu : -std=c++03 ;
flags sun.compile.c++ DEFINES gnu : _GLIBCXX_USE_CXX11_ABI=0 ;
flags sun.link OPTIONS gnu : -std=c++03 ;
flags sun.compile.c++ OPTIONS gnu11 : -std=c++11 ;
flags sun.compile.c++ DEFINES gnu11 : _GLIBCXX_USE_CXX11_ABI=1 ;
flags sun.link OPTIONS gnu11 : -std=c++11 ;
# The -m32 and -m64 options are supported starting
# with Sun Studio 12. On earlier compilers, the
# 'address-model' feature is not supported and should not
# be used. Instead, use -xarch=generic64 command line
# option.
# See http://svn.boost.org/trac/boost/ticket/1186
# for details.
flags sun OPTIONS 32 : -m32 ;
flags sun OPTIONS 64 : -m64 ;
# On sparc, there's a difference between -Kpic
# and -KPIC. The first is slightly more efficient,
# but has the limits on the size of GOT table.
# For minimal fuss on user side, we use -KPIC here.
# See http://svn.boost.org/trac/boost/ticket/1186#comment:6
# for detailed explanation.
flags sun OPTIONS shared : -KPIC ;
flags sun.compile OPTIONS ;
flags sun.compile.c++ OPTIONS ;
flags sun.compile DEFINES ;
flags sun.compile INCLUDES ;
actions compile.c
{
"$(CONFIG_C_COMMAND)" $(OPTIONS) -D$(DEFINES) -I"$(INCLUDES)" -c -o "$(<)" "$(>)"
}
actions compile.c++
{
"$(CONFIG_COMMAND)" $(OPTIONS) -D$(DEFINES) -I"$(INCLUDES)" -c -o "$(<)" "$(>)"
}
# Declare flags and actions for linking
flags sun.link OPTIONS on : -g ;
# Strip the binary when no debugging is needed
flags sun.link OPTIONS off : -s ;
flags sun.link OPTIONS on : -xprofile=tcov ;
flags sun.link OPTIONS multi : -mt ;
flags sun.link OPTIONS ;
flags sun.link LINKPATH ;
flags sun.link FINDLIBS-ST ;
flags sun.link FINDLIBS-SA ;
flags sun.link LIBRARIES ;
flags sun.link LINK-RUNTIME static : static ;
flags sun.link LINK-RUNTIME shared : dynamic ;
flags sun.link RPATH ;
# On gcc, there are separate options for dll path at runtime and
# link time. On Solaris, there's only one: -R, so we have to use
# it, even though it's bad idea.
flags sun.link RPATH ;
# The POSIX real-time library is always needed (nanosleep, clock_gettime etc.)
flags sun.link FINDLIBS-SA : rt ;
rule link ( targets * : sources * : properties * )
{
SPACE on $(targets) = " " ;
}
actions link bind LIBRARIES
{
"$(CONFIG_COMMAND)" $(OPTIONS) -L"$(LINKPATH)" -R"$(RPATH)" -o "$(<)" "$(>)" "$(LIBRARIES)" -Bdynamic -l$(FINDLIBS-SA) -Bstatic -l$(FINDLIBS-ST) -B$(LINK-RUNTIME)
}
# Slight mods for dlls
rule link.dll ( targets * : sources * : properties * )
{
SPACE on $(targets) = " " ;
}
actions link.dll bind LIBRARIES
{
"$(CONFIG_COMMAND)" $(OPTIONS) -L"$(LINKPATH)" -R"$(RPATH)" -o "$(<)" -h$(<[1]:D=) -G "$(>)" "$(LIBRARIES)" -Bdynamic -l$(FINDLIBS-SA) -Bstatic -l$(FINDLIBS-ST) -B$(LINK-RUNTIME)
}
# Declare action for creating static libraries
actions piecemeal archive
{
"$(CONFIG_COMMAND)" -xar -o "$(<)" "$(>)"
}