Pkit.h

In order to ease the introduction of further programs into PetaKit, a generalized header for data output is under construction.

• Generalize output
  • Allow a variable number of arguments (va_arg and all that jazz) and let the programmer specify what he or she wants to see (for debug purposes)
  • Arguments that stat.pl expects to see are required:
    • Program name - currently stat.pl expects this to be in name_parallelization style format.
      • This is a duplication of information (see architecture), but it may be better than the alternative, which is to try and fit all four styles into the same program with preprocessor commands
    • Program version - I see people updating this once and forgetting to update it again. It can't hurt, though
    • Hostname - currently goes through a filter to identify it as being from a list of known clusters.
    • Threads
    • cputime - most challenging to implement. With high repetitions Walltime is nearly as accurate. I recommend we cut.
    • architecture - Parallelization style
    • problem_size - The main "dial"
      • In area this is segments
      • In GalaxSee this is stars
• Because people may want to equip C or C++ programs, account for the fact that cout and printf do not play nicely together.
  • The library detects C or C++ in the preprocessor stage and uses printf or cout respectively.