DPROF(1)							      DPROF(1)

NAME    [Toc]    [Back]

     dprof - a memory access profiling tool

SYNOPSIS    [Toc]    [Back]

     dprof [-itimer [-ms n]]
     [-hwpc [-cntr  n] [-ovfl n]]
     [-pcmin min] [-pcmax max]
     [-damin min] [-damax max]
     [-page][-hex][-oct][-quad][-double][-int]
     [-out file] [-pout	dplace_file] [-threads_per_mem n]
     [-verbose]	command

DESCRIPTION    [Toc]    [Back]

     The given command is executed and memory accesses are sampled; after
     completion, dprof prepares	a histogram of memory accesses.	 Histograms
     are computed for each thread of multi-threaded applications that utilize
     sproc(2).

OPTIONS    [Toc]    [Back]

     -itimer
	  Use the interval timer as a sampling trigger.

     -ms n
	  Trigger every	n milliseconds.	The default is 10 milliseconds,	this
	  is also the minimum value. Any value of n less than 10 will result
	  in an	error.

     -hwpc
	  Use R10000 hardware event counter overflow as	a sampling trigger.

     -cntr n
	  Use R10000 hardware event counter n as the event trigger.  Default
	  is number of cycles; event 0.

     -ovfl n
	  Trigger after	n events have occurred.	 Default is 10,000.

     -pcmin min
	  Ignore events	that have a program counter smaller than min.

     -pcmax max
	  Ignore events	that have a program counter larger than	max.

     -damin min
	  Ignore memory	operations that	have a virtual addresses smaller than
	  min.





									Page 1






DPROF(1)							      DPROF(1)



     -damax max
	  Ignore memory	operations that	have a virtual addresses larger	than
	  max.

     -page
	  Use pagesize (16k bytes) granularity for memory access sampling.

     -line
	  Use cache linesize (128 bytes) size granularity for memory access
	  sampling.

     -hex Use hex (64 bytes) size granularity for memory access	sampling.

     -oct Use oct (32 bytes) size granularity for memory access	sampling.

     -quad
	  Use quad (16 bytes) size granularity for memory access sampling.

     -double
	  Use double (8	bytes) size granularity	for memory access sampling.

     -int Use int (4 bytes) size granularity for memory	access sampling.

     -sigusr
	  Sampling is not started until	SIGUSR1	is received. Further SIGUSR1
	  signals toggle sampling off and on.

     -out file
	  Output is sent to file rather	than standard output.

     -pout dplace_file
	  Placement information	suitable for dplace(1) is written to
	  dplace_file.

     [-threads_per_mem n]
	  When building	dplace_file a thread assignment	that assumes n threads
	  per memory is	assumed.

EXAMPLE    [Toc]    [Back]

     To	collect	a memory access	histogram from a program called	a.out that
     would normally be run by
	% a.out	< in > out
     and place the resuls in a file called histogram one would simply
	% dprof	-out histogram a.out < in > out	.

DEPENDENCIES    [Toc]    [Back]

     dprof options -hwpc, -cntr	n and -ovfl n only apply to R10000 based
     systems.






									Page 2






DPROF(1)							      DPROF(1)

SEE ALSO    [Toc]    [Back]

     dplace(1),	sproc(2), r10k_counters(5)


									PPPPaaaaggggeeee 3333