perf.c File Reference

#include <stdio.h>
#include <assert.h>
#include "defines.h"
#include "perf.h"
#include "util.h"
#include "expr.h"

Functions
static perf_stat *	perf_gen_stats (func_unit *funit)
static void	perf_output_mod_stats (FILE *ofile, func_unit *funit)
static void	perf_output_inst_report_helper (FILE *ofile, funit_inst *root)
void	perf_output_inst_report (FILE *ofile)
Variables
db **	db_list
unsigned int	curr_db

---

Detailed Description

Author:

Trevor Williams (phase1geo@gmail.com)

Date:

1/1/2006

---

Function Documentation

static perf_stat* perf_gen_stats

(

func_unit *

funit

)

[static]

Returns:

Returns a pointer to the perf_stat structure containing the performance statistics for the given functional unit

Allocates and initializes the contents of a performance structure to display the total number of expressions in the given functional unit and the number of times these expressions that were executed during simulation.

Parameters:

funit

Pointer to functional unit to generate performance statistics for

References expression_s::exec_num, exp_link_s::exp, func_unit_s::exp_head, EXP_OP_NUM, malloc_safe, exp_link_s::next, expression_s::op, perf_stat_s::op_cnt, perf_stat_s::op_exec_cnt, PROFILE, and PROFILE_END.

Referenced by perf_output_mod_stats().

  { PROFILE(PERF_GEN_STATS);

  exp_link*  expl;   /* Pointer to current expression link */
  perf_stat* pstat;  /* Pointer to newly created performance stat structure */
  int        i;      /* Loop iterator */

  /* Create and initialize new perf_stat structure */
  pstat = (perf_stat*)malloc_safe( sizeof( perf_stat ) );
  for( i=0; i<EXP_OP_NUM; i++ ) {
    pstat->op_exec_cnt[i] = 0;
    pstat->op_cnt[i]      = 0;
  }

  /* Populate performance structure */
  expl = funit->exp_head;
  while( expl != NULL ) {
    pstat->op_cnt[expl->exp->op]      += 1;
    pstat->op_exec_cnt[expl->exp->op] += expl->exp->exec_num;
    expl = expl->next;
  }

  PROFILE_END;

  return( pstat );

}

void perf_output_inst_report

(

FILE *

ofile

)

Generates a performance report on an instance basis to the specified output file.

Parameters:

ofile

File to output report information to

References curr_db, inst_link_s::inst, db_s::inst_head, inst_link_s::next, perf_output_inst_report_helper(), PROFILE, and PROFILE_END.

Referenced by command_score().

  { PROFILE(PERF_OUTPUT_INST_REPORT);

  inst_link* instl;  /* Pointer to current instance link */

  fprintf( ofile, "\nSIMULATION PERFORMANCE STATISTICS:\n\n" );

  instl = db_list[curr_db]->inst_head;
  while( instl != NULL ) {
    perf_output_inst_report_helper( ofile, instl->inst );
    instl = instl->next;
  }

  PROFILE_END;

}

static void perf_output_inst_report_helper	(	FILE *	ofile,
		funit_inst *	root
	)			[static]

Called by the perf_output_inst_report function to output a performance report on an instance basis.

Parameters:

	ofile	File to output report information to
	root	Pointer to current functional unit instance to output performance stats for

References funit_inst_s::child_head, funit_inst_s::funit, funit_inst_s::next, perf_output_mod_stats(), PROFILE, and PROFILE_END.

Referenced by perf_output_inst_report().

  { PROFILE(PERF_OUTPUT_INST_REPORT_HELPER);

  funit_inst* curr;  /* Pointer to current child instance to output */

  if( root != NULL ) {

    perf_output_mod_stats( ofile, root->funit );

    curr = root->child_head;
    while( curr != NULL ) {
      perf_output_inst_report_helper( ofile, curr );
      curr = curr->next;
    }

  }

  PROFILE_END;

}

static void perf_output_mod_stats	(	FILE *	ofile,
		func_unit *	funit
	)			[static]

Outputs the expression performance statistics to the given output stream.

Parameters:

	ofile	Pointer to file to output performance results to
	funit	Pointer to functional unit to output performance metrics for

References EXP_OP_NUM, expression_string_op(), get_funit_type(), func_unit_s::name, perf_stat_s::op_cnt, perf_stat_s::op_exec_cnt, perf_gen_stats(), PROFILE, PROFILE_END, and func_unit_s::type.

Referenced by perf_output_inst_report_helper().

  { PROFILE(PERF_OUTPUT_MOD_STATS);

  perf_stat* pstat;     /* Pointer to performance statistic structure for this funit */
  int        i;         /* Loop iterator */
  float      avg_exec;  /* Calculated average execution count for the current expression op */

  /* Get performance structure */
  pstat = perf_gen_stats( funit );

  /* Output the structure */
  fprintf( ofile, "  %s: %s\n", get_funit_type( funit->type ), funit->name );
  fprintf( ofile, "    ExpOp      Cnt      / Executed / Avg. Executed\n" );

  for( i=0; i<EXP_OP_NUM; i++ ) {
    if( pstat->op_exec_cnt[i] > 0 ) {
      avg_exec = pstat->op_exec_cnt[i] / pstat->op_cnt[i]; 
      fprintf( ofile, "    %-10.10s %-8.0f   %-8u   %-8.1f\n",
               expression_string_op( i ), pstat->op_cnt[i], pstat->op_exec_cnt[i], avg_exec );
    }
  }

  fprintf( ofile, "\n" );

  PROFILE_END;

}

---

Variable Documentation

unsigned int curr_db

Index of current database in db_list array that is being handled.

db** db_list

Array of database pointers storing all currently loaded databases.