mirror of
https://github.com/SSCLI/sscli_20021101
synced 2026-06-08 12:28:57 +00:00
9fa3874800
Moved the original file to the archive subfolder.
807 lines
27 KiB
HTML
807 lines
27 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<title>Rotor Build Environment Variable Scripts</title>
|
|
<link rel="stylesheet" type="text/css" href="../rotor.css">
|
|
</head>
|
|
<body>
|
|
|
|
<h1>Shared Source CLI Build Environment Variable Scripts</h1>
|
|
|
|
<h2>(env.bat, env.csh, env.sh)</h2>
|
|
|
|
<p>Contents:</p>
|
|
|
|
<ul>
|
|
<li><a href="#Overview">Overview</a></li>
|
|
<li><a href="#SSCLIEnvironmentVariablesonWindows">SSCLI Environment Variables
|
|
on Windows</a><ul>
|
|
<li><a href="#TableofEnvironmentVariablesonWindows">Table of Environment
|
|
Variables on Windows</a></li>
|
|
</ul>
|
|
|
|
</li>
|
|
<li><a href="#SSCLIEnvironmentVariablesonUNIXSystem-basedPlatforms">SSCLI
|
|
Environment Variables on UNIX System-based Platforms</a><ul>
|
|
<li><a href="#TableofEnvironmentVariablesonUNIXSystem-basedPlatforms">Table
|
|
of Environment Variables on UNIX System-based Platforms</a></li>
|
|
</ul>
|
|
|
|
</li>
|
|
</ul>
|
|
|
|
<h2><a name="Overview"></a>Overview</h2>
|
|
|
|
<p>The Shared Source CLI (SSCLI) build process requires specific environment
|
|
variables to be set in order to function. Several files have been included
|
|
in the SSCLI source tree to help correctly set these environment variables in a console
|
|
window.</p>
|
|
|
|
<p>You should always run these files from the root of the SSCLI source tree
|
|
because they will set paths relative to the directory location from which they
|
|
are run.</p>
|
|
|
|
<h4>Usage</h4>
|
|
|
|
<p>On Microsoft® Windows:</p>
|
|
|
|
<blockquote>
|
|
|
|
<code>env [<i>option</i>]</code>
|
|
|
|
</blockquote>
|
|
|
|
<p>On UNIX system-based platforms, [t]csh shell:</p>
|
|
|
|
<blockquote>
|
|
|
|
<code>source env.csh [<i>option</i>]</code>
|
|
|
|
</blockquote>
|
|
|
|
<p>On UNIX system-based platforms, [ba|k]sh shell:</p>
|
|
|
|
<blockquote>
|
|
|
|
<code>. ./env.sh [<i>option</i>]</code>
|
|
|
|
</blockquote>
|
|
|
|
<h4>Options</h4>
|
|
|
|
|
|
<table border=1 width=100%>
|
|
|
|
<TR VALIGN="top" width=100%>
|
|
<TH width=33%>Option (build type)</TH>
|
|
<TH width=67%>Description</TH>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=33%><b>checked</b></TD>
|
|
<TD width=67%>Turns optimizations off, enables debug code, generates debugging
|
|
symbols.</TD>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=33%><b>fastchecked</b></TD>
|
|
<TD width=67%>Turns optimizations on, enables debug code, generates debugging
|
|
symbols.</TD>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=33%><b>free</b></TD>
|
|
<TD width=67%>Turns optimizations on, disables debug code, generates debugging
|
|
symbols.</TD>
|
|
</TR>
|
|
|
|
</table>
|
|
|
|
|
|
<h2><a name="SSCLIEnvironmentVariablesonWindows"></a>SSCLI Environment Variables on Windows</h2>
|
|
<p>On Windows the SSCLI build process depends on several external applications
|
|
already having been installed:</p>
|
|
<ul>
|
|
<li>Microsoft Visual Studio® .NET Professional<ul>
|
|
<li>The SSCLI build process requires a C++ compiler and some header files.</li>
|
|
</ul>
|
|
</li>
|
|
<li>Perl<ul>
|
|
<li>You can obtain a download of Perl for Windows from
|
|
<a href="http://www.activestate.com">www.activestate.com</a> </li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p>To set up your SSCLI build environment on Windows, switch to
|
|
the root directory of the SSCLI directory tree and run the env.bat file with the option
|
|
you want. Several external batch files are called from env.bat.</p>
|
|
<ul>
|
|
<li>vsvars32.bat<ul>
|
|
<li>This is created by Visual Studio .NET and sets environment
|
|
variables to access the Visual Studio command-line tools.</li>
|
|
</ul>
|
|
</li>
|
|
<li>rotorenv.bat<ul>
|
|
<li>This is part of the SSCLI build environment. The file is located at
|
|
sscli/clr/bin/.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h4><a name="TableofEnvironmentVariablesonWindows"></a>Table of Environment Variables on Windows</h4>
|
|
<table border="1" width="100%">
|
|
|
|
<tr width="100%">
|
|
<th width="27%">Environment variable</th>
|
|
<th width="27%">Value</th>
|
|
<th width="46%">Description</th>
|
|
</tr>
|
|
<tr>
|
|
<td width="27%">BROWSER_INFO</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">BUILD_ALT_DIR</td>
|
|
<td width="27%">Depends on build type:<ul>
|
|
<li>d in checked</li>
|
|
<li>df in fastchecked</li>
|
|
<li>set to nothing in free</li>
|
|
</ul>
|
|
</td>
|
|
<td width="46%">Not usually modified. Used by the build utility.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">BUILD_DEFAULT</td>
|
|
<td width="27%">-we -nmake -i -a</td>
|
|
<td width="46%">Default flags used by the build utility.
|
|
Build flags are documented in <a href="buildutility.html">buildutility.html</a><p>The
|
|
flags following -nmake are passed through to the nmake.exe make tool.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">BUILD_DEFAULT_TARGETS</td>
|
|
<td width="27%"> -dynamic %TARGET_DIRECTORY%</td>
|
|
<td width="46%">Not usually modified. Used by the build utility to find make
|
|
tool and other defaults.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">COFFBASE_TXT_FILE</td>
|
|
<td width="27%">%ROTOR_DIR%<i>\</i>clr\bin\*\checked\coffbase.txt</td>
|
|
<td width="46%">Sets .dll file base addresses for building Windows dynamic
|
|
libraries (DLLs). Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">COMPlus_BuildFlavor</td>
|
|
<td width="27%">wks</td>
|
|
<td width="46%">Not usually modified. Hardwired switch in SSCLI</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">COPYCMD</td>
|
|
<td width="27%">/Y</td>
|
|
<td width="46%">Not usually modified. Allows copying without confirmation.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">CORBASE</td>
|
|
<td width="27%">%ROTOR_DIR%\clr</td>
|
|
<td width="46%">Not usually modified. Set in rotorenv.bat.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">CORENV</td>
|
|
<td width="27%">%ROTOR_DIR%\rotorenv</td>
|
|
<td width="46%">Not usually modified. Set in rotorenv.bat.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">CRT_INC_PATH</td>
|
|
<td width="27%">%ROTOR_DIR%\palrt\inc</td>
|
|
<td width="46%">Not usually modified. Path to required C runtime include files</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">CRT_LIB_PATH</td>
|
|
<td width="27%">%VCINSTALLDIR%\Vc7\lib files</td>
|
|
<td width="46%">Path to Microsoft Visual C++® .NET .lib files</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">CSC_COMPILE_FLAGS</td>
|
|
<td width="27%"> /d:FEATURE_PAL</td>
|
|
<td width="46%">Options to be passed to the C# compiler.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">C_DEFINES</td>
|
|
<td width="27%">Can vary with build type.<p>Default for all buildtypes:</p>
|
|
<ul>
|
|
<li>-DNTMAKEENV </li>
|
|
<li>-D_DEBUG </li>
|
|
<li>-DDEBUGGING_SUPPORTED</li>
|
|
<li>-DPROFILING_SUPPORTED</li>
|
|
<li>-DFUSION_SUPPORTED</li>
|
|
<li>-DPLATFORM_WIN32 </li>
|
|
<li>-DFEATURE_PAL </li>
|
|
<li>-DUSE_CDECL_HELPERS </li>
|
|
<li>-DPAL_PORTABLE_SEH</li>
|
|
</ul>
|
|
</td>
|
|
<td width="46%"><p>#define values passed to the compiler during
|
|
the build.<p>These are set in rotorenv.bat.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">DDKBUILDENV</td>
|
|
<td width="27%">Depends on build type.<ul>
|
|
<li>checked in checked</li>
|
|
<li>fastchecked in fastchecked</li>
|
|
<li>free in free</li>
|
|
</ul>
|
|
</td>
|
|
<td width="46%">Set by input to env.bat. Used by other environment variables to build
|
|
path to binary build output.<p> </td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">DDKBUILDLIB</td>
|
|
<td width="27%">Depends on build type.<ul>
|
|
<li>checked in checked</li>
|
|
<li>fastchecked in fastchecked</li>
|
|
<li>free in free</li>
|
|
</ul>
|
|
</td>
|
|
<td width="46%">Set by input to env.bat.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">DEBUGGING_SUPPORTED_BUILD</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified. Set by rotorenv.bat.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">DEBUG_CRTS</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified. Set by rotorenv.bat.<p>Set in
|
|
both
|
|
checked and fastchecked builds.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">DevEnvDir</td>
|
|
<td width="27%">%VSINSTALLDIR%\Common7\IDE</td>
|
|
<td width="46%">Path to Visual Studio .NET development environment</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">dnaroot</td>
|
|
<td width="27%">%ROTOR_DIR%\fx</td>
|
|
<td width="46%">Path to root of SSCLI FX directory</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">FEATURE_PAL</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">FEATURE_PAL_VC7</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">FPO_OPT</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">FrameworkDir</td>
|
|
<td width="27%">%FrameworkDir%</td>
|
|
<td width="46%">Not usually modified. Set in vsvars32.bat</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">FrameworkSDKDir</td>
|
|
<td width="27%">%FrameworkSDKDir%</td>
|
|
<td width="46%">Not usually modified. Set in vsvars32.bat</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">FrameworkVersion</td>
|
|
<td width="27%">%FrameworkVersion%</td>
|
|
<td width="46%">Not usually modified. Set in vsvars32.bat</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">FUSION_LIB_PATH</td>
|
|
<td width="27%">Depends on build type.<p>%CORBASE%/bin/%TARGET_DIRECTORY%
|
|
<br>/%DDKBUILDENV%</td>
|
|
<td width="46%">Not usually modified. Path to intermediate binary
|
|
output.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">INTTOOLSTARGET</td>
|
|
<td width="27%">Depends on build type.<p>%ROTOR_DIR%\build\v1.x86*.rotor\int_tools</td>
|
|
<td width="46%">Path to copy final build output for internal tools.<p> </td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">MSC_OPTIMIZATION</td>
|
|
<td width="27%">/Od /Oi /GZ /G6</td>
|
|
<td width="46%">Microsoft® Visual C++ .NET compiler optimization switches.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">MSVCDir</td>
|
|
<td width="27%">%VCINSTALLDIR%\Vc7</td>
|
|
<td width="46%">Not usually modified. Path to Microsoft Visual C++
|
|
.NET root directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">NTDEBUG</td>
|
|
<td width="27%">ntsd</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">NTDEBUGTYPE</td>
|
|
<td width="27%">vc6</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">NTMAKEENV</td>
|
|
<td width="27%">%ROTOR_DIR%\rotorenv\bin</td>
|
|
<td width="46%">Not usually modified. Path to SSCLI build tools and
|
|
scripts.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">Path</td>
|
|
<td width="27%">
|
|
%PATH%</td>
|
|
<td width="46%">
|
|
After running env.bat, the path will include directories in SSCLI, Visual
|
|
Studio .NET,
|
|
and the Microsoft .NET Framework SDK.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">PERLLIB</td>
|
|
<td width="27%"><i>PerlRoot</i>\lib</td>
|
|
<td width="46%">Path to \Perl\lib directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">PREVIOUSCORPATH</td>
|
|
<td width="27%"><set by rotorenv.bat></td>
|
|
<td width="46%">The path before rotorenv.bat runs.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">PREVIOUSPATHSET</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">PREVIOUS_NT_SYMBOL_PATH_SET</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">PROFILING_SUPPORTED_BUILD</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">ROTOR</td>
|
|
<td width="27%">1</td>
|
|
<td width="46%">Must be "1" for build to complete</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">ROTOR_DIR</td>
|
|
<td width="27%">%ROTOR_DIR%</td>
|
|
<td width="46%">Path to root of SSCLI source directory. Set by env.bat
|
|
to the location where it is executed.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">SDK_INC_PATH</td>
|
|
<td width="27%">%ROTOR_DIR%\pal;</td>
|
|
<td width="46%">Not usually modified. Path to required SSCLI platform
|
|
include data in rotor_pal.h.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">SDK_LIB_PATH</td>
|
|
<td width="27%">%VCINSTALLDIR%\Vc7\PlatformSDK\lib</td>
|
|
<td width="46%">Not usually modified. Path to Visual Studio .NET .lib files.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">SVR_WKS_DIRS</td>
|
|
<td width="27%">wks</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">TARGETCOMPLUS</td>
|
|
<td width="27%">Depends on build type.<p>%ROTOR_DIR%\build\v1.x86*.rotor</td>
|
|
<td width="46%">Not usually modified directly. Use _URTTARGET to
|
|
change output location.<p>Path to copy final build output.</p>
|
|
</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">TARGETCOMPLUSSDK</td>
|
|
<td width="27%">Depends on build type.<p>%ROTOR_DIR%\build\v1.x86*.rotor\sdk</td>
|
|
<td width="46%">Not usually modified directly. Use _URTTARGET to
|
|
change output location.<p>Path to copy final build output for tools.</p>
|
|
<p> </td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">URTBUILDENV<p> </td>
|
|
<td width="27%">Depends on build type:<ul>
|
|
<li>chk in checked.</li>
|
|
<li>fstchk in fastchecked.</li>
|
|
<li>fre in free.</li>
|
|
</ul>
|
|
</td>
|
|
<td width="46%">Used to create name of build output directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">URTSDKTARGET</td>
|
|
<td width="27%">%ROTOR_DIR%\build\v1.x86*.rotor\sdk</td>
|
|
<td width="46%">Not usually modified directly. Use _URTTARGET to
|
|
change output location.<p>Same as TARGETCOMPLUSSDK.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">URTTARGET</td>
|
|
<td width="27%">%ROTOR_DIR%\build\v1.x86*</td>
|
|
<td width="46%">Not usually modified directly. Use _URTTARGET to
|
|
change output location.<p>Same as TARGETCOMPLUS without the .rotor</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">USE_PDB</td>
|
|
<td width="27%">Depends on build type:<ul>
|
|
<li>1 in checked and fastchecked.</li>
|
|
<li>not set in free.</li>
|
|
</ul>
|
|
</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">VCINSTALLDIR</td>
|
|
<td width="27%">Depends on install location of Visual Studio</td>
|
|
<td width="46%">Root of Visual Studio installation. Set by
|
|
vsvars32.bat.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">VSINSTALLDIR</td>
|
|
<td width="27%">Depends on install location of Visual Studio</td>
|
|
<td width="46%">Root of IDE location in Visual Studio installation.
|
|
Set by vsvars32.bat.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_ENV</td>
|
|
<td width="27%">Depends on build type.<ul>
|
|
<li>ConfigChecked in checked.</li>
|
|
<li>ConfigFastChecked in fastchecked.</li>
|
|
<li>ConfigFree in free.</li>
|
|
</ul>
|
|
</td>
|
|
<td width="46%">Not usually modified.<p>Used internally in batch file
|
|
system.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_NTDRIVE</td>
|
|
<td width="27%">Depends on root installation of SSCLI.</td>
|
|
<td width="46%">Not usually modified.<p>Drive letter of path in %ROTOR_DIR%</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_NTROOT</td>
|
|
<td width="27%">%ROTOR_DIR%\clr</td>
|
|
<td width="46%">Not usually modified.<p>Root of clr directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_NT_DEBUGGER_EXTENSION_PATH</td>
|
|
<td width="27%">%ROTOR_DIR%\build\v1.x86*.rotor\int_tools</td>
|
|
<td width="46%">Not usually modified.<p>Location where debugger extension
|
|
file SOS is copied.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_NT_SYMBOL_PATH</td>
|
|
<td width="27%">%ROTOR_DIR%\build\v1.x86*.rotor\</td>
|
|
<td width="46%">Not usually modified.<p>Location of debug symbolic
|
|
information (.ildb files)</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_TGTCPU</td>
|
|
<td width="27%">i386</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_TGTCPUTYPE</td>
|
|
<td width="27%">x86</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_TGTOS</td>
|
|
<td width="27%">NT32</td>
|
|
<td width="46%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="27%">_URTTARGET</td>
|
|
<td width="27%">%ROTOR_DIR%\build</td>
|
|
<td width="46%">Base of the build output directory.
|
|
<p>You can set this environment variable manually to override the location
|
|
for the binary build output.</td>
|
|
</tr>
|
|
</table>
|
|
<h2><a name="SSCLIEnvironmentVariablesonUNIXSystem-basedPlatforms"></a>SSCLI
|
|
Environment Variables on UNIX System-based Platforms</h2>
|
|
|
|
|
|
<p>To build SSCLI on UNIX system-based platforms you must install a developer
|
|
distribution of that operating system. The SSCLI build process requires commonly
|
|
installed developer tools such as the gcc compiler, Perl, and ld to be in the
|
|
path for the build to work. </p>
|
|
|
|
|
|
<p>Note: The SSCLI build process on UNIX system-based platforms requires <b>gcc</b> version <b>2.95.3</b>.</p>
|
|
|
|
|
|
<p>For tcsh or csh shell users: </p>
|
|
|
|
|
|
<p>Switch to the root directory of the SSCLI
|
|
source tree and run the env.csh script:</p>
|
|
|
|
|
|
<blockquote>
|
|
|
|
|
|
<pre>source env.csh [<i>option</i>]</pre>
|
|
|
|
|
|
</blockquote>
|
|
|
|
|
|
<p>O<i>ption</i> can be checked, free, or fastchecked.</p>
|
|
|
|
|
|
<p>Users of other sh-style shells like bash or ksh should switch to the root directory of the SSCLI
|
|
source tree and run the env.sh script:</p>
|
|
|
|
|
|
<blockquote>
|
|
|
|
<PRE class="syntax">. ./env.sh [<i>option</i>]</PRE>
|
|
|
|
</blockquote>
|
|
|
|
<p>The SSCLI build process on UNIX system-based platforms is an amalgam of the SSCLI Windows
|
|
build process preceded by a bootstrapping sequence that builds the Windows build
|
|
tools.</p>
|
|
|
|
<h4><a name="TableofEnvironmentVariablesonUNIXSystem-basedPlatforms"></a>Table
|
|
of Environment Variables on UNIX System-based Platforms</h4>
|
|
|
|
<p>(Using csh script format.)</p>
|
|
|
|
<table border="1" width="100%">
|
|
<tr VALIGN="top">
|
|
<th width="15%">Environment variable</th>
|
|
<th width="24%">Value</th>
|
|
<th width="28%">Description</th>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">_NTROOT</td>
|
|
<td width="24%">${CORBASE}</td>
|
|
<td width="28%">Not usually modified. Contains the path to the /clr directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">_TGTCPU</td>
|
|
<td width="24%">i386</td>
|
|
<td width="28%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">BUILD_ALT_DIR</td>
|
|
<td width="24%">Depends on build type:<ul>
|
|
<li>d in checked</li>
|
|
<li>df in fastchecked</li>
|
|
<li>r to in free (only on UNIX system-based platforms)</li>
|
|
</ul>
|
|
</td>
|
|
<td width="28%">Not usually modified. Used by the build utility.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">BUILD_DEFAULT</td>
|
|
<td width="24%">-iwe -nmake -i -a</td>
|
|
<td width="28%">Default flags used by the build utility. Build flags are documented in
|
|
<a href="buildutility.html">buildutility.html</a><p>The flags following -nmake are passed through to the
|
|
nmake make tool.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">BUILD_DEFAULT_TARGETS</td>
|
|
<td width="24%">-dynamic ${TARGET_DIRECTORY}</td>
|
|
<td width="28%">Not usually modified. Default behavior and
|
|
location for temporary binary build output.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">C_DEFINES</td>
|
|
<td width="24%">Can vary with build type.<p>See env.csh or env.sh for
|
|
default values.</td>
|
|
<td width="28%"><p>#define values passed to the compiler during
|
|
build.<p> </td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">COFFBASE_TXT_FILE</td>
|
|
<td width="24%">${ROTOR_DIR}/clr/bin/*/checked/coffbase.txt</td>
|
|
<td width="28%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">CORBASE</td>
|
|
<td width="24%">${ROTOR_DIR}/clr</td>
|
|
<td width="28%">Not usually modified. Location of the clr directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">CORBUILDENV</td>
|
|
<td width="24%">Depends on build type.<p>${DDKBUILDENV}/</td>
|
|
<td width="28%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">CORENV</td>
|
|
<td width="24%">${ROTOR_DIR}/rotorenv</td>
|
|
<td width="28%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">CRT_INC_PATH</td>
|
|
<td width="24%">${PWD}/palrt/inc</td>
|
|
<td width="28%">Not usually modified. Path to required C runtime include files</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">CSC_COMPILE_FLAGS</td>
|
|
<td width="24%">/d:FEATURE_PAL /d:PLATFORM_UNIX</td>
|
|
<td width="28%">#define options for C#</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">DDKBUILDENV</td>
|
|
<td width="24%">Depends on build type.
|
|
<ul>
|
|
<li>checked in checked.</li>
|
|
<li>fastchecked in fastchecked.</li>
|
|
<li>free in free.</li>
|
|
</ul>
|
|
</td>
|
|
<td width="28%">Not usually modified. Used by other environment variables to
|
|
build a path to binary build output.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">DEBUGGING_SUPPORTED_BUILD</td>
|
|
<td width="24%">1</td>
|
|
<td width="28%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">DNAROOT</td>
|
|
<td width="24%">${ROTOR_DIR}/fx</td>
|
|
<td width="28%">Not usually modified. Root of the FX directory</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">FEATURE_PAL</td>
|
|
<td width="24%">1</td>
|
|
<td width="28%">Not usually modified. Build requires this to be
|
|
set.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">FUSION_LIB_PATH</td>
|
|
<td width="24%">Depends on build and processor type.<p>${CORBASE}/bin/${TARGET_DIRECTORY}
|
|
<br>/${DDKBUILDENV}</td>
|
|
<td width="28%">Not usually modified. Path to intermediate binary
|
|
output.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">INTTOOLSTARGET</td>
|
|
<td width="24%">Depends on build type.<p>${TARGETCOMPLUS}/int_tools</td>
|
|
<td width="28%">Path to final internal tools binary build output.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">LD_LIB_DIRS</td>
|
|
<td width="24%">Depends on build type.<p>-L${TARGETCOMPLUS}</td>
|
|
<td width="28%">Path to SSCLI native libraries. Path is modified
|
|
to support ld linker.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">LD_LIBRARY_PATH</td>
|
|
<td width="24%">Depends on build type.<p>${TARGETCOMPLUS}</td>
|
|
<td width="28%">System path for dynamically loaded libraries. Path
|
|
is modified to include final binary build output of the SSCLI build.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">NTDEBUG</td>
|
|
<td width="24%">Depends on build type.<ul>
|
|
<li>Checked build value: ntsd</li>
|
|
<li>Fastchecked value: ntsd</li>
|
|
<li>Free build value: ntsdnodbg</li>
|
|
</ul>
|
|
</td>
|
|
<td width="28%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">NTMAKEENV</td>
|
|
<td width="24%">${ROTOR_DIR}/rotorenv/bin</td>
|
|
<td width="28%">Not usually modified. Path to internal build
|
|
scripts and tools.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">PATH</td>
|
|
<td width="24%">${PATH}:${TARGETCOMPLUS}/int_tools:
|
|
<br>${TARGETCOMPLUS}/sdk/bin</td>
|
|
<td width="28%">Path is modified to include final binary build output applications.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">PLATFORM</td>
|
|
<td width="24%">Depends on operating system.</td>
|
|
<td width="28%">Not usually modified. </td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">PLATFORM_UNIX</td>
|
|
<td width="24%">1</td>
|
|
<td width="28%">Not usually modified. Indicates that current
|
|
operating system platform is a UNIX system-based platform.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">PROCESSOR_ARCHITECTURE</td>
|
|
<td width="24%">x86</td>
|
|
<td width="28%">Processor target type.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">ROTOR_DIR</td>
|
|
<td width="24%">${PWD}</td>
|
|
<td width="28%">Path to root of SSCLI source tree. Set by using
|
|
current directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">ROTOR_X86</td>
|
|
<td width="24%">1</td>
|
|
<td width="28%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">SDK_INC_PATH</td>
|
|
<td width="24%">${ROTOR_DIR}/pal</td>
|
|
<td width="28%">Not usually modified. Path to required SSCLI platform
|
|
include data in rotor_pal.h.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">SVR_WKS_DIRS</td>
|
|
<td width="24%">wks</td>
|
|
<td width="28%">Not usually modified.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TARGET_DIRECTORY</td>
|
|
<td width="24%">Depends on target processor type.<p>rotor_${PROCESSOR_ARCHITECTURE}</td>
|
|
<td width="28%">Not usually modified. Path to root of directory
|
|
that will contain temporary build output.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TARGETCOMPLUS</td>
|
|
<td width="24%">Depends on build type.<p>${ROTOR_DIR}/build/v1.x86*.rotor</td>
|
|
<td width="28%">Not usually modified. Path to root of directory
|
|
that will contain SSCLI final build output.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TARGETCORBIN</td>
|
|
<td width="24%">${CORBASE}/bin</td>
|
|
<td width="28%">Not usually modified. Path to clr/bin directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TARGETCORLIB</td>
|
|
<td width="24%">${CORBASE}/bin</td>
|
|
<td width="28%">Not usually modified. Path to clr/bin directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TARGETPATH</td>
|
|
<td width="24%">${CORBASE}/bin</td>
|
|
<td width="28%">Not usually modified. Path to clr/bin directory.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TH_CONFIG</td>
|
|
<td width="24%">${ROTOR_DIR}/tests/palsuite/palverify.dat</td>
|
|
<td width="28%">Path to PAL test suite verify file.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TH_DIR</td>
|
|
<td width="24%">${ROTOR_DIR}/tests/palsuite</td>
|
|
<td width="28%">Path to root of PAL test suite directories</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TH_RESULTS</td>
|
|
<td width="24%">${ROTOR_DIR}/tests/palsuite/test_results.log</td>
|
|
<td width="28%">Path to PAL test suite log file.</td>
|
|
</tr>
|
|
<tr VALIGN="top">
|
|
<td width="15%">TH_XRUN</td>
|
|
<td width="24%">${ROTOR_DIR}/tests/harness/xrun/xrun</td>
|
|
<td width="28%">Path to test suite xrun test harness.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<br>
|
|
|
|
<hr>
|
|
|
|
|
|
<p><i>Copyright (c) 2002 Microsoft Corporation. All rights reserved.</i></p>
|
|
</body>
|
|
</html> |