Preface

The ChorusOS 4.0 Porting Guide explains how to adapt the ChorusOS operating system software to a different target board. It provides an overview of the architecture, enabling you to identify components that need to be changed so that the software can run on a different board. It also includes details of the tools provided to help you build a ported ChorusOS operating system, and a summary of the interfaces that you will use.

Who Should Use This Book

Use this book if you are developing a ChorusOS operating system to run on a target for which a reference implementation is not available.

Before You Read This Book

Before you read this book you must read the ChorusOS 4.0 Introduction, which introduces the features and components of the Sun Embedded Workshop and the ChorusOS operating system. It explains how to use Sun Embedded Workshop and how to create an application that runs on the ChorusOS operating system.

How This Book is Organized

"Rebooting a ChorusOS system" describes the low-level architecture of a ChorusOS operating system, and explains what you must do to create a board support package to enable the ChorusOS operating system to run on a new target.

Chapter 2, Building a ChorusOS System explains how to build a ChorusOS operating system image.

Chapter 3, Booting a ChorusOS System describes the boot architecture and explains how to create a boot procedure for your target.

Chapter 4, Rebooting ChorusOS explains how to write a reboot program for the ChorusOS operating system.

Chapter 5, System Image Configuration describes the syntax of the board-specific configuration file you must provide for your target.

Appendix B, Porting the Debug Agent explains how to port the debug agent.

Related Books

The ChorusOS 4.0 Introduction introduces the features and components of the ChorusOS operating system. It explains how to use ChorusOS and how to create an application that runs on the ChorusOS operating system.

ChorusOS 4.0 Installation Guide for Solaris Hosts explains how to download and install ChorusOS on a Solaris host.

ChorusOS 4.0 Installation Guide for Windows NT Hosts explains how to download and install ChorusOS on a Windows NT host.

The ChorusOS 4.0 Release Notes contain information about new features and restrictions in this release of the product.

The following books describe how to use ChorusOS components:

• ChorusOS 4.0 File Systems User's 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 various network protocols with the ChorusOS operating system, including the point-to-point protocol (PPP) and the serial line internet protocol (SLIP).

The Mentor Graphics XRAY Debugger for the ChorusOS operating system includes documentation explaining how to debug a ChorusOS operating system application. XRAY is the recommended debugger for use with ChorusOS systems, though other debuggers can be used.

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

• 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.

• ChorusOS 4.0 Hot Restart Programmer's Guide describes the support for hot restart provided in the ChorusOS operating system and explains how to use it.

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.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://docs.sun.com.

What Typographic Conventions Mean

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	#