1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
Introductory Documentation for NJAMD v0.8
USERS:
Having problems? Read the NOTES file.
Welcome to NJAMD, Not Just Another Malloc Debugger. NJAMD is a debugging tool
that is meant to help you track down a wide range of memory allocation
problems. It is divided into a front end executable, and a library back end.
NJAMD can be used with or without the two front ends (console and gui in
src/fe/). These are both `proof of concepts' (as of version 0.7), the former
simply being a wrapper for gdb (lacking things like command history and
scrollback), and the latter still needing considerable work (it is
essentially two windows and tab bars) -- see `njamd -h'.
For information on using the library without the front end, see njamd(3).
Note that you do not have to recompile your programs to use NJAMD. man
libnjamd for more info.
To build the system, simply issue
./configure && make && make install
For best results, issue sysctl -w vm.overcommit_memory=1 as root in Linux.
To get started, simply issue LD_PRELOAD=libnjamd.so programname to use NJAMD.
But PLEASE read the manual pages. NJAMD has a lot of features, the only way to
fully utilize them is to read njamd(3) and njamdpm(1).
See 'NOTES' for oddities concerning NJAMD on various architectures.
DEVELOPERS:
See the DESIGN documentation in ./docs
Check the TODO file for good places to start.
IMPORTANT: Get automake-devel from anoncvs with:
cvs -z 9 -d :pserver:anoncvs@anoncvs.cygnus.com:/cvs/automake login
(password is ``anoncvs'')
cvs -z 9 -d :pserver:anoncvs@anoncvs.cygnus.com:/cvs/automake co automake
All source files should go in src/, and modify Makefile.am appropriately
(info automake).
NEVER!!! add config.guess, config.sub, config.h.in, configure, install-sh,
missing, mkinstalldirs, stamp-h.in, aclocal.m4, or Makefile.in to the
repository. These are all generated by ./autogen.sh. Add other
files that are auto-generated to .cvsignore.
Please make sure you are running cvs update with the -PAd options. An
easy way to ensure this is: echo "update -PAd" >> ~/.cvsrc.
patches are to be unified diffs (diff -ur) submitted to mikepery@fscked.org.
|
