man/man1/profile.1

   1 .TH PROFILE 1
   2 .SH NAME
   3 profile \- MINIX system profiling control command
   4 .SH SYNOPSIS
   5 Statistical profiling:
   6 .PP
   7 .B "profile start"
   8 [
   9 .B -m
  10 .I memsize
  11 ]
  12 [
  13 .B "-o"
  14 .I outfile
  15 ]
  16 [
  17 .B -f
  18 .I frequency
  19 ]
  20 .br
  21 .B "profile stop "
  22 .br
  23 .B "sprofalyze.pl"
  24 .PP
  25 Call profiling:
  26 .PP
  27 .B "profile get"
  28 [
  29 .B "-m"
  30 .I memsize
  31 ]
  32 [
  33 .B "-o"
  34 .I outfile
  35 ]
  36 .br
  37 .B "profile reset"
  38 .br
  39 .B "cprofalyze.pl"
  40 .SH DESCRIPTION
  41 This command controls MINIX system profiling. There is support for
  42 statistical profiling, which causes a CMOS interrupt to regularly sample
  43 the position of the program counter, and call profiling, which uses
  44 compiler hooks to measure the time and frequency of call paths.
  45
  46 For statistical profiling support, recompile the kernel with SPROFILE in
  47 <minix/config.h> set to 1. For call profiling support, recompile the
  48 system with new libraries with CPROFILE <minix/config.h> set to 1 and
  49 environment variable CPROFILE set to -Rcem-p.
  50 .SH OPTIONS
  51 .IP start
  52 start measuring using statistical profiling.
  53 .IP stop
  54 stop measuring using statistical profiling.
  55 .IP get
  56 retrieve call profiling data
  57 .IP reset
  58 reset call profiling data
  59 .IP "-m"
  60 memory buffer size used to store profiling data in, allocated by the
  61 profile command.
  62 .IP "-o outfile"
  63 output file.
  64 .IP "-f frequency"
  65 frequency for statistical sampling.
  66 .PP
  67 After you have the output file, analysis can be done using the
  68 .B sprofalyze.pl
  69 and
  70 .B cprofalyze.pl
  71 commands.
  72 .SH AUTHOR
  73 Rogier Meurs