Installing GNUPro Toolkit
Installing GNUPro Toolkit 
The following documentation describes how to install your GNUPro Toolkit software on Unix and Win32 systems.
For help with using the tools, see  Cygnus and GNUPro Toolkit fundamentals and Using GNU tools on embedded systems.

For information about rebuilding the tools for other target environments, see Rebuilding from source.

Installing on Unix systems from CD

 
Use the following procedures for full installation from CD for Unix systems. In the following procedure examples, the system prompt appears as '%'.
    1. Mount the CD.
      The procedures for mounting a CD depend on your system type. The following discussion details some examples of mount commands for each host.


Using your Cygnus customer ID (see cover letter), report problems by using the Web; see Reporting problems for details.

Installation information for Unix

The following documentation describes host-specific information and installation standards for Unix systems.

Platform names

Your package contains a label that indicates the host (and target, if applicable) with which to configure the binaries. The specifications used for hosts and targets in the configure script are based on a three-part naming scheme, though the scheme is slightly different between hosts and targets.

Host names

Naming hosts shows the usage of canonical names for referring to the corresponding host platforms that Cygnus supports. For any questions about compatibility, contact Cygnus (see How to contact Cygnus).

Naming hosts

Canonical name
Platform 
alpha-dec-osf4.0 
DEC Alpha Digital UNIX v4.0
hppa1.1-hp-hpux10 
HP 9000/700, HP-UX B.10.01
hppa1.1-hp-hpux10.20 
HP 9000/700, HP-UX B.10.20
i386-cygwin32 
Windows NT-sp3/95-osr2
i386-pc-linux-gnu 
Intel PC, Linux RedHat 5.1
mips-sgi-irix5 
SGI Irix 5.3
mips-sgi-irix6 
SGI Irix 6.2
powerpc-ibm-aix4.1 
IBM PowerPC, AIX 4.1.4
powerpc-ibm-aix4.2 
IBM PowerPC, AIX 4.2.1
rs6000-ibm-aix4.1 
IBM PowerPC, AIX4.1.4
sparc-sun-solaris2.5 
SPARCstation, Solaris 2.5.1
sparc-sun-solaris2.6 
SPARCstation, Solaris 2.6
sparc-sun-sunos4.1 
SPARCstation, SunOS 4.1.4
 

Target names

The following documentation lists some of the more common targets supported by Cygnus, along with their output format. Not all targets have support on every host. See also Native configurations support and Embedded cross-configuration support for the matrices of the host/target combinations supported by Cygnus. Also, for more informaton on using particular tools and their targets, see Using GNU tools on embedded systems, Cross-development environment, and GNUPro Tools for Embedded Systems.
    WARNING!
    configure can represent a very large number of target name combinations of architecture, vendor, and object formats. Support is not possible for all combinations.

H8/300 processor name and output format

h8300-hms 
COFF object code format
sh-hms COFF object code format
 

i960 processor names and output format

i960-coff 
MON960 monitor (COFF format)
 

M68K processor names and output formats

m68k-aout 
a.out object code format
m68k-coff 
COFF object code format
m68k-elf 
ELF object code format *
* To use the Motorola "Coldfire" version as the configuration to target,
see Motorola m68k development in GNUPro Tools for Embedded Systems.

MIPS processor names and output formats

mips-elf 
ELF object code format
mips64-elf 
ELF object code format
mips-ecoff 
ECOFF object code format
mips-lsi-elf 
ELF object code format
mips64vr5xxx-elf 
ELF object code format
mips-tx39-elf 
ELF object code format
 

PowerPC  processor names and output formats

powerpc-eabi 
ELF object code format (EABI)
 

SPARC processor names and output formats

sparc-elf 
ELF object code format
sparc-aout 
a.out object code format
sparclet-aout 
a.out object code format
sparclite-coff 
COFF object code format
 

x86 processor names and output formats

i386-aout 
a.out object code format
i386-coff COFF object code format
i386-elf 
ELF object code format

config.guess scripts

config.guess is a shell script that attempts to deduce the host type from which it is called, using system commands like uname if they are available.
config.guess is remarkably adept at deciphering the proper configuration for your host; if you are building a tree to run on the same host on which you're building, we recommend not specifying the hosttype argument.
config.guess is called by configure; you need never run it by hand, unless you're curious about the output.

Links for easy access and updating

Once you extract the tools from the CD, they are installed into a directory named 'installdir /gnupro-98r2' where 'installdir' refers to the full directory pathname within which you're locating the 'gnupro-98r2' files.
For example, if you've installed in the default location under /usr/cygnus, use the following input.
        The input for the last two examples of input match (installdir means the same location as the default that you assign for usr/cygnus.
Directories of machine-independent files (source code and documentation) are installed directly under 'gnupro-98r2'. However, to accommodate binaries for multiple hosts in a single directory structure, the binary files for your particular host type are in a subdirectory 'H-hosttype'. (hosttype indicates a particular architecture, vendor and operating system; see Host names for more specific details on names for input.)

This means that one more level of symbolic links is helpful, to allow your users to keep the same execution path defined even if they sometimes use binaries for one machine and sometimes for another. Even if this doesn't apply now, you might want it in the future; establishing these links now can save your users the trouble of changing all their paths later.

The idea is to build '/usr/gnupro/bin' on each machine so that it points to the appropriate binary subdirectory for each machine--for instance, '/usr/cygnus/gnupro-98r2/H-hosttype' where 'hosttype' corresponds to the host machine.

You may need super-user access again briefly to establish the following link.

    ln -s /usr/cygnus/gnupro-98r2/H-hosttype /usr/gnupro
We recommend building these links as the last step in the installation process.

Setting PATH

To run the tools in this distribution, make sure the PATH environment variable can find the tools. Whether you install in the default location, as in the following example for the input, or in an alternate location, you need to alter your PATH environment variable to point toward the newly installed tools.

If you create the symbolic links we recommend (see Links for easy access and updating), users who want to run the GNUPro Toolkit--regardless of whether they need binaries for your particular host, or for some other platform--can use initialization files settings. The following shows examples with the final linked installation directory as /usr/gnupro/bin . If you installed into a different directory, substitute ` /usr/gnupro/bin ' for the actual directory.

      • For Bourne-compatible shells (/bin/sh , bash, or Korn shell):
          % PATH=/usr/gnupro/bin:$PATH
          % set path=(/usr/gnupro/bin $path)

Installing on Win 95/NT systems from CD

All releases of GNUPro Toolkit for Win95/NT systems use the following CD installation procedure.
    1. Mount the CD.
      Insert CD into CD-ROM drive. The Cygnus installation will start; if it doesn't, open the CD in the Windows Explorer and open setup.exe.
    2. Determine where to install the tools.
      Setup prompts for an installation directory; the default is 'C:\Program Files\Cygnus Solutions\gnupro-98r2'. The tools may be installed in any directory or drive.
      Make sure the installation directory is where you want to install the files. Check the box for installing souce code files, if that is an option you require.
      Click Next.
      Setup first checks the installation location to make sure it has enough space before unpacking the tools. Installed GNUPro Toolkit disk usage varies.
      Setup reads the CD, builds the directories and expands the files.
      Click on the Start button on the lower left hand corner of your screen, and choose Programs, where Cygnus programs are found as a shortcut. Choose Cygnus. A shell program opens.
      To test the installation, change your working directory to the demo subdirectory of the CYGNUS directory (as in the following example), and type the following text at the prompt.
          \CYGNUS\> cd C:\CYGNUS\gnupr0-98r2\demo
      For the Win95 environment, set your working environment to the CYGNUS.BAT initialization file, or initialize it from the Start button at the bottom of your screen, and use the Program menu.
      For the NT environment, as long as you use the Start button in the lower left hand corner of your screen, you can always start the programs as in Step 5. If not, choose Settings, and click Control Panel. Choose System. Make the appropriate changes according to your requirements.

Rebuilding GNUPro Toolkit

To rebuild, see Rebuilding from source.
 
© 2005 Red Hat, Inc. All rights reserved.
About Red Hat  :  Legal statement  :  Privacy statement  :  Contact