2.6. Setting up the Environment
Prev | Chapter 2. Installation and Configuration | Next

## 2.6. Setting up the Environment

As with the installation process itself, the steps required to set up your environment depend on your host operating system.

### 2.6.1. Setting up the Environment on Microsoft Windows Hosts

#### 2.6.1.1. Setting the `PATH`

In order to use the Sourcery G++ tools from the command line, you should add them to your `PATH`. You may skip this step if you used the graphical installer, since the installer automatically adds Sourcery G++ to your `PATH`.

To set the `PATH` on a Microsoft Windows Vista system, use the following command in a `cmd.exe` shell:

    > setx PATH "%PATH%;C:\Program Files\Sourcery G++\bin"

where `C:\Program Files\Sourcery G++` should be changed to the path of your Sourcery G++ Lite installation.

To set the `PATH` on a system running a Microsoft Windows version other than Vista, from the desktop bring up the Start menu and right click on My Computer. Select Properties, go to the Advanced tab, then click on the Environment Variables button. Select the `PATH` variable and click the Edit. Add the string `;C:\Program Files\Sourcery G++\bin` to the end, and click OK. Again, you must adjust the pathname to reflect your installation directory.

You can verify that your `PATH` is set up correctly by starting a new `cmd.exe` shell and running:

    > mips-sde-elf-g++ -v

Verify that the last line of the output contains: `Sourcery G++ Lite 4.4-124`.

#### 2.6.1.2. Working with Cygwin

Sourcery G++ Lite does not require Cygwin or any other UNIX emulation environment. You can use Sourcery G++ directly from the Windows command shell. You can also use Sourcery G++ 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 Sourcery G++ is not a Cygwin application, it does not, by default, recognize Cygwin paths.

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

    > export CYGPATH=cygpath

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

    > export CYGPATH=c:/cygwin/bin/cygpath

directs Sourcery G++ Lite to use `c:/cygwin/bin/cygpath` as the path conversion utility. The value of `CYGPATH` must be an ordinary Windows path, not a Cygwin path.

### 2.6.2. Setting up the Environment on GNU/Linux Hosts

If you installed Sourcery G++ Lite using the graphical installer then you may skip this step. The installer does this setup for you.

Before using Sourcery G++ Lite you should add it 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:

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

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

You may also wish to set the `MANPATH` environment variable so that you can access the Sourcery G++ manual pages, which provide additional information about using Sourcery G++. To set the `MANPATH` environment variable, follow the same steps shown above, replacing `PATH` with `MANPATH`, and `bin` with `share/doc/sourceryg++-mips-sde-elf/man`.

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

    > mips-sde-elf-g++ -v

Verify that the last line of the output contains: `Sourcery G++ Lite 4.4-124`.

Prev | Up | Next
2.5. Installing Sourcery G++ Lite Updates | Home | 2.7. Uninstalling Sourcery G++ Lite