This is -*- text -*-

This file gives some notes to users interesting in porting this
program to other machines.

Porting this program is not as trivial as with most programs.  It is
dependent on several system specific features.

1) Creating the bmon.out file.  The system specific part of bmon.cc
should all be in the arch/*.h files.  There are two features that end
up in these header files.

a) The start and end of the text segment.

b) How to get the instruction pointer from within a signal handler.

Neither are guaranteed to be possible or documented.  The great thing
with Linux is that you can read the source to find out the details.
Not so with all those proprietary operating systems.  I've provided a
few header files, you can use those as examples for others.  Those for
Linux, HPUX and AIX seem to work (the timing works, running the bprof
program probably doesn't work), the Solaris one probably doesn't as I
have no Solaris machine to test it on.

2) Reading the executable file.  To do this portably, I've used the
GNU bfd library.  However, it does not provide all the necessary
functionality for all systems.  It works on Linux, but I don't know
about other systems.  The bfd library is released as part of gdb and
as part of the GNU binutils.  Unfortunately it is not distributed
separately and it tends to be somewhat unclear what the latest release
is.
