Preface

This book introduces the features and components of Sun Embedded Workshop^TM and the ChorusOS^TM operating system. It explains how to use Sun Embedded Workshop and how to create an application that runs on the ChorusOS operating system.

Who Should Use This Book

Use this book if you are using Sun Embedded Workshop to develop an application that runs on a ChorusOS operating system. This book is also useful if you are evaluating Sun Embedded Workshop and the ChorusOS operating system.

Before You Read This Book

This book assumes that you have:

• A general understanding of embedded operating systems

• Knowledge of the C programming language (for Part III)

How This Book is Organized

Part I introduces the product and its components, and explains how the product can be used.

• Chapter 1, Technical Overview contains an overview of the product.

Part II explains how to use the ChorusOS operating system.

• Chapter 2, Using ChorusOS explains the use of the ChorusOS operating system.

• Chapter 3, Configuring and Tuning explains how to configure and tune a ChorusOS operating system.

Part III describes how to develop an application that runs on the ChorusOS operating system.

• Chapter 4, Programming Overview is an overview of the tasks involved in developing an application.

• Chapter 5, Using Actors explains how actors are used in an application.

• Chapter 6, Multithreaded Programming with the ChorusOS Operating System explains to how use the multithreading services provided in the ChorusOS operating system.

• Chapter 7, Memory Management explains how to use the memory management services provided in the ChorusOS operating system.

• Chapter 8, Inter-actor Communication explains how to use the inter-actor communication services provided in the ChorusOS operating system.

• Chapter 9, Time Management explains how to use the time management services provided in the ChorusOS operating system.

Part IV describes debugging and performance profiling on the ChorusOS operating system.

• Chapter 10, System and Application Debugging explains how to debug the ChorusOS operating system and applications.

• Chapter 11, Performance Profiling explains how to analyze the performance of the ChorusOS operating system and its applications by generating a performance profile report.

The Glossary is a list of words and phrases found in this book and their definitions.

Related Books

ChorusOS 4.0 Installation Guide explains how to download and install Sun Embedded Workshop. ChorusOS Release Notes contains information about new features and restrictions in this release of the product.

See the appropriate document in the ChorusOS 4.0 Target Family Documentation Collection for instructions explaining how to build and run the ChorusOS operating system on supported hardware.

The following books describe how to use Sun Embedded Workshop components:

• ChorusOS 4.0 File System Administration Guide explains how to use the file systems provided with the ChorusOS operating system. It includes information about using the NFS server.

• ChorusOS 4.0 Network Administration Guide explains how to use the networking capabilities of the ChorusOS operating system.

The Mentor Graphics Corporation XRAY Debugger for ChorusOS includes documentation explaining how to debug a ChorusOS application. XRAY is the reference debugger for use with the ChorusOS operating system.

The following books contain information about advanced programming with Sun Embedded Workshop:

• ChorusOS 4.0 Porting Guide explains how to port the ChorusOS operating system to another target board.

• ChorusOS 4.0 Device Driver Framework Guide describes the device driver architecture of the ChorusOS operating system and explains how to add a new driver.

• The ChorusOS 4.0 Hot Restart Programmer's Guide describes how to develop applications to use the hot restart functionality of the ChorusOS operating system.

• ChorusOS 4.0 Flash Guide describes the support for flash memory provided in the ChorusOS operating system and explains how to use it.

• ChorusOS 4.0 Production Guide describes the organization of the source code and explains how to use it.

Ordering Sun Documents

Fatbrain.com, an Internet professional bookstore, stocks selected 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.com^SM 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

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	#