Chapter 10. ISS Source Tree

Table of Contents
Directory Structure
Building ISS
Behind the Scenes

The information in this chapter is included in the README file found in the top directory of an ISS distribution, usually /iss on an operational ISS workstation.

Directory Structure

This tree contains software, scripts, and other files which customize a Solaris workstation for running the ISS operating environment. The files and directories in the top directory are described below:

ImakefileThe Imakefile which generates the toplevel Makefile.
Project.tmplThe imake config file with settings specific to ISS.
Zebra.tmplA link created by issmkmf to Zebra's Project.tmpl.
configsThe zebra project directories, plot descriptions, and Campbell download files.
doc/Documentation.
etc/Configuration files and scripts which supercede and extend similar system files.
home/Home directories for users iss, issadmin, and root.
src/Source directories for ISS programs.
scripts/ISS script utilities.
lib/Installed location of ISS software libraries.
bin/Installed location of executable binaries and links to scripts.
share/Directory created by the build process to share header files among software source directories.

The /iss/etc/ directory is organized similarly to the system /etc directory, with an init.d directory for scripts and files which take the place of their equivalent system files. The ISS configuration script takes care of placing links in the system /etc tree to the corresponding files in the /iss/etc tree. For example, /etc/hosts is a link to /iss/etc/hosts. Likewise, a link in /etc/rc3.d to /iss/etc/init.d/root.iss is the ISS hook to starting up its subsystems by running the scripts in /iss/etc/init.d.