Preface

The Oracle Solaris Studio 12.2 Debugging a Program With dbx manual gives instructions on how to use the dbx command-line debugger, an interactive source level debugging tool.

Note - This Oracle Solaris Studio release supports systems that use the SPARC and x86 families of processor architectures: UltraSPARC, SPARC64, AMD64, Pentium, and Xeon EM64T. The supported systems for the version of the Solaris operating system you are running are available in the hardware compatibility lists at http://www.sun.com/bigadmin/hcl. These documents cite any implementation differences between the platform types.

In this document, these x86 related terms mean the following:

“x86” refers to the larger family of 64–bit and 32–bit x86 compatible products.
“x64” points out specific 64–bit information about AMD64 or EM64T systems.
“32–bit x86” points out specific 32–bit information about x86 based systems.

For supported systems, see the hardware compatibility lists.

Who Should Use This Book

This book is designed for programmers who want to debug an application using dbx commands. Users of dbx need a working knowledge of Fortran, C, or C++, and some understanding of the Oracle Solaris operating system (Solaris OS) or the Linux operating system, and UNIX commands.

Accessing Oracle Solaris Studio Documentation

You can access the documentation at the following locations:

The documentation is available from the documentation index page at http://www.oracle.com/technetwork/server-storage/solarisstudio/documentation/index.html.
Online help for all components of the IDE is available through the Help menu, as well as through the F1 key, and through Help buttons on many windows and dialog boxes, in the IDE.
Online help for the Performance Analyzer is available through the Help menu, as well as through the F1 key, and through Help buttons on many windows and dialog boxes, in the Performance Analyzer.
Online help for dbxtool and DLight is available through the Help menus, as well as through the F1 key, and through Help buttons on many windows and dialog boxes in the tools.
Online help for dbxtool is available through the Help menu in dbxtool.

Documentation in Accessible Formats

The documentation is provided in accessible formats that are readable by assistive technologies for users with disabilities. You can find accessible versions of documentation as described in the following table.

Type of Documentation	Format and Location of Accessible Version
Manuals and tutorials	HTML from the Oracle Solaris Studio 12.1 collection on http://docs.sun.com
What's New in the Oracle Solaris Studio 12.2 Release (Information that was included in the component Readme files in previous releases)	HTML from the Oracle Solaris Studio 12.2 collection on http://docs.sun.com
Man pages	In the installed product through the `man` command
Online help	HTML available through the Help menu, Help buttons, and F1 key in the IDE, Performance Analyzer, DLight, and dbxtool.
Release notes	HTML from the Oracle Solaris Studio 12.2 collection on http://docs.sun.com

Related Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

Note - Oracle is not responsible for the availability of third-party web sites mentioned in this document. Oracle does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Oracle will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Typographic Conventions

The following table describes the typographic conventions that are used in this book.

Table P-1 Typographic Conventions

Typeface	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories, and onscreen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% you have mail.`
`AaBbCc123`	What you type, contrasted with onscreen computer output	`machine_name%` `su` `Password:`
`aabbcc123`	Placeholder: replace with a real name or value	The command to remove a file is `rm` `filename`.
AaBbCc123	Book titles, new terms, and terms to be emphasized	Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online.

Shell Prompts in Command Examples

The following table shows the default UNIX system prompt and superuser prompt for shells that are included in the Oracle Solaris OS. Note that the default system prompt that is displayed in command examples varies, depending on the Oracle Solaris release.

Table P-2 Shell Prompts

Shell	Prompt
Bash shell, Korn shell, and Bourne shell	`$`
Bash shell, Korn shell, and Bourne shell for superuser	`#`
C shell	`machine_name%`
C shell for superuser	`machine_name#`

Documentation, Support, and Training

See the following web sites for additional resources:

Documentation
Support
Training – Click the Sun link in the left navigation bar.

Oracle Welcomes Your Comments

Oracle welcomes your comments and suggestions on the quality and usefulness of its documentation. If you find any errors or have any other suggestions for improvement, go to http://docs.sun.com and click Feedback. Indicate the title and part number of the documentation along with the chapter, section, and page number, if available. Please let us know if you want a reply.

Oracle Technology Network offers a range of resources related to Oracle software:

Discuss technical problems and solutions on the Discussion Forums.
Get hands-on step-by-step tutorials with Oracle By Example.
Download Sample Code.

Skip Navigation Links
Exit Print View
	Oracle Solaris Studio 12.2: Debugging a Program With dbx