RealView® Development Suite Getting Started Guide A.2.2. armenv command-line arguments

A.2.2. armenv command-line arguments

Table A.1 shows the command-line arguments that are available on all platforms.

Table A.1. Generic armenv arguments

Argument	Description
--help	Displays help on the command-line arguments.
-r `root`	The absolute path to the root of the product installation, `install_directory`. For example, on Windows the default root is: `C:\Program Files\ARM`
-p `product`	The ARM RealView product. See Product syntax for more details.
--and	Compute settings for all products before this argument, then do the same for those following it. The settings in the second group override those in the first.
--proc	Change the environment for the current process only. You cannot use this argument with `--system` or `--user` on Windows.
--exec	Execute a program in the new environment. You cannot use this argument with `--bat` on Windows, or with `--sh`, `--csh`, or `--posh` on Sun Solaris and Red Hat Linux.
-u	Attempts to undo the changes to the environment that were made when setting up the product.

Table A.2 shows the command-line arguments that are specific to Windows systems.

Table A.2. armenv arguments specific to Windows

Argument	Description
--system	Update the Windows SYSTEM area of the registry. This is the default.
--user	Update the Windows USER area of the registry.
--bat	Changes the environment for the current command prompt window. This is the default.

Table A.3 shows the command-line arguments that are specific to Sun Solaris and Red Hat Linux systems. You can specify only one of these.

Table A.3. armenv arguments specific to Sun Solaris and Red Hat Linux

Argument	Description
--csh	Generate a csh syntax shell script.
--sh	Generate a sh syntax shell script.
--posh	Generate a portable shell script. This is the default.

Product syntax

The syntax for specifying the product is:

-p category [name] [version [rev]] [-v name value]...

where:

category

The product identifier, for example, RVDS or RVCT.

name

Do not use this argument (armenv uses the default name Contents).

version

The version number of the product, for example, 3.0. If you do not specify a version, the most recent version of the installed product is used.

rev

A specific build number for the product. If you do not specify a build number, the most recent build of the installed product is used.

-v name value

Identifies a variant of the same product.

name: The type of the variant, for example, platform. It is suggested that you use only the platform variant.
value: The specific variant, for example, solaris-sparc.

For example, you might have both Sun Solaris and Red Hat Linux variants of RVDS v3.0 installed. See Examples for an example of how to use this argument.

Copyright © 2003-2006 ARM Limited. All rights reserved.	ARM DUI 0255E
Non-Confidential
PDF version