4. File and Directory Naming Conventions

Throughout this Guide, we refer to various files and directories, the precise location of which depends on how and where things were built and installed. All such references will be based on a few key directory locations, which will be determined when you build and install the software (Appendix B, Building the CCA Tools and TAU, and Setting Up Your Environment and Appendix C, Building the Tutorial and Student Code Trees). Wherever appropriate, we will write these as environment variables, so that the text in the Guide can simply be pasted into your shell session (assuming your login environment is setup as suggested in Section B.4, “Setting Up Your Login Environment”).

[Warning] Warning

Note that tools such as the Ccaffeine framework do not expand environment variables. In these cases, you'll need to type in the complete path, substituting the placeholder (i.e. “TUTORIAL_SRC”) with the actual path.

If you're participating in an organized tutorial, you will be given information separately about the particular paths corresponding to these locations.

CCA_TOOLS_ROOT ($CCA_TOOLS_ROOT)

The installation location of the CCA tools. (See Section B.1, “The CCA Tools”.)

TAU_ROOT ($TAU_ROOT)

The installation location of the TAU Portable Profiling package. (See Section B.3, “Downloading and Installing TAU”.)

TAU_CMPT_ROOT ($TAU_CMPT_ROOT)

The installation location of the TAU performance component. (See Section B.3, “Downloading and Installing TAU”.)

TUTORIAL_SRC ($TUTORIAL_SRC)

The location that the tutorial-src-version.tar.gz file was unpacked and built. (See Appendix C, Building the Tutorial and Student Code Trees.)

STUDENT_SRC ($STUDENT_SRC)

The location that the student-src-version.tar.gz file was unpacked and built. (See Appendix C, Building the Tutorial and Student Code Trees.)