mirror of
https://github.com/Mercury-Language/mercury.git
synced 2025-12-19 07:45:09 +00:00
Estimated hours taken: 40 (+ unknown time by Zoltan)
Add support for memory profiling.
(A significant part of this change is actuallly Zoltan's work. Zoltan
did the changes to the compiler and a first go at the changes to the
runtime and library. I rewrote much of Zoltan's changes to the runtime
and library, added support for the new options/grades, added code to
interface with mprof, did the changes to the profiler, and wrote the
documentation.)
[TODO: add test cases.]
NEWS:
Mention support for memory profiling.
runtime/mercury_heap_profile.h:
runtime/mercury_heap_profile.c:
New files. These contain code to record heap profiling information.
runtime/mercury_heap.h:
Add new macros incr_hp_msg(), tag_incr_hp_msg(),
incr_hp_atomic_msg(), and tag_incr_hp_atomic_msg().
These are like the non-`msg' versions, except that if
PROFILE_MEMORY is defined, they also call MR_record_allocation()
from mercury_heap_profile.h to record heap profiling information.
Also, fix up the indentation in lots of places.
runtime/mercury_prof.h:
runtime/mercury_prof.c:
Added code to dump out memory profiling information to files
`Prof.MemoryWords' and `Prof.MemoryCells' (for use by mprof).
Change the format of the `Prof.Counts' file so that the
first line says what it is counting, the units, and a scale
factor. Prof.MemoryWords and Prof.MemoryCells can thus have
exactly the same format as Prof.Counts.
Also cleaned up the interface to mercury_prof.c a bit, and did
various other minor cleanups -- indentation changes, changes to
use MR_ prefixes, additional comments, etc.
runtime/mercury_prof_mem.h:
runtime/mercury_prof_mem.c:
Rename prof_malloc() as MR_prof_malloc().
Rename prof_make() as MR_PROF_NEW() and add MR_PROF_NEW_ARRAY().
runtime/mercury_wrapper.h:
Minor modifications to reflect the new interface to mercury_prof.c.
runtime/mercury_wrapper.c:
runtime/mercury_label.c:
Rename the old `-p' (primary cache size) option as `-C'.
Add a new `-p' option to disable profiling.
runtime/Mmakefile:
Add mercury_heap_profile.[ch].
Put the list of files in alphabetical order.
Delete some obsolete stuff for supporting `.mod' files.
Mention that libmer_dll.h and libmer_globals.h are
produced by Makefile.DLLs.
runtime/mercury_imp.h:
Mention that libmer_dll.h is produced by Makefile.DLLs.
runtime/mercury_dummy.c:
Change a comment to refer to libmer_dll.h rather than
libmer_globals.h.
compiler/llds.m:
Add a new field to `create' and `incr_hp' instructions
holding the name of the type, for heap profiling.
compiler/unify_gen.m:
Initialize the new field of `create' instructions with
the appropriate type name.
compiler/llds_out.m:
Output incr_hp_msg() / tag_incr_hp_msg() instead of
incr_hp() / tag_incr_hp().
compiler/*.m:
Minor changes to most files in the compiler back-end to
accomodate the new field in `incr_hp' and `create' instructions.
library/io.m:
Add `io__report_full_memory_stats'.
library/benchmarking.m:
Add `report_full_memory_stats'. This uses the information saved
by runtime/mercury_heap_profile.{c,h} to print out a report
of memory usage by procedures and by types.
Also modify `report_stats' to print out some of that information.
compiler/mercury_compile.m:
If `--statistics' is enabled, call io__report_full_memory_stats
at the end of main/2. This will print out full memory statistics,
if the compiler was compiled with memory profiling enabled.
compiler/options.m:
compiler/handle_options.m:
runtime/mercury_grade.h:
scripts/ml.in:
scripts/mgnuc.in:
scripts/init_grade_options.sh-subr:
scripts/parse_grade_options.sh-subr:
Add new option `--memory-profiling' and new grade `.memprof'.
Add `--time-profiling' as a new synonym for `--profiling'.
Also add `--profile-memory' for more fine-grained control:
`--memory-profiling' implies both `--profile-memory' and
`--profile-calls'.
scripts/mprof_merge_runs:
Update to handle the new format of Prof.Counts and to
also merge Prof.MemoryWords and Prof.MemoryCells.
profiler/options.m:
profiler/mercury_profile.m:
Add new options `--profile memory-words' (`-m'),
`--profile memory-cells' (`-M') and `--profile time' (`-t').
Thes options make the profiler select a different count file,
Prof.MemoryWords or Prof.MemoryCells instead of Prof.Counts.
specific to time profiling.
profiler/read.m:
profiler/process_file.m:
profiler/prof_info.m:
profiler/generate_output.m:
Update to handle the new format of the counts file.
When reading the counts file, look at the first line of
the file to determine what is being profiled.
profiler/globals.m:
Add a new global variable `what_to_profile' that records
what is being profiled.
profiler/output.m:
Change the headings to reflect what is being profiled.
doc/user_guide.texi:
Document memory profiling.
Document new options.
doc/user_guide.texi:
compiler/options.m:
Comment out the documentation for `.proftime'/`--profile-time',
since doing time and call profiling seperately doesn't work,
because the code addresses change when you recompile with a
different grade. Ditto for `.profmem'/`--profile-memory'.
Also comment out the documentation for
`.profcalls'/`--profile-calls', since it is redundant --
`.memprof' produces the same information and more.
configure.in:
Build a `.memprof' grade. (Hmm, should we do this only
if `--enable-all-grades' is specified?)
Don't ever build a `.profcalls' grade.
402 lines
9.6 KiB
Bash
402 lines
9.6 KiB
Bash
#! /bin/sh
|
|
# @configure_input@
|
|
#---------------------------------------------------------------------------#
|
|
# Copyright (C) 1995-1997 The University of Melbourne.
|
|
# This file may only be copied under the terms of the GNU General
|
|
# Public License - see the file COPYING in the Mercury distribution.
|
|
#---------------------------------------------------------------------------#
|
|
#
|
|
# ML - Mercury Linker.
|
|
#
|
|
# Invokes GCC with the appropriate options to link in the Mercury library.
|
|
#
|
|
# Usage: see below.
|
|
#
|
|
# Environment variables: MERCURY_C_LIB_DIR, MERCURY_DEFAULT_GRADE, ...
|
|
|
|
Help="\
|
|
Name: ml - Mercury Linker
|
|
Usage: ml [<ml options>] [-- <gcc options>] files...
|
|
Options:
|
|
-h, --help
|
|
Print this help message.
|
|
-v, --verbose
|
|
Echo the gcc command line before executing it.
|
|
--mercury-libs {shared, static, none}
|
|
Specify which version of the standard Mercury libraries to
|
|
link with:
|
|
--mercury-libs shared
|
|
Link with the shared libraries (*.so),
|
|
if possible, otherwise with the static ones.
|
|
--mercury-libs static
|
|
Link with the static libraries (*.a).
|
|
--mercury-libs none
|
|
Don't link in the Mercury standard libraries.
|
|
-shared, --shared
|
|
Similar to \`--mercury-libs shared', but applies to all
|
|
libraries, not just the standard Mercury libraries.
|
|
-static, --static
|
|
Similar to \`--mercury-libs static', but applies to all
|
|
libraries, not just the standard Mercury libraries.
|
|
--make-shared-lib
|
|
Produce a shared library, rather than an executable.
|
|
-R <directory>, --shared-lib-dir <directory>
|
|
Include <directory> in the list of directories that the
|
|
dynamic linker will use to search for shared libraries.
|
|
--no-demangle
|
|
Don't pipe the output of the linker through the Mercury
|
|
demangler.
|
|
-g, --no-strip
|
|
Do not strip debugging information.
|
|
-s <grade>, --grade <grade>
|
|
--asm-labels
|
|
--gcc-non-local-gotos
|
|
--gcc-global-registers
|
|
-p, --profiling
|
|
--profile-calls
|
|
--profile-time
|
|
--profile-memory
|
|
--debug
|
|
--use-trail
|
|
--args {simple, compact}
|
|
--pic-reg
|
|
See the documentation in the \"Invocation\" section
|
|
of the Mercury User's Guide."
|
|
|
|
FULLARCH=@FULLARCH@
|
|
NONSHARED_LIB_DIR=${MERCURY_NONSHARED_LIB_DIR=@NONSHARED_LIB_DIR@}
|
|
DEFAULT_LIBDIR=@LIBDIR@/lib
|
|
LIBDIR=${MERCURY_C_LIB_DIR=$DEFAULT_LIBDIR}
|
|
DEFAULT_GRADE=${MERCURY_DEFAULT_GRADE=@DEFAULT_GRADE@}
|
|
# DEMANGLER=${MERCURY_DEMANGLER=@LIBDIR@/bin/@FULLARCH@/mdemangle}
|
|
DEMANGLER=${MERCURY_DEMANGLER=mdemangle}
|
|
CC=${MERCURY_C_COMPILER="@CC@"}
|
|
MKFIFO=${MERCURY_MKFIFO="@MKFIFO@"}
|
|
EXE_RPATH_OPT=${MERCURY_EXE_RPATH_OPT="@EXE_RPATH_OPT@"}
|
|
EXE_RPATH_SEP=${MERCURY_EXE_RPATH_SEP="@EXE_RPATH_SEP@"}
|
|
EXT_FOR_SHARED_LIB=${MERCURY_EXT_FOR_SHARED_LIB="@EXT_FOR_SHARED_LIB@"}
|
|
LINK_SHARED_OBJ=${MERCURY_LINK_SHARED_OBJ="@LINK_SHARED_OBJ@"}
|
|
SHLIB_RPATH_OPT=${MERCURY_SHLIB_RPATH_OPT="@SHLIB_RPATH_OPT@"}
|
|
SHLIB_RPATH_SEP=${MERCURY_SHLIB_RPATH_SEP="@SHLIB_RPATH_SEP@"}
|
|
SHARED_LIBS=${MERCURY_SHARED_LIBS="@SHARED_LIBS@"}
|
|
|
|
verbose=false
|
|
case $FULLARCH in
|
|
*-win95|*-winnt|*-win32|*-cygwin32)
|
|
# `gcc -s' is broken in gnu-win32
|
|
strip=false
|
|
;;
|
|
*)
|
|
strip=true
|
|
;;
|
|
esac
|
|
mercury_libs=default
|
|
demangle=true
|
|
MAYBE_STATIC_OPT=""
|
|
make_shared_lib=false
|
|
user_shlib_dirs=""
|
|
|
|
# include the file `init_grade_options.sh-subr'
|
|
@INIT_GRADE_OPTIONS@
|
|
|
|
while : ; do
|
|
case "$1" in
|
|
-h|--help|"-?")
|
|
echo "$Help"
|
|
exit 0
|
|
;;
|
|
-v|--verbose)
|
|
verbose=true
|
|
;;
|
|
--demangle)
|
|
demangle=true
|
|
;;
|
|
--no-demangle)
|
|
demangle=false
|
|
;;
|
|
--strip)
|
|
strip=true
|
|
;;
|
|
-g|--no-strip)
|
|
strip=false
|
|
;;
|
|
--make-shared-lib)
|
|
make_shared_lib=true
|
|
# on some targets, stripping shared libraries will
|
|
# make them unusable, I think, so don't strip
|
|
strip=false
|
|
;;
|
|
--no-libs)
|
|
progname=`basename $0`
|
|
cat 1>&2 << EOF
|
|
$progname: Warning: option \`--no-libs' is deprecated --
|
|
$progname: please use the new option \`--mercury-libs none' instead.
|
|
$progname: Support for \`--no-libs' may be removed in a future release.
|
|
EOF
|
|
mercury_libs=none
|
|
;;
|
|
--mercury-libs)
|
|
case "$2" in
|
|
shared|static|none|default)
|
|
mercury_libs="$2"
|
|
shift ;;
|
|
*)
|
|
progname=`basename $0`
|
|
cat 1>&2 << EOF
|
|
$progname: Error: parameter to \`--mercury-libs' option should be either
|
|
$progname: \`shared', \`static', \`none', or \`default', not \`$2'.
|
|
$progname: Try `$0 --help' for help.
|
|
EOF
|
|
exit 1
|
|
;;
|
|
esac
|
|
;;
|
|
-shared|--shared)
|
|
MAYBE_STATIC_OPT=""
|
|
case $mercury_libs in static|default)
|
|
mercury_libs=shared ;;
|
|
esac
|
|
;;
|
|
-static|--static)
|
|
case $FULLARCH in
|
|
*-linux*)
|
|
# On Linux, if we're linking statically, we need to
|
|
# pass `-defsym _DYNAMIC=0' to the linker, to avoid
|
|
# undefined references to _DYNAMIC in
|
|
# boehm_gc/dyn_load.c.
|
|
# (We might eventually need similar treatment
|
|
# for other OSs too)
|
|
MAYBE_STATIC_OPT="-static -Wl,-defsym,_DYNAMIC=0"
|
|
;;
|
|
*)
|
|
MAYBE_STATIC_OPT=-static
|
|
;;
|
|
esac
|
|
case $mercury_libs in shared|default)
|
|
mercury_libs=static ;;
|
|
esac
|
|
;;
|
|
-R|--shared-lib-dir)
|
|
dir="$2"
|
|
user_shlib_dirs="$user_shlib_dirs $dir"
|
|
shift
|
|
;;
|
|
-R*)
|
|
dir="` expr $1 : '-R\(.*\)' `"
|
|
user_shlib_dirs="$user_shlib_dirs $dir"
|
|
;;
|
|
|
|
# include the file `parse_grade_options.sh-subr'
|
|
@PARSE_GRADE_OPTIONS@
|
|
|
|
--)
|
|
shift
|
|
break ;;
|
|
*)
|
|
break ;;
|
|
esac
|
|
shift
|
|
done
|
|
|
|
case $mercury_libs in default)
|
|
mercury_libs=shared
|
|
case $FULLARCH in i?86-*-linux*)
|
|
# shared libraries are not the default on Linux
|
|
# -- see README.Linux
|
|
case $make_shared_lib in false)
|
|
mercury_libs=static
|
|
;;
|
|
esac
|
|
;;
|
|
esac
|
|
;;
|
|
esac
|
|
|
|
#
|
|
# compute the grade from the options settings
|
|
#
|
|
|
|
case $non_local_gotos,$global_regs in
|
|
true,true) GRADE="fast" ;;
|
|
true,false) GRADE="jump" ;;
|
|
false,true) GRADE="reg" ;;
|
|
false,false) GRADE="none" ;;
|
|
esac
|
|
case $asm_labels in
|
|
true) GRADE="asm_$GRADE" ;;
|
|
false) ;;
|
|
esac
|
|
case $gc_method in
|
|
conservative) GRADE="$GRADE.gc" ;;
|
|
accurate) GRADE="$GRADE.agc" ;;
|
|
esac
|
|
case $profile_time,$profile_calls,$profile_memory in
|
|
true,true,false) GRADE="$GRADE.prof" ;;
|
|
true,false,false) GRADE="$GRADE.proftime" ;;
|
|
false,true,false) GRADE="$GRADE.profcalls" ;;
|
|
true,true,true) GRADE="$GRADE.profall" ;;
|
|
false,true,true) GRADE="$GRADE.memprof" ;;
|
|
false,false,false) ;;
|
|
*) progname=`basename $0`
|
|
echo \
|
|
"$progname: Error: invalid combination of profiling options." 1>&2
|
|
exit 1
|
|
;;
|
|
esac
|
|
case $use_trail in
|
|
true) GRADE="$GRADE.tr" ;;
|
|
false) ;;
|
|
esac
|
|
case $args_method in
|
|
simple) GRADE="$GRADE.sa" ;;
|
|
compact) ;;
|
|
esac
|
|
case $debug in
|
|
true) GRADE="$GRADE.debug" ;;
|
|
false) ;;
|
|
esac
|
|
|
|
case "$GRADE" in
|
|
*.gc.prof*)
|
|
LIBGC="-lgc_prof"
|
|
LIBGC_STATIC="$LIBDIR/$FULLARCH/libgc_prof.a"
|
|
;;
|
|
*.gc*)
|
|
LIBGC="-lgc"
|
|
LIBGC_STATIC="$LIBDIR/$FULLARCH/libgc.a"
|
|
;;
|
|
*)
|
|
LIBGC=
|
|
LIBGC_STATIC=
|
|
;;
|
|
esac
|
|
|
|
case $strip in
|
|
true) STRIP_OPTS="-s" ;;
|
|
false) STRIP_OPTS="" ;;
|
|
esac
|
|
|
|
case $make_shared_lib in
|
|
true)
|
|
LINKER="$LINK_SHARED_OBJ"
|
|
RPATH_OPT="$SHLIB_RPATH_OPT"
|
|
RPATH_SEP="$SHLIB_RPATH_SEP"
|
|
STDLIBS="$SHARED_LIBS"
|
|
;;
|
|
false)
|
|
LINKER="$CC"
|
|
RPATH_OPT="$EXE_RPATH_OPT"
|
|
RPATH_SEP="$EXE_RPATH_SEP"
|
|
STDLIBS="-lm"
|
|
;;
|
|
esac
|
|
|
|
LIBDIR_OPTS="
|
|
-L$LIBDIR/$GRADE/$FULLARCH
|
|
-L$LIBDIR/$FULLARCH
|
|
"
|
|
case $mercury_libs in
|
|
shared)
|
|
LIBS=${MERCURY_LIBS="-lmercury -lmer $LIBGC $STDLIBS"}
|
|
merc_shlib_dirs="$merc_shlib_dirs $LIBDIR/$GRADE/$FULLARCH"
|
|
merc_shlib_dirs="$merc_shlib_dirs $LIBDIR/$FULLARCH"
|
|
;;
|
|
static) LIBS=${MERCURY_LIBS="\
|
|
$LIBDIR/$GRADE/$FULLARCH/libmercury.a \
|
|
$LIBDIR/$GRADE/$FULLARCH/libmer.a \
|
|
$LIBGC_STATIC \
|
|
$STDLIBS"}
|
|
merc_shlib_dirs=""
|
|
;;
|
|
none) LIBS="$STDLIBS"
|
|
LIBDIR_OPTS=""
|
|
merc_shlib_dirs=""
|
|
;;
|
|
esac
|
|
|
|
RPATH_OPT_LIST=
|
|
# only set RPATH_OPT_LIST if the system supports shared libraries
|
|
case $EXT_FOR_SHARED_LIB in so)
|
|
prev=""
|
|
for dir in $user_shlib_dirs $merc_shlib_dirs 'kludge for broken shells'
|
|
do
|
|
case "$dir" in
|
|
'kludge for broken shells')
|
|
;;
|
|
*)
|
|
case "$prev" in
|
|
"") RPATH_OPT_LIST="$RPATH_OPT$dir" ;;
|
|
*) RPATH_OPT_LIST="$RPATH_OPT_LIST$RPATH_SEP$dir" ;;
|
|
esac
|
|
;;
|
|
esac
|
|
prev=$dir
|
|
done
|
|
;;
|
|
esac
|
|
|
|
# On Irix 5, grades `fast' and `jump' only work in non_shared mode.
|
|
case $FULLARCH in
|
|
*-sgi-irix5*)
|
|
case $non_local_gotos in
|
|
true)
|
|
ARCH_OPTS=-non_shared
|
|
NONSHARED_PATH="$NONSHARED_LIB_DIR:/usr/lib/nonshared"
|
|
LIBRARY_PATH="$NONSHARED_PATH:$LIBRARY_PATH"
|
|
export LIBRARY_PATH
|
|
;;
|
|
esac
|
|
;;
|
|
esac
|
|
|
|
case "$MKFIFO" in
|
|
none) demangle=false ;;
|
|
esac
|
|
|
|
case $verbose in
|
|
true)
|
|
echo "ml: using grade \`$GRADE'"
|
|
case $demangle in
|
|
false)
|
|
echo $LINKER $STRIP_OPTS $MAYBE_STATIC_OPT $ARCH_OPTS \
|
|
"$@" $LIBDIR_OPTS $RPATH_OPT_LIST $LIBS
|
|
;;
|
|
true)
|
|
echo $LINKER $STRIP_OPTS $MAYBE_STATIC_OPT $ARCH_OPTS \
|
|
"$@" $LIBDIR_OPTS $RPATH_OPT_LIST $LIBS "|"
|
|
echo "$DEMANGLER"
|
|
;;
|
|
esac
|
|
;;
|
|
esac
|
|
|
|
case $demangle in
|
|
true)
|
|
# we would like to just run $CC and pipe the result into $DEMANGLER,
|
|
# but `$CC | $DEMANGLER' would return the wrong exit status, so
|
|
# we need to use a named pipe; if the system doesn't have named
|
|
# pipes, then we don't use the demangler
|
|
|
|
# create the pipe, making sure we remove it if interrupted
|
|
PIPE=/tmp/ml.$$
|
|
trap 'rm -f $PIPE; exit 1' 1 2 3 13 15
|
|
$MKFIFO $PIPE
|
|
# execute the demangler in the background, with stdin
|
|
# coming from the pipe and with stdout redirected to stderr
|
|
exec $DEMANGLER 1>&2 < $PIPE &
|
|
# redirect our stdout and stderr into the pipe
|
|
exec >$PIPE 2>&1
|
|
# now we can remove the pipe; since is an open file, it will
|
|
# stay around until $CC and $DEMANGLER exit
|
|
rm -f $PIPE
|
|
# finally execute $CC; stdout & stderr will
|
|
# go via the pipe to $DEMANGLER and then to stderr
|
|
;;
|
|
esac
|
|
case $# in
|
|
0) exec $LINKER $STRIP_OPTS $MAYBE_STATIC_OPT $ARCH_OPTS \
|
|
$LIBDIR_OPTS $RPATH_OPT_LIST $LIBS ;;
|
|
*) exec $LINKER $STRIP_OPTS $MAYBE_STATIC_OPT $ARCH_OPTS "$@" \
|
|
$LIBDIR_OPTS $RPATH_OPT_LIST $LIBS ;;
|
|
esac
|