f78

GNUPro Toolkit Documentation | Contents | Index | Next

Overview of GNUPro Toolkit

About Cygnus

Pervasive computing

What's in this package

About the tools

To install for the UNIX platforms, see Installing on Unix Systems from CD.

To install for the Windows platforms, see Installing on Win 95/NT systems from CD.

For information on what's supported, see the following documentation.

Native configurations support
Embedded cross-configuration support
Version numbers for programs
Naming hosts and targets

Cygnus sells the GNUPro toolkit together with mission-critical support services for rapid response and resolution of technical questions or problems, as well as regular software upgrades with enhancements. See also Red flag alerts & enhancements and, to report problems or to find out about problems, see How to report problems.

About Cygnus

The company was founded in 1989 to provide commercial support for open Internet technologies. Cygnus established a support model for the GNU standard, leveraging the contributions of the net community and the requirements of the semiconductor industry to produce a powerful multi-platform software development toolkit. The changes and improvements to the GNU tools are returned to the net community via the Free Software Foundation, while the Cygnus implementation of the these tools is sold and supported by Cygnus directly. Driven by our unique business model, the company's sales have grown at a compound annual rate of over 65% since 1992. Our consistent profitability and solid financial position have enabled the company to rapidly expand operations to support the growing needs o ffb f our customer base.

Cygnus is a privately held company with venture capital investment from August Capital and Greylock Management. We are global in both our operations and our customer set. Our headquarters are in Sunnyvale, California, with additional offices in Cambridge, Massachusetts, Atlanta, Georgia; and international offices in Canada, Japan, the United Kingdom, and Germany. Our historical roots and current strong ties with the Internet community also allow us to leverage the global power of the Internet to drive our toolchain innovation and recruit new engineers for our growing company.

Pervasive computing

Cygnus also benefits from advances in all of the related technologies that make end-user solutions more cost-effective and drive end-user demand. These technologies include storage ( disk, flash, DRAM), display (LCD), Internet and communication protocols, and wireless connectivity. Collectively, advances in these technologies allow ever-greater embedding of intelligence in traditional embedded systems (telecommunications equipment, automobiles, office equipment), and enable completely new classes of computing devices such as Personal Digital Assistants (PDAs).

One thing is certain: software tools and software content for them must keep pace in order to realize the promise of powerful, distributed, and densely interconnected computing power. The Cygnus mission is to enable this vision of "pervasive computing" through software solutions.

Cygnus doesn't deliver technology for technology's sake. Our clients turn to us to create flexibility (with single-source solutions providing true multi-platform capabilities and easy retargeting), to shorten time-to-market (starting software development before hardware is ready), and to reduce costs (providing cost-effective support services and redistributable solutions). These are the reasons that the best names in the business choose Cygnus.

The company strategy is to continue to extend the functionality and performance of the development tools, as well as to deliver innovative software component technologies for use in embedded systems. Customers include the world's top microcontroller companies as well as leading telecommunications software, game console, consumer electronics, and office equipment companies.

The world's leading product manufacturers choose the GNUPro toolkit for these benefits:

Multi-platform capabilities from a single source base to quickly port code
Knowledgeable support for keeping design teams productive and on-schedule
Superior software engineering, incorporating leading-edge features and code optimizations
Early availability of tools for a wide range of processors
Stringent testing to insure solid, stable tools for fast development
Custom enhancements to decrease time to market

What's in this package

Embedded cross-configuration support

What's in this package

GNUPro Toolkit documentation

Doc umentation conventions
What's in the documentation
Using online documentation
Reading online documentation
Using website documentation
Native configurations support
Embedded cross-configuration support
Version numbers for programs
Naming hosts and targets

About the tools

GNUPro Toolkit documentation

Comp ilers and development tools
Libraries
General utilities
Binary utilities

Compilers and development tools

GNUPro Compiler Tools

GNUPro Debugging Tools

GNUPro Utilities

`gcc`	C compiler
`g++`	C++ compiler
`gdb`	Debugger
`gas`	Assembler
`cpp`	C Preprocessor
`ld`	Linker
`gdbtk`	Debugger graphical user interface

