Preface

The ChorusOS 4.0 Production Guide explains how to use the source code for the ChorusOS^TM product to generate an instance of the ChorusOS operating system.

Who Should Use This Book

Use this guide:

• To use a source version of the ChorusOS operating system.

• To see how the Input/Output Manager (IOM) component is built.

This book describes:

• How to perform standard system generation.

• The use of development tools to customize your system.

• Adding source components built with the development tools.

• Configuration of your operating system.

Before You Read This Book

To get the most information from this book you should have already read:

• ChorusOS 4.0 Introduction

• ChorusOS 4.0 Installation Guide for Solaris Hosts

• ChorusOS 4.0 Installation Guide for Windows NT Hosts

• The following man pages: make(1S), m4(1), mkmerge(1CC), configure(1CC), ChorusOSMkMf(1CC), and configurator(1CC).

How This Book Is Organized

Chapter 1, Introduction lists the utilities you must have on your system before using the ChorusOS product and also lists the tools, utilities and files you are provided with.

Chapter 2, System Generation gives specific information for the installation of ChorusOS source code, and outlines how to generate a ChorusOS system image.

Chapter 3, Building with imake provides a brief introduction to the imake development tool. Further details are available in the ChorusOS 4.0 Introduction.

Chapter 4, Building with mkmk provides an introduction to the building rules of the mkmk tool and a description of the merge method, using mkmerge(1CC), which permits the selection of a subset of the source code, for example, the family dependent code.

Chapter 5, Creating a ChorusOS Component describes how to create and add a ChorusOS component to your system, built with the mkmk or the imake tool. You are guided through an example which is provided in the form of a tutorial.

Chapter 6, Customization supplies information on the customization of your system production by adding features and tunables managed by the configurator(1CC) command and the ews graphical configuration tool.

Chapter 7, XML Syntax contains details of the XML syntax of the ChorusOS product's configuration files.

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	#