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.
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.
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 | # |
- © 2010, Oracle Corporation and/or its affiliates