Contents

Overview of GNUPro Toolkit 1

Using the Documentation 3
Configurable Operating Systems 4
Importance of Configuring 4
Embedded Cross-configurations 6


Installing GNUPro Toolkit
7

Install on UNIX or Linux Systems with CD 8
Setting the PATH Environment Variable 10
install-cli Options 10
Install on Microsoft Windows Systems with CD 12


How to Report Problems
15


Basics of the Tools
17

Compiler and Development Tools 18
Libraries 18
Auxiliary Development Tools 19
gcc and g++, the GNU Compilers 20
cpp, the GNU Preprocessor 21
ld, the GNU Linker 22
make, the GNU Recompiling Tool 23
gdb, the Debugging Tool 26
Insight, a GUI Debugger 27
as, the GNU Assembler 27
newlib and libstdc++, the GNU Libraries 29
Using Cygwin to Port UNIX Applications to Windows 29
RedBoot for Remote Debugging 30
Using info, the Documentation Tools 31
Reading info Documentation 31


Developing with GNUPro Toolkit
33

What Embedded Development Means 34
Tools, Toolchains and Usage 35
The C Run-time Environment (crt0) 36
crt0, the Main Startup File 37
The Linker Script 40
Using Cygwin 43
Before Using Cygwin 44
Using GCC with Cygwin 49
Debugging Cygwin Programs 49
Environment Variables for Cygwin 50
Using RedBoot for Remote Debugging 53
Debug with Insight 54
Selecting and Examining a Source File 54
Setting Breakpoints and Viewing Local Variables 56
Setting Breakpoints on Multiple Threads 59


Rebuilding from Source
63

Configuring the Location of the Tools 64
Configuring with an Embedded Target 64
Preparing to Rebuild Source Code Files 65
Building and Installing Binaries 66
Single Host/Target Builds 66
Multiple Host Builds 66
Rebuilding When Compiling with Microsoft Windows NT Systems 67
Troubleshooting the Rebuilding Process 69
configure Problem Reporting 70
build Problem Reporting 70
Patching 70

Appendices

General Licenses and Terms for Using GNUPro Toolkit 75

Licensing Terms 75
GNU General Public License 76
How to Apply These Terms to Your New Programs 80
GNU Lesser General Public License 81
How to Apply These Terms to Your New Libraries 87
Tcl/Tk Tool Command Language and Windowing Toolkit License 88


Glossary
103