Preface
The ChorusOS 5.0 Debugging Guide presents the source-level debugging architecture of the ChorusOSTM operating system. It provides an overview of the GDB debugger and of Insight, its graphical interface, and highlights the modifications to these tools that are specific to the ChorusOS operating system.
Who Should Use This Book
This guide is aimed at application developers who want to debug applications developed for ChorusOS operating systems. While this guide provides an overview of the GDB debugger, it assumes that you are familiar with application debuggers and the concepts related to them. This book does not provide a comprehensive guide to using GDB. Rather, it describes the customizations to GDB that are specific to embedded operating systems and to the ChorusOS operating system in general.
Before You Read This Book
Debugging ChorusOS applications requires a development environment. You must have the ChorusOS software installed and configured on a host development system running the SolarisTM operating environment, and the host development system must be connected to a target on which the ChorusOS system and applications run. If you are missing the host, the target, or the connection between them, you will not be able to complete the examples.
For instructions on how to install the software and how to set up the development environment, see the ChorusOS Installation Guide.
How This Book Is Organized
Chapter 1 provides an overview of the debugging tools available in ChorusOS systems.
Chapter 2 describes application debugging with the GDB/Insight debugger.
Chapter 3 describes system debugging with the GDB/Insight debugger.
Related Books
If you are unfamiliar with application debuggers, it is suggested that you read Debugging with GDB before reading this book.
Ordering Sun Documents
Fatbrain.com, an Internet professional bookstore, stocks select product documentation from Sun Microsystems, Inc.
For a list of documents and how to order them, visit the Sun Documentation Center on Fatbrain.com at: http://www1.fatbrain.com/documentation/sun.
Accessing Sun Documentation Online
The docs.sun.comSM Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://www.oracle.com/technetwork/indexes/documentation/index.html.
Typographic Conventions
The following table describes the typographic changes used in this book.
Table P-1 Typographic Conventions|
Typeface or Symbol |
Meaning |
Example |
|---|---|---|
|
AaBbCc123 | The names of commands, files, and directories; on-screen computer output |
Edit your .login file. Use ls -a to list all files. machine_name% you have mail. |
|
AaBbCc123 | What you type, contrasted with on-screen computer output |
machine_name% su Password: |
|
AaBbCc123 | Command-line placeholder: replace with a real name or value |
To delete a file, type rm filename. |
|
AaBbCc123 |
Book titles, new words, or terms, or words to be emphasized. |
Read Chapter 6 in User's Guide. These are called class options. You must be root to do this. |
Shell Prompts in Command Examples
The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.
Table P-2 Shell Prompts|
Shell |
Prompt |
|---|---|
| C shell prompt | machine_name% |
| C shell superuser prompt | machine_name# |
| Bourne shell and Korn shell prompt | $ |
| Bourne shell and Korn shell superuser prompt | # |
- © 2010, Oracle Corporation and/or its affiliates