Installation

Ask your system administrator to supply you with ChorusOS binary and source files. Once you have read the instructions in the ChorusOS 4.0 installation guides, install the source files and the AnswerBook documentation.

Your Source PATH

Depending on your target family, you will use different source code products. Each product has different installation directories. See ChorusOS 4.0 Target Family Documentation Collection for further details. The default PATH for a source package is:

/opt/SUNWconn/SEW/4.0/chorus-<family>/src

where each family is a group of processors, such as PowerPC. This will be your source directory, referred to in this document as <src_dir>.

---

Note -

For your convenience, create an environment variable to shorten your source PATH.

---

Source File Organization

You receive source packages in read-only mode. The fact that the source files are kept in the source directory, separate from your work directory, has the following advantages

• It prevents the source code from being corrupted during a build.

• It allows you to generate configurations for different targets.

• It permits several users to use the same source code simultaneously.

If you need to modify the source code, use your own copy of the initial source package that you received.

Which Family, Target and Profile

Table 2-1 gives the profile and board dependent components (such as BSP, boot and family specific driver code) to be used with the configure command. The PATHs are given relative to <src_dir>.

Table 2-1 List of board dependent components

Paths	Component
PowerPC Board
nucleus/ppc60x/ppc60x	profile
nucleus/bsp/powerpc/genesis2	bsp
nucleus/bsp/powerpc	driver family
MCP750 board
nucleus/ppc60x/ppc60x	profile
nucleus/bsp/powerpc/mcp750	bsp
nucleus/bsp/powerpc	driver family
SBC8260 board
nucleus/mpc8260/mpc8260	profile
nucleus/bsp/powerpc/sbc8260	bsp
nucleus/bsp/powerpc	driver family
MPC860 board
nucleus/mpc860/mpc860	profile
nucleus/bsp/powerpc/mpc8xxADS	bsp
nucleus/bsp/powerpc	driver family
CP1500 board
nucleus/usparc/usparc	profile
nucleus/bsp/usparc/cp1500	bsp
nucleus/bsp/usparc	driver family
i386AT board
nucleus/x86/x86	profile
nucleus/bsp/x86/i386at	bsp
nucleus/bsp/x86	driver family

All examples given in this document are for the PowerPC family and the genesis2 board. For further information on the family and board that you are using, refer to the ChorusOS 4.0 Target Family Documentation Collection.

Which Components

Table 2-2 lists the main source components in a ChorusOS source delivery and the associated directories which are created in your source directory during the installation process.

Table 2-2 Source components in a ChorusOS 4.0 delivery and the associated files.

Component	Directory	Description
NUCLEUS	<src_dir>/nucleus	generic kernel code + family profiles
DRV	<src_dir>/nucleus/bsp/drv	generic kernel drivers
DRV_F	<src_dir>/nucleus/bsp/<family>	family specific drivers
BSP	<src_dir>/nucleus/bsp/<family>/<target>	board specific boot code (BSP)
OS	<src_dir>/os	Operating System (network, POSIX)
IOM	<src_dir>/iom	I/O Manager, (drivers, file systems, IP protocol stacks)