This directory contains primarily the host-dependent codes for DDS including the common make files and associated scripts.

${DDSROOT}/src/lib/host: Generates the libchost.a and libfhost.a libraries for building DDS applications; and dds-set-path support script for application executions.

Go to the Doxygen for automatically generated documentation. Doxygen documentation was generated on a LX26x86_64-4 machine with the gnu compiler.

• Local files & directories:
  • 15 source files (2601 lines of code)
  • architecture-dependent subdirecties containing the working build files
  • Makefile - includes other makefiles & defines architecture Makefile
  • Makefile2 - host architecture-dependent makefile information
  • MakeMacro - common info that get cat'd into MakeSrcMacro & MakeArchMacro
  • mklog - subdirectory of logs generated by the make files
• Make files installed into ${DDSROOT}/etc :
  • MakeSrcMacro - make macro definitions
  • MakeSrcRules - make rules
  • MakeArchMacro - make architecture-dependent macro definitions
  • MakeArchRules - make architecture-dependent rules
  • MakeVariables - make definitions for building applications
  • MakeRules - make rules for building applications
• Utility scripts that get installed into ${DDSROOT}/bin:
  • ddsbincopy - script used by MakeRules to copy application startup script into ${DDS_DIST}/bin (NOTE: it will generate an application startup script if it does not already exist)
  • ddsmancopy - script used by MakeRules to copy application man page into ${DDS_DIST}/man/mbs/man1
  • ddsexecopy - script used by MakeRules to copy built application executable into architecture-dependent directory under ${DDS_DIST}
  • HostDir - script used by MakeMacro & MakeRules to get architecture-dependent information
  • HostComp - script used by MakeMacro & MakeRules to get compiler information
  • HostMP - script used by MakeMacro & MakeRulesto get OpenMP & MPI availability & information
  • chkhost - script to check if a remote machine is alive
  • gethosts - script to check which remote machines to build on
  • makeremotes - script to make on all remote machines
  • makebinscript - script to generate a startup script
  • dds2man - script to generate a template manpage
• Application scripts that gets installed into ${DDS_DIST}/bin:
  • dds-set-path - script called by each application startup script to determine at runtime which executable binary to use for the current architecture and sets up some other environment variables
• Libraries that gets installed under ${DDSROOT}/lib:
  • libchost.a - "C" API host-dependent routines
  • libfhost.a - Fortran API host-dependent routines
• Include files that gets installed under ${DDSROOT}/include:
  • chost.h - host-dependent include file used to build other DDS routines

Host Utilities:

There are several host utilities to assist in configuring DDS for a specific host machine when and if need be.

• cdefine - check various definitions
• ctest1 - "Hello World"
• ctest2 - check various compiler variable sizes
• ctestargcv - test setargcv
• ctypes - check various compiler characteristics
• Ftest1 - test the Fortran linkage & command line arguments