Setting up the Environment

As with the installation process itself, the steps required to set up your environment depend on your host operating system. The name of the ARM Sourcery G++ Lite commands all begin with arm-none-linux-gnueabi so that you can install ARM Sourcery G++ Lite for multiple target systems in the same directory.

Setting up the Environment on Microsoft Windows

The installer automatically adds ARM Sourcery G++ Lite to your PATH. You can test that your PATH is set up correctly by using the following command:

> arm-none-linux-gnueabi-g++

and verifying that you receive the message:

arm-none-linux-gnueabi-g++.exe: no input files

Working with Cygwin

ARM Sourcery G++ Lite does not require Cygwin or any other UNIX emulation environment. You can use ARM Sourcery G++ Lite directly from the Eclipse IDE or from the Windows command shell. You can also use ARM Sourcery G++ Lite from within the Cygwin environment, if you prefer.

The Cygwin emulation environment translates Windows path names into UNIX path names. For example, the Cygwin path /home/user/hello.c corresponds to the Windows path c:\cygwin\home\user\hello.c. Because ARM Sourcery G++ Lite is not a Cygwin application, it does not, by default, recognize Cygwin paths.

If you are using ARM Sourcery G++ Lite from Cygwin, you should set the CYGPATH environment variable. If this environment variable is set, ARM Sourcery G++ Lite will automatically translate Cygwin path names into Windows path names. To set this environment variable, type the following command in a Cygwin shell:

> export CYGPATH=

To resolve Cygwin path names, ARM Sourcery G++ Lite relies on the cygpath utility provided with Cygwin. You must provide ARM Sourcery G++ Lite with the full path to cygpath if cygpath is not in your PATH. For example:

> export CYGPATH=/path/to/cygpath

will direct ARM Sourcery G++ Lite to use /path/to/cygpath as the path conversion utility.

Setting up the Environment on GNU/Linux or Solaris

Before using ARM Sourcery G++ Lite you should add ARM Sourcery G++ Lite to your PATH. The command you must use varies with the particular command shell that you are using. If you are using the C Shell (csh or tcsh), use the command:

> setenv PATH $HOME/CodeSourcery/Sourcery_G++/bin:$PATH

If you are using Bourne Shell (sh), the Korn Shell (ksh), or another shell, use:

> export PATH=$HOME/CodeSourcery/Sourcery_G++/bin:$PATH

If you are not sure which shell you are using, try both commands. In both cases, if you have installed ARM Sourcery G++ Lite in an alternate location, you must replace the directory above with bin subdirectory of the directory in which you installed ARM Sourcery G++ Lite.

You may also wish to set the MANPATH environment variable so that you can access the ARM Sourcery G++ Lite manual pages, which provide additional information about using ARM Sourcery G++ Lite. To set the MANPATH environment variable, follow the same steps shown above, replacing PATH with MANPATH, and bin with man.

You can test that your PATH is set up correctly by using the following command:

> arm-none-linux-gnueabi-g++

and verifying that you receive the message:

arm-none-linux-gnueabi-g++: no input files