


bspsig(1)                 User Commands                 bspsig(1)



NAME
     bspsig - Generate a signature from a BSP profile


SYNOPSIS
     bspsig [-v] [-help] [-wfm] [-sig]  [-stat]  [-sort  _k_e_y]  [-
     bucket  _s_i_z_e]  [-compress  _s_i_z_e]  [-ignore _p_e_r_c_e_n_t_a_g_e] [-slg
     _b_s_p-_p_a_r_a_m_e_t_e_r_s] _f_i_l_e_n_a_m_e


DESCRIPTION
     Generate a profile and cost signature  for  the  trace  file
     _f_i_l_e_n_a_m_e.  Trace  files are generated by adding the option -
     _p_r_o_f 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 _s_i_z_e
          The profiler generates  an  entry  for  each  different
          sized  h-relation  generated by the same textual super-
          step. The -_b_u_c_k_e_t option, combines h-relations from the
          same superstep that are _s_i_z_e apart.

     -compress _s_i_z_e
          This option repeatedly compresses the size of the  pro-
          file until at most _s_i_z_e entries remain.

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

     -_w_f_m  Use an alternative format for displaying the output.

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


     -_s_t_a_t
          Prints the following accumulated h-relation statistics:

          _M_a_x _s_u_p_e_r_s_t_e_p_s
               the normal BSP interpretation of h-relation cost;




Oxford BSP Toolset  Last change: 1.4 25/9/98                    1






bspsig(1)                 User Commands                 bspsig(1)



          _M_a_x _a_s_y_n_c
               costs the comunication as though the  program  was
               running with no superstep structure;

          _V_o_l_u_m_e
               costs average h-relation size in each superstep;

          _M_i_n _a_s_y_n_c
               minimum total communication by any processor;

          _M_i_n _s_u_p_e_r_s_t_e_p_s
               costs mimimum h-relation size in each superstep.


     -slg _s,_l,_g[,_n_h_a_l_f]
          When generating the profile, the options to  - _s_l_g  are
          numbers which represent the BSP parameters:

          _s    is the _M_e_g_a_f_l_o_p/_s rating for the machine.

          _l    the minimum number of flops  for  a  barrier  syn-
               chronisation.

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

          _n_h_a_l_f
               the number of words required for the communication
               performance to deteriorate to 2g.
     See _b_s_p_p_a_r_a_m(_1) for information concerning the BSP parameter
     database.

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

          _c_o_m_m_t_h_e_o_r_y
               Theoretical communication cost  [default].

          _h_r_e_l Size of h-relation.

          _s_y_n_c_s
               The number of times  a  particular  superstep  was
               executed.

          _c_o_m_m_r_e_a_l
               The actual communication cost.

          _d_e_l_t_a
               The difference between the theoretical and  actual
               communication costs.




Oxford BSP Toolset  Last change: 1.4 25/9/98                    2






bspsig(1)                 User Commands                 bspsig(1)



          _c_o_m_p_t_i_m_e [or _w]
               Computation time.

          _r_c_o_m_p_t_h_e_o_r_y
               Ratio of computation to theoretical  communication
               cost.

          _r_c_o_m_p_r_e_a_l
               Ratio of computation to actual communication time.

          _w/_h  Ratio of work to h-relatin size

          _w/_s_y_n_c_s
               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:
     _h_t_t_p://_w_w_w._b_s_p-_w_o_r_l_d_w_i_d_e._o_r_g/_i_m_p_l_m_n_t_s/_o_x_t_o_o_l/


BUGS
     Problems  and  bug  reports  should  be  mailed  to  _b_s_p_l_i_b-
     _b_u_g_s@_c_o_m_l_a_b._o_x._a_c._u_k


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

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






















Oxford BSP Toolset  Last change: 1.4 25/9/98                    3



