| 1 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
|---|
| 2 | |
|---|
| 3 | <html> |
|---|
| 4 | <head> |
|---|
| 5 | <meta name="generator" content= |
|---|
| 6 | "HTML Tidy for Linux/x86 (vers 1st September 2003), see www.w3.org"> |
|---|
| 7 | <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> |
|---|
| 8 | <link rel="stylesheet" type="text/css" href="../../../boost.css"> |
|---|
| 9 | |
|---|
| 10 | <title>Boost.Build - sunpro toolset</title> |
|---|
| 11 | </head> |
|---|
| 12 | |
|---|
| 13 | <body bgcolor="#FFFFFF" link="#0000FF" vlink="#800080"> |
|---|
| 14 | <table border="0" cellpadding="7" cellspacing="0" width="100%" summary= |
|---|
| 15 | "header"> |
|---|
| 16 | <tr> |
|---|
| 17 | <td valign="top" width="300"> |
|---|
| 18 | <h3><a href="http://www.boost.org"><img height="86" width="277" alt= |
|---|
| 19 | "C++ Boost" src="../../../boost.png" border="0"></a></h3> |
|---|
| 20 | </td> |
|---|
| 21 | |
|---|
| 22 | <td valign="top"> |
|---|
| 23 | <h1 align="center">Boost.Build</h1> |
|---|
| 24 | |
|---|
| 25 | <h2 align="center">sunpro toolset</h2> |
|---|
| 26 | </td> |
|---|
| 27 | </tr> |
|---|
| 28 | </table> |
|---|
| 29 | <hr> |
|---|
| 30 | |
|---|
| 31 | <h2>Introduction</h2> |
|---|
| 32 | |
|---|
| 33 | <p>Boost.Build's <code>sunpro</code> toolset supports the <a href= |
|---|
| 34 | "http://wwws.sun.com/software/sundev/suncc/index.html">Sun ONE Studio</a> |
|---|
| 35 | compiler. This compiler has been known under several trade names including |
|---|
| 36 | Sun WorkShop and Forte Developer. For convenience, this document will refer |
|---|
| 37 | to numbered releases of the compiler when differention is necessary; this |
|---|
| 38 | release number can be obtained by running <code>CC ‑V</code> at the |
|---|
| 39 | command line.</p> |
|---|
| 40 | |
|---|
| 41 | <h2>Compatibility</h2> |
|---|
| 42 | |
|---|
| 43 | <p>As of this writing (November 2003) the Sun C++ compiler has difficulty |
|---|
| 44 | building many of the libraries included with Boost. <a href= |
|---|
| 45 | "http://www.boost.org/regression/release/developer/summary.html">Complete |
|---|
| 46 | regression test information is available</a>, although absent from the |
|---|
| 47 | regression tables are some libraries that Sun C++ has particular difficulty |
|---|
| 48 | with, including <code><a href= |
|---|
| 49 | "../../../libs/mpl/doc/index.html">mpl</a></code> and <code><a href= |
|---|
| 50 | "../../../libs/spirit/index.html">spirit</a></code>.</p> |
|---|
| 51 | |
|---|
| 52 | <h3>Notes on specific versions</h3> |
|---|
| 53 | |
|---|
| 54 | <p>Best results can be obtained by being up-to-date on the most recent |
|---|
| 55 | patches for your compiler version. Information on patches is <a href= |
|---|
| 56 | "http://access1.sun.com/sundev/index.html">available from Sun |
|---|
| 57 | Microsystems.</a></p> |
|---|
| 58 | |
|---|
| 59 | <p style="text-align: center"> </p> |
|---|
| 60 | |
|---|
| 61 | <table border="1" summary="Version notes"> |
|---|
| 62 | <tr> |
|---|
| 63 | <th>Compiler Version</th> |
|---|
| 64 | |
|---|
| 65 | <th>Trade Name(s)</th> |
|---|
| 66 | |
|---|
| 67 | <th>Notes</th> |
|---|
| 68 | </tr> |
|---|
| 69 | |
|---|
| 70 | <tr> |
|---|
| 71 | <td><= 5.2</td> |
|---|
| 72 | |
|---|
| 73 | <td>Sun WorkShop 5<br> |
|---|
| 74 | Sun WorkShop 6<br> |
|---|
| 75 | Sun WorkShop 6 update 1</td> |
|---|
| 76 | |
|---|
| 77 | <td> |
|---|
| 78 | <p>No current information available. Boost is unlikely to be very |
|---|
| 79 | functional with these older releases, as they do not support some of |
|---|
| 80 | the necessary parts of the C++ language. Patches and workarounds are |
|---|
| 81 | welcome.</p> |
|---|
| 82 | </td> |
|---|
| 83 | </tr> |
|---|
| 84 | |
|---|
| 85 | <tr> |
|---|
| 86 | <td>5.3</td> |
|---|
| 87 | |
|---|
| 88 | <td>Sun WorkShop 6 update 2</td> |
|---|
| 89 | |
|---|
| 90 | <td> |
|---|
| 91 | <p>The most recent reports seem to imply that this release is |
|---|
| 92 | <a href="http://article.gmane.org/gmane.comp.lib.boost.devel/27660">“hopeless |
|---|
| 93 | for Boost”</a>, but patches and workarounds are welcome.</p> |
|---|
| 94 | </td> |
|---|
| 95 | </tr> |
|---|
| 96 | |
|---|
| 97 | <tr> |
|---|
| 98 | <td>5.4</td> |
|---|
| 99 | |
|---|
| 100 | <td>Forte Developer 7</td> |
|---|
| 101 | |
|---|
| 102 | <td> |
|---|
| 103 | <p>This version recognizes an undocumented, unsupported flag that |
|---|
| 104 | improves its success in compiling templates:</p> |
|---|
| 105 | |
|---|
| 106 | <blockquote> |
|---|
| 107 | <code>‑Qoption CC ‑xcomdat</code> |
|---|
| 108 | </blockquote> |
|---|
| 109 | |
|---|
| 110 | <p>This flag changes the template instantiation method from |
|---|
| 111 | “exported” to an improved “global” which has |
|---|
| 112 | been found to eliminate some compiler bugs regarding the |
|---|
| 113 | instantiation of template run-time type information. This option, if |
|---|
| 114 | used, is required for both compiling and linking.</p> |
|---|
| 115 | </td> |
|---|
| 116 | </tr> |
|---|
| 117 | |
|---|
| 118 | <tr> |
|---|
| 119 | <td>5.5</td> |
|---|
| 120 | |
|---|
| 121 | <td>Sun ONE Studio 8</td> |
|---|
| 122 | |
|---|
| 123 | <td> |
|---|
| 124 | <p>No current information is available. This version changes the |
|---|
| 125 | default template instantiation method from “exported” |
|---|
| 126 | (using a template repository) to “global” (storing |
|---|
| 127 | instances in object files with global linkage). The linker should |
|---|
| 128 | then automatically detect and eliminate duplicate definitions. This |
|---|
| 129 | change <i>should</i> improve template performace over previous |
|---|
| 130 | releases.</p> |
|---|
| 131 | </td> |
|---|
| 132 | </tr> |
|---|
| 133 | </table> |
|---|
| 134 | |
|---|
| 135 | <h2>Configuration Variables</h2> |
|---|
| 136 | |
|---|
| 137 | <p>The sunpro toolset responds to the following variables which can be set |
|---|
| 138 | in the environment or configured on the bjam command line using |
|---|
| 139 | <code>‑s<i>VARIABLE_NAME</i>=</code><i>value</i>:</p> |
|---|
| 140 | |
|---|
| 141 | <p style="text-align: center"> </p> |
|---|
| 142 | |
|---|
| 143 | <table border="1" summary="settings"> |
|---|
| 144 | <tr> |
|---|
| 145 | <th>Variable Name</th> |
|---|
| 146 | |
|---|
| 147 | <th>Semantics</th> |
|---|
| 148 | |
|---|
| 149 | <th>Default</th> |
|---|
| 150 | |
|---|
| 151 | <th>Notes</th> |
|---|
| 152 | </tr> |
|---|
| 153 | |
|---|
| 154 | <tr> |
|---|
| 155 | <td><code>SUNPRO_ROOT_DIRECTORY</code></td> |
|---|
| 156 | |
|---|
| 157 | <td>Path to installation directory of compiler tools.</td> |
|---|
| 158 | |
|---|
| 159 | <td>(none)</td> |
|---|
| 160 | |
|---|
| 161 | <td>Usually there is no need to set this variable at all. However, if |
|---|
| 162 | <code>CC</code> is not in the path is is usually sufficient to |
|---|
| 163 | configure this one variable. A typical value for this variable is |
|---|
| 164 | <code>/opt/SUNWspro</code>.</td> |
|---|
| 165 | </tr> |
|---|
| 166 | |
|---|
| 167 | <tr> |
|---|
| 168 | <td><code>SUNPRO_BIN_DIRECTORY</code></td> |
|---|
| 169 | |
|---|
| 170 | <td>Path to bin directory.</td> |
|---|
| 171 | |
|---|
| 172 | <td><code>$(SUNPRO_ROOT_DIRECTORY)/bin/</code></td> |
|---|
| 173 | |
|---|
| 174 | <td> </td> |
|---|
| 175 | </tr> |
|---|
| 176 | |
|---|
| 177 | <tr> |
|---|
| 178 | <td><code>SUNPRO_CXX</code></td> |
|---|
| 179 | |
|---|
| 180 | <td>The name by which the C++ compiler is invoked</td> |
|---|
| 181 | |
|---|
| 182 | <td><code>$(SUNPRO_BIN_DIRECTORY)CC</code></td> |
|---|
| 183 | |
|---|
| 184 | <td>You can also use this in lieu of setting the <cxxflags> |
|---|
| 185 | property to force options such as <code>‑Qoption CC |
|---|
| 186 | ‑xcomdat</code> into the CC command line: |
|---|
| 187 | <code>“‑sSUNPRO_CXX=CC ‑Qoption CC |
|---|
| 188 | ‑xcomdat”</code>.</td> |
|---|
| 189 | </tr> |
|---|
| 190 | |
|---|
| 191 | <tr> |
|---|
| 192 | <td><code>SUNPRO_CC</code></td> |
|---|
| 193 | |
|---|
| 194 | <td>The name by which the C compiler is invoked</td> |
|---|
| 195 | |
|---|
| 196 | <td><code>$(SUNPRO_BIN_DIRECTORY)cc</code></td> |
|---|
| 197 | |
|---|
| 198 | <td> </td> |
|---|
| 199 | </tr> |
|---|
| 200 | </table> |
|---|
| 201 | <hr> |
|---|
| 202 | |
|---|
| 203 | <p>Revised $Date: 2005/08/04 01:50:18 $</p> |
|---|
| 204 | |
|---|
| 205 | <p>Christopher Currie, Gennadiy Rozental, Jens Maurer</p> |
|---|
| 206 | </body> |
|---|
| 207 | </html> |
|---|
