diff options
Diffstat (limited to 'devel/mprof/pkg-descr')
-rw-r--r-- | devel/mprof/pkg-descr | 83 |
1 files changed, 2 insertions, 81 deletions
diff --git a/devel/mprof/pkg-descr b/devel/mprof/pkg-descr index 29dff8b558c8..93df37d7a786 100644 --- a/devel/mprof/pkg-descr +++ b/devel/mprof/pkg-descr @@ -1,3 +1,4 @@ +from the README: MPROF -- memory profiler (version 3.0) @@ -12,86 +13,6 @@ mprof.man. Simply by linking in the new malloc and executing your application, a file called ``mprof.data'' will be created in the current directory. This is the data file that mprof uses to build its dynamic call graph. -Call the program mprof with the following arguments: - -mprof [ options ] [ executable-file (a.out) ] [ data-file (mprof.data) ] - -The output contains four tables, the fields of which are described in -the man page in mprof.man. Further documentation is available in a -paper which describes the implementation of mprof (published in the -1988 summer USENIX conference) . The LaTeX source of that paper is -located in mprof.tex. The printable DVI file is located in mprof.dvi. - -There are currently four makefiles, for the VAX, Sun-3, Sun-4, and -MIPS (specifically, the Decstation 3100 and 5000). To remake mprof, -copy the appropriate file to `Makefile'. If you need to recompile -mprof for any reason, type ``make all'' in this directory. To remove -.o files, type ``make clean'' in this directory. mprof has been -tested on VAX (4.3 BSD and Ultrix using gcc and cc), SUN-3 (gcc and -cc), Sun-4 (cc) computers, and Decstation 3100 (gcc and cc). To test -if mprof works in simple cases, type `make test'. - +[...] Mprof does not use Kyoto Common Lisp anymore. To use mprof, all you need is a C compiler. - -The current incarnation of mprof does not handle calls to Sun calls to -valloc or memalign correctly. The calls will be profiled, but if your -program calls valloc or memalign and tries to later free that memory, -mprof will cause it to core dump. On the VAX, memory allocated by -valloc cannot be freed, and so valloc can be profiled correctly on the -VAX. A version of malloc.c is provided with mprof. If this version -is not compatible with the version used on your machine, you may need -to replace this file. If you have problems like this, please let me -know so I can keep a record of the bugs encountered. - -My thanks to Stuart Sechrest, Fred Douglis, Dain Samples, John -Ousterhout, Luigi Semenzato, Richard Tuck, Robert Scheifler, Mark -Eichin, Pat Stephenson, and Steven Sargent for their interest and -comments. - -My special thanks to Jeffrey Hsu who did the tricky port of mprof to -the MIPS architecture. - -In the future (although the exact date is uncertain) I plan to make -the following improvements to mprof: - -1. Add code to detect duplicate frees. -2. Fix up the type determination code in mpfilt (see BUGS section in - the man page for mprof). - -If you have any questions or comments, please feel free to contact me. - --Ben Zorn - e-mail: zorn@boulder.colorado.edu - phone: 303-492-4398 - - -Differences between version 2.0 and 2.1: - -1. In mpfilt.c, the variable stab_i was being incremented without -checking for an overflow. Overflow checks were added. - -2. A user discovered that a value of 5000 for ST_SIZE in mpfilt.c was -too small. Large programs may require a larger value for ST_SIZE. - - -Differences between version 2.1 and 2.2: - -1. mprof now runs on the Decstation 3100 (a MIPS machine). - -2. A bug that prevented mprof from working in version 4.0 of the Sun -operating system was fixed. - - -Difference between version 2.2 and 3.0: - -1. All analysis is now done in C. - -2. The file mprof.c was renamed mprof_mon.c and the file mpfilt.c was -renamed mprof.c. - -3. The old C-shell script ``mprof'' is not needed anymore. The file -analysis.lsp is also not needed. It's functionality is now provided -in the file mpgraph.c. - -4. Small bugs previously reported were fixed. |