Libraries

GNUPro Libraries

`libstdc++`	C++ class library
`libio`	C++ iostreams library
`libc`	ANSI C runtime library ( only available for cross-development )
`libm`	C math subroutine library ( only available for cross-development )

Binary utilities

GNUPro Utilities

`c++filt`	C++ symbol name deciphering utility
`nm`	Lists object file symbol tables
`objdump`	Displays object file information
`size`	Lists section and total sizes
`ar`	Manages object code archives
`ranlib` ffb	Generates archive index
`strip`	Discards symbols
`objcopy`	Copies and translates object files

General utilities

GNUPro Utilities

GNUPro Advanced Topics

GNUPro Compiler Tools

`flex`	Fast lexical analyzer generator
`make`	Compilation control program
`diff`, `diff3`, `sdiff`	Compare text files
`patch`	Installs source fixes
`cmp`	Compares files byte-by-byte
`send-pr`	Sends structured problem reports to Cygnus
`install-sid`	Customizes `send-pr`for your site
`gcov`	Coverage analyzer

GNUPro Toolkit documentation

GNUPro Toolkit includes documentation in three forms.

Printed

HTML

http://www.cygnus.com/pubs/gnupro

Online

Using online documentation

Reading online documentation

GNU Online Documentation

GNUPro Advanced Topics

Documentation conventions

The documentation uses the following conventions for commands, filenames, and other program-specific subjects.

Typewriter-text for input

PATH=/usr/cygnus

Typewriter-text in bold for output

%

(gdb)

IMPORTANT!
% indicates a command prompt in most documentation; a command prompt in some rare examples, depending on the system in use and the program's tool, may actually be # or $ and, as with gdbtk,(gdb).

Typewriter-text in italics for variables

filename

foobar.c

filename

rm

filename

Typewriter-text in bold for output

%

(gdb)

Keys or keystroke combinations to use

Ctrl

Delete

spacebar

Ctrl

Meta

C-

M-

Meta

M-

Alt

Enter

ENTER

RET

return

What's in the documentation

http://www.cygnus.com/pubs/gnupro/

Getting Started with GNUPro Toolkit

Introduction
Installation

GNUPro Compiler Tools

Using GNU CC
The C Preprocessor

GNUPro Debugging Tools

Debugging with GDB
GDBTk (the GUI for GDB)

GNUPro Libraries

GNUPro Utilities

Using AS (the GNU Assembler)
Using LD (the GNU Linker)
The GNU Binary Utilities
GNU Make

GNUPro Advanced Topics

GNUPro Tools for Embedded Systems

Using website documentation

Using online documentation

For online use, the accompanying software includes online versions of the following documentation. This is not to be confused with the HTML versions.

man p ffb ages

FLEX: A Fast Lexical Analyzer Generator

gcc

Using an Porting GNU CC

gcc

Using GNU CC

BYacc

Texinfo: The GNU Documentation Format

Cygnus configuration program

GNU Coding Standards

GNU

GNU gprof

GNU

See GNU Online Documentation in GNUPro Advanced Topics for documentation regarding the following tools.

Texinfo*, `texindex` , `texi2dvi`	Documentation formatting tools
`makeinfo` , `info`	Online documentation tools

Requires TEX, the technical documentation formatting tool

Reading online documentation

info

nodes

info

hot

info

%

% info

info

Ctrl-h

info

Reading GNU Online Documentation

GNU Online Documentation

GNUPro Advanced Topics

info

Using website documentation

GNU

GNUPro Toolkit documentation

Contact Cygnus to report any problems to the documentation department: doc@cygnus.com .

Native configurations support

GNUPro Toolkit software supports the following native configurations.

Sun SPARC Solaris 2.5.1/2.6

Sun SPARC SunOS 4.1.4

HP 9000/700 HP-UX 10.01/10.10/10.20

IBM RS/6000 AIX 3.2.5/4.1.4

IBM PowerPC AIX 4.1.4/4.2

DEC Alpha Digital UNIX 3.2C/4.0

