Distribution Guide Structural information

Structural information

This section describes the hierarchical directory structure of the installation files used by the distribution.

All the RPMs install their files in a directory, the root of which is
/opt/STM/STLinux-2.0.

All files and directory used in this section are assumed to be relative to this directory. The structure of this directory is:

<root>
  |---- config
  |   |---- rpm
  |---- devkit
  |   |---- kernel
  |   |   |---- kernel-sh4-*
  |   |   |---- kernel-st231-*
  |   |   |---- linux-sh4-2.6.*
  |   |   |---- linux-st231-2.6.*
  |   |   |---- lirc-*
  |   |   |---- stgfb-*
  |   |---- sh4
  |   |   |---- bin
  |   |   |---- target
  |   |---- st321
  |   |   |---- bin
  |   |   |---- target
  |   |---- u-boot
  +---- host

Directory contents

config/rpm

The files in this directory are only required if users want to build the ST Linux distribution binary RPMs from the SRPMs (source RPMs) for some reason. The directory includes a README file which provides further information about the files in this directory.

devkit

This directory is the known as the "development kit" as it contains the bulk of the files needed to build and run a Linux system on a target board.

devkit/kernel

This directory contains the Linux kernels in both binary and source forms. The binary form has a pre-built kernel which is specific to each supported board. The source form is a directory of the expanded source files, which are patched for each supported architecture.

devkit/kernel/kernel-sh4-*

This directory contains a set of pre-built Linux kernel binaries, one for each supported board which uses the ST40 core CPU.

devkit/kernel/kernel-st231-*

This directory contains a set of pre-built Linux kernel binaries, one for each supported board which uses the ST231 core CPU.

devkit/kernel/linux-sh4-2.6.*

This directory contains the sources for the ST40 Linux kernel. One single source directory is provided, with the sources for all supported ST40 boards.

devkit/kernel/linux-st231-2.6.*

This directory contains the sources for the ST200 Linux kernel. One single source directory is provided, with the sources for all supported ST231 boards.

devkit/kernel/lirc-*

This directory contains the source for the LIRC (Linux Infra-Red Controller) system
used in the ST Linux distribution.

devkit/kernel/stgfb-*

This directory contains the source for the ST Graphics Frame Buffer driver used in the ST Linux distribution.

devkit/sh4

This directory contains all the tools, headers, libraries and documentation which are required to cross-build all ST40 target Linux applications and kernels from x86 host machines.

Also included is this directory is a pre-built and ready to use root file system for an ST40 target Linux system, which should be made available using NFS.

devkit/sh4/bin

This directory contains all the x86 host binaries, which are used to cross-build binaries (both user application, and the kernel itself) for ST40 Linux. The name of this directory should be appended to the PATH environment variable for ease of use.

devkit/sh4/target

This directory is a self contained root file system for an ST40 Linux system. In a normal development system NFS will be used to export this directory from the host system and mount it as the root file system of the target system.

devkit/st231

This directory contains all the tools, headers, libraries and documentation which are required to cross-build all ST231 target Linux applications and kernels from x86 host machines.

Also included in this directory is a pre-built and ready to use root file system for an ST231 target Linux system, which should be made available using NFS.

devkit/st231/bin

This directory contains all the x86 host binaries, which are used to cross-build binaries (both user application, and the kernel itself) for ST231 Linux. The name of this directory should be appended to the PATH environment variable for ease of use.

devkit/st231/target

This directory is a self contained root file system for an ST231 Linux system. In a normal development system NFS will be used to export this directory from the host system and mount it as the root file system of the target system.

devkit/u-boot

This directory contains the sources of the Flash-based U-Boot download tool.

host

This directory contains numerous tools to be run on the host system, for help in configuring the target Linux system. Some of these tools may be included in your existing host system, but are included here for completeness. It includes:

• tools to build file systems for the targets,

• tools to configure and build the SRPMs (the "auto" tools),

• tools to manage Flash devices, and

• make version 3.80 which is required by some packages.