ChorusOS 4.0 Introduction


This book introduces the features and components of Sun Embedded WorkshopTM and the ChorusOSTM 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:

How This Book is Organized

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

Part II explains how to use the ChorusOS operating system.

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

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

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:

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:

Ordering Sun Documents, 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 at

Accessing Sun Documentation Online

The docs.sun.comSM Web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject. The URL is

Typographic Conventions

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions

Typeface or Symbol 




 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.


 What you type, contrasted with on-screen computer outputmachine_name% su Password:


 Command-line placeholder: replace with a real name or value

To delete a file, type rm filename.


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



 C shell promptmachine_name%
 C shell superuser promptmachine_name#
 Bourne shell and Korn shell prompt$
 Bourne shell and Korn shell superuser prompt#