SGI Iris 6.2

386+ for Windows

Windows NT4.0-sp3/95-osr2

Linux RedHat 5.0

Embedded cross-configuration support

Embedded cross-configurations supported

NOTE:

x

Embedded cross-configurations supported

ffb

*Host*	*Target*	*Output Format*
*SPARC Solaris 2.5.1-2.6*	H8/300	COFF
	i960	COFF
	M68K	a.out, COFF, ELF
	MIPS R4`xx`0	ELF
	MIPS R3`xx`0	ELF, ECOFF
	PowerPC	ELF
	SH	COFF
	`x`86	a.out, ELF
*SPARC SunOS 4.1.4*	H8/300	COFF
	i960	COFF
	M68K	COFF
	MIPS R3`xx`0	ELF
	MIPS R4`xx`0	ELF
	PowerPC	EABI
	SH	COFF
	`x`86	ELF
*Windows NT4.0/95*	H8/300	COFF
	i960	COFF
	M68K	COFF
	PowerPC	EABI
	SH	COFF

Version numbers for programs

Versions of the tools

Program	Version Numbers
`bfd`	`2.8-gnupro-98r1`
`binutils`	`2.9-gnupro-98r1`
`diff`	`2.7-gnupro-98r1`
`expect`	`5.21-gnupro-98r1`
`flex`	`2.5-gnupro-98r1`
`gas`	`2.9-gnupro-98r1`
`gcc`	`2.9-gnupro-98r1`
`gcov`	`1.5-gnupro-98r1`
`gdb` ffb	`4.17-gnupro-98r1`
`ld`	`2.8-gnupro-98r1`
`libstdc++`	`2.8-gnupro-98r1`
`libio`	`2.8-gnupro-98r1`
`make`	`3.75-gnupro-98r1`
`makeinfo`	`1.67-gnupro-98r1`
`newlib/libc`	`1.8-gnupro-98r1`
`newlib/libm`	`1.8-gnupro-98r1`
`patch`	`2.5-gnupro-98r1`
`send-pr`	`3.104-gnupro-98r1`

Naming hosts and targets

architecture-vendor-os

sparc-sun-sunos4.1.4

WARNING!

configure

Host names

Table 5: Naming hosts

How to contact Cygnus

Table 5: Naming hosts

Canonical name	Platform
`alpha-dec-osf3.2C`	DEC Alpha Digital UNIX v3.2C
`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.0
`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

Native configurations support and Embedded cross-configuration support

GNUPro Tools for Embedded Systems

WARNING!

configure

H8/300 processor name and output format

h8300-hms-coff

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

MIPS processor names and output formats

`mips-elf`	ELF object code format
`mips-sgi-irix6`	ELF object code format

PowerPC processor names and output formats

ppc-eabi

ELF object code format (EABI)

SH processor name and output format

sh-hms-coff

COFF object code format

SPARC proce 8c8 ssor names and output formats

`sparc-elf`	ELF object code format
`sparc-aout`	a.out object code format

`x`86 processor names and output formats

`i386-aout`	a.out object code format
`i386-elf`	ELF object code format

Using `config.guess`

config.guess

uname

config.guess

hosttype

config.guess

configure

GNUPro Toolkit Documentation | Contents | Index | Next

Overview of GNUPro Toolkit

About Cygnus

Pervasive computing

What's in this package

About the tools

Compilers and development tools

Libraries

Binary utilities

General utilities

GNUPro Toolkit documentation

Documentation conventions

What's in the documentation

Using online documentation

Reading online documentation

Using website documentation

Native configurations support

Embedded cross-configuration support

Embedded cross-configurations supported

Version numbers for programs

Versions of the tools

Naming hosts and targets

Host names

Table 5: Naming hosts

Target names

H8/300 processor name and output format

i960 processor names and output format

M68K processor names and output formats

MIPS processor names and output formats

PowerPC processor names and output formats

SH processor name and output format

SPARC proce 8c8 ssor names and output formats

x86 processor names and output formats

Using config.guess

`x`86 processor names and output formats

Using `config.guess`