Hieronymus is a simple statistical profiler that looks periodically which 
process is running over a given delay (it reads the PC each time a regular 
timing interrupt happens). Then it gives percentages and can find which 
functions were running.

I am very interested in tests, benchmarks and profiling. In the company I work 
for, I do that job and it helps in my Amiga developments but we were missing 
profiling tools. Having used oprofile on Linux, I found that it was very 
useful (for example porting and optimizing DosBox for AmigaOS4) and I started 
to write Hieronymus with the same global idea in mind.

The name of this program comes from the inspector name in the Michael 
Connelly's books : Hieronymus Bosch, also called Harry. I love these books and 
the main character.

This is my first program available only for OS4 because it uses functions 
that are only available on this system. I would like to thank the OS4 team
to provide these low-level functions !


Is Hieronymus useful ?
----------------------
I hope so ! It will tell to developers where time is spent in their programs.
For example, it could be use with big applications or games to find which 
functions are time consuming to know what can be optimized.
That could show surprises !


Options
-------
- NOGUI/S : Users may prefer to see the log in the console (not available yet)
- DURATION/K/N : In seconds, default is 5, max is 20

If no process is currently eating CPU power (all processes are in idle state), 
all samples will show an offset in the kernel (Kickstart/kernel).


Features
--------
- Display profiling information with program and function names
- Provide text mode, full results and summary
- Each run in text mode can be stopped by CTRL-C
- Register to AmiUpdate


History
--------

Version 0.20 (2012-11-09 "Bourbon release")
- Removed use of performance counters that had no real value
- Added a check of the platform, to see if it is able to profile, to avoid
  a crash. Huge thanks to Max Tretene who fixed the interrupt problem on
  Sam boards, it will be available in a system update, after the Update 5.
- Found how to find the full path of a process started from the shell, with
  no absolute path. The following message should not appear anymore:
  "No info found (wrong file type / offset, program path not found, ...)"

Version 0.16 (2010-01-11 "birthday release")
- Added use of the performance monitor unit of G3/G4 processors to report 
cache misses
- Factorized hits grouped by functions (output improvement)
- Handled base address that made some symbols not found due to wrong offsets
- Fixed symbol search that gave wrong function names in the kernel module 
(now consider only symbols related to functions)

Version 0.10 (2009-12-30)
- Display profiling information with program and function names
- Provide text mode, full results and summary
- Each run in text mode can be stopped by CTRL-C
- Register to AmiUpdate