bspsig(1)

NAME
bspsig - Generate a signature from a BSP profile

SYNOPSIS
bspsig [-v] [-help] [-wfm] [-sig] [-stat] [-sort key] [ -bucket size] [ -compress size] [ -ignore percentage] [ -slg bsp-parameters] filename

DESCRIPTION
Generate a profile and cost signature for the trace file filename . Trace files are generated by adding the option -prof when compiling BSPlib programs with bspfront(1) .

OPTIONS

-v  Print (on standard error output) the phases involved in the execution of the profiler. The option also prints the version number of the profiler.

-help
    Print this manual page on standard output.

-bucket size
    The profiler generates an entry for each different sized h-relation generated by the same textual superstep. The -bucket option, combines h-relations from the same superstep that are size apart.

-compress size
    This option repeatedly compresses the size of the profile until at most size entries remain.

-ignore percent
    Ignore all cost centres for which both the computation and communication account for less then percent of the total cost.

-wfm
    Use an alternative format for displaying the output.

-sig
    Similar to -wfm except entries with the same h-relation size are merged. Use an alternative format for displaying the output.

-stat
    Prints the following accumulated h-relation statistics:

    Max supersteps
        the normal BSP interpretation of h-relation cost;

    Max async
        costs the comunication as though the program was running with no superstep structure;

    Volume
        costs average h-relation size in each superstep;

    Min async
        minimum total communication by any processor;

    Min supersteps
        costs mimimum h-relation size in each superstep.

-slg s,l,g[,nhalf]
    When generating the profile, the options to -slg are numbers which represent the BSP parameters:

    s   is the Megaflop/s rating for the machine.

    l   the minimum number of flops for a barrier synchronisation.

    g   the asymptotic number of flops required for all processors to communicate a single 32bit word to another process.

    nhalf
        the number of words required for the communication performance to deteriorate to 2g.
See bspparam(1) for information concerning the BSP parameter database.

-sort key
    The profile is sorted using key ; where key is one of:

    commtheory
        Theoretical communication cost [default].

    hrel
        Size of h-relation.

    syncs
        The number of times a particular superstep was executed.

    commreal
        The actual communication cost.

    delta
        The difference between the theoretical and actual communication costs.

    comptime [or w]
        Computation time.

    rcomptheory
        Ratio of computation to theoretical communication cost.

    rcompreal
        Ratio of computation to actual communication time.

    w/h Ratio of work to h-relatin size

    w/syncs
        Ratio of work to number of synchronisations.

SEE ALSO
bsplib(3), bspfront(1), bsparch(1) The Oxford BSP toolset web pages can be found at:
http://www.bsp-worldwide.org/implmnts/oxtool/

BUGS
Problems and bug reports should be mailed to bsplib-bugs@comlab.ox.ac.uk

AUTHORS
Jonathan.Hill@comlab.ox.ac.uk

http://www.comlab.ox.ac.uk/oucl/people/jonathan.hill.html