Files
mercury/scripts/ml.in
Fergus Henderson e6ac077bae Add support for memory profiling.
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.
1997-12-05 15:58:34 +00:00

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