ncenv, ncenv64x

configure NuTCRACKER Platform development environment 

Command


SYNOPSIS

ncenv [compiler]

ncenv64x [compiler]


DESCRIPTION

The various shells for NuTCRACKER Platform Development Start menu items all first call ncenv to configure the environment variables to use the default compiler selected duting installation. If you wish to chnage compilers without running the installer repair routine, you can call ncenv directly from a Windows command prompt (cmd.exe).

Any command window can be converted into a NuTCRACKER Platform build environment simply by calling ncenv. If you prefer to use MKS KornShell, MKS Bash, MKS C Shell, first run ncenv from a standard command interpreter window and then run your preferred shell as a child of that command interpreter. You cannot call this batch file from within a MKS shell as the environment is lost when the command interpreter exits. You must reverse the order and run the batch file first and then run a shell with the environment populated.

With no arguments, ncenv sets up the environment for the default compiler selected during installation.

The ncenv utility is used to target Windows 32-bit platforms, the ncenv64x utility is used to target Extended 64-bit Architecture platforms and the ncenv64x utility is used to target ARM64 Architecture.

The ncenv utility is not needed to set up the build environment for the PTC MKS Toolkit version of clang which discovers its environment automatically; but also not harmful, although toolsets on the PATH will tend to be discovered first.

The following sections describe the compiler options for each of the three utilities.

ncenv Compiler Options

For the ncenv command, the compiler argument can be one of the following:

5 

Microsoft Visual Studio/C++ version 5.

6 

Microsoft Visual Studio/C++ version 6.

7 

Microsoft Visual Studio.NET 2002 (Visual C++ 7.0).

71 

Microsoft Visual Studio.NET 2003 (Visual C++ 7.1).

8 

Microsoft Visual Studio.NET 2005 (Visual C++ 8).

9 

Microsoft Visual Studio 2008 (Visual C++ 9).

10 

Microsoft Visual Studio 2010 (Visual C++ 10).

11 

Microsoft Visual Studio 2012 (Visual C++ 11).

12 

Microsoft Visual Studio 2013 (Visual C++ 12).

14 

Microsoft Visual Studio 2015 (Visual C++ 14).

15 

The first installed instance of Microsoft Visual Studio 2017 (Visual C++ 15).

15_x 

The xth installed instance of Microsoft Visual Studio 2017 (Visual C++ 15).

Note that not all installed instances necessarily have an x86 compiler. Thus not all values of x are necessaily valid.

16 

The first installed instance of Microsoft Visual Studio 2019 (Visual C++ 16).

16_x 

The xth installed instance of Microsoft Visual Studio 2019 (Visual C++ 16).

Note that not all installed instances necessarily have an x86 compiler. Thus not all values of x are necessaily valid.

17 

The first installed instance of Microsoft Visual Studio 2022 (Visual C++ 17).

17_x 

The xth installed instance of Microsoft Visual Studio 2022 (Visual C++ 17).

Note that not all installed instances necessarily have an x86, x64 or arm64 compiler. Thus not all values of x are necessaily valid.

icl8 

Intel C/C++ Version 8.0 or 8.1.

icl9 

Intel C/C++ Version 9.0 or 9.1.

icl10 

Intel C/C++ Version 10.0 or 10.1.

icl12 

Intel C/C++ 2011 - Version 12.0.

icl13 

Intel C/C++ 2013 - Version 13.0.

icl14 

Intel C/C++ 2013 SP1 - Version 14.

gcc 

MKS customized version of GCC from the MKS Toolkit Resource Kit.

ncenv64x Compiler Options

8 

Microsoft Visual Studio.NET 2005 (Visual C++ 8).

9 

Microsoft Visual Studio 2008 (Visual C++ 9).

10 

Microsoft Visual Studio 2010 (Visual C++ 10).

11 

Microsoft Visual Studio 2012 (Visual C++ 11).

12 

Microsoft Visual Studio 2013 (Visual C++ 12).

14 

Microsoft Visual Studio 2015 (Visual C++ 14).

15 

The first installed instance of Microsoft Visual Studio 2017 (Visual C++ 15).

15_x 

The xth installed instance of Microsoft Visual Studio 2017 (Visual C++ 15).

Note that not all installed instances necessarily have an x64 compiler. Thus not all values of x are necessaily valid.

16 

The first installed instance of Microsoft Visual Studio 2019 (Visual C++ 16).

16_x 

The xth installed instance of Microsoft Visual Studio 2019 (Visual C++ 16).

Note that not all installed instances necessarily have an x64 compiler. Thus not all values of x are necessaily valid.

icl8 

Intel C/C++ Version 8.0 or 8.1.

icl9 

Intel C/C++ Version 9.0 or 9.1.

icl10 

Intel C/C++ Version 10.0 or 10.1.

icl12 

Intel C/C++ 2011 - Version 12.0.

icl13 

Intel C/C++ 2013 - Version 13.0.

icl14 

Intel C/C++ 2013 SP1 - Version 14.

msvc64 

Microsoft Platform SDK.


EXAMPLES

The following command sets up the NuTCRACKER Platform environment on a 32-bit Windows platform using gcc as the compiler:

ncenv gcc

The following command sets up the NuTCRACKER Platform environment on an X64 platform using icl8 as the compiler:

ncenv64x icl8

ENVIRONMENT VARIABLES

C_INCLUDE_PATH 

specifies the GCC include path.

CCG 

specifies the cc/ld configuration file path.

CPLUS_INCLUDE_PATH 

specifies the G++ include path.

INCLUDE 

specifies include path for compiler headers.

LIB 

specifies include path for linker.

LIBRARY_PATH 

specifies the GLD library path.

LOGNAME 

specifies the user name.

MAKESTARTUP 

specifies the configuration file for make.

NLSPATH 

specifies the path for locale files.

PATH 

specifies the search path.

PERLLIB 

specifies the Perl library path.

WINTIFINC 

specifies the Motif include path.

WINTIFLIB 

specifies the Motif library path.

TARGET_CPU 

specifies the target processor architecture.


DIAGNOSTICS

No specific exit status is set.


PORTABILITY

Windows 8.1. Windows Server 2012 R2. Windows 10. Windows Server 2016. Windows Server 2019. Windows 11. Windows Server 2022.


AVAILABILITY

ncenv is available in the following products:

PTC MKS Toolkit for Developers
PTC MKS Toolkit for Interoperability
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers

ncenv64x is available in the following products:

PTC MKS Toolkit for Enterprise Developers 64-Bit Edition
PTC MKS Toolkit for Professional Developers 64-Bit Edition


SEE ALSO

Commands:
ar, cc, cl (Microsoft), clang, icl (Intel), ld, link (Microsoft)


PTC MKS Toolkit 10.4 Documentation Build 39.