As with the installation process itself, the steps required to set up your environment depend on your host operating system.
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 Microsoft Windows 7,
from the desktop bring up the Start
menu and
right click on Computer
.
Select Properties
and click on
Advanced system settings
.
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
. Be sure to
adjust the pathname to reflect your actual installation directory.
To set the PATH
on older versions of Microsoft
Windows, 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:
> arm-none-eabi-g++ -v
Verify that the last line of the output contains:
Sourcery G++ Lite 2010.09-51
.
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.
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++-arm-none-eabi/man
.
You can test that your PATH
is set up correctly by
running the following command:
> arm-none-eabi-g++ -v
Verify that the last line of the output contains:
Sourcery G++ Lite 2010.09-51
.