summaryrefslogtreecommitdiff
path: root/tools/drmemory/README
diff options
context:
space:
mode:
authorQin Zhao <zhaoqin@google.com>2015-11-30 15:06:22 -0500
committerQin Zhao <zhaoqin@google.com>2015-11-30 15:06:22 -0500
commitd029d934e1a23aadc07cc99753a55b308f20ef2b (patch)
treee1cf0f1929e0a1acd8fa137733ecc04ee8869c95 /tools/drmemory/README
parentd6c62cfd71e5bc6b22e20f20384b748664e1aff4 (diff)
downloadpdfium-d029d934e1a23aadc07cc99753a55b308f20ef2b.tar.xz
Merge to XFA: Add README in tools/drmemory for using Dr. Memory
R=tsepez@chromium.org BUG=PDFium:238 Review URL: https://codereview.chromium.org/1471073011 . (cherry picked from commit 7e413d168beba325078aa4b484729ad22919a2c3) Review URL: https://codereview.chromium.org/1482953003 .
Diffstat (limited to 'tools/drmemory/README')
-rw-r--r--tools/drmemory/README86
1 files changed, 86 insertions, 0 deletions
diff --git a/tools/drmemory/README b/tools/drmemory/README
new file mode 100644
index 0000000000..1db5410e43
--- /dev/null
+++ b/tools/drmemory/README
@@ -0,0 +1,86 @@
+
+# Dr. Memory
+
+Dr. Memory (www.drmemory.org) is an open-source dynamic memory
+monitoring tool for Windows, Linux, and Mac.
+
+## About Dr. Memory
+
+Dr. Memory operates on unmodified application binaries running on
+Windows, Linux, or Mac on commodity x86 and ARM32 (forthcoming) hardware.
+It is capable of identifying memory-related programming errors including:
+ * accesses of uninitialized memory
+ * accesses to unaddressable memory (heap underflow and overflow)
+ * accesses to freed memory
+ * double frees
+ * memory leaks
+ * handle leaks (on Windows)
+ * GDI API usage errors (on Windows)
+ * accesses to un-reserved thread local storage slots (on Windows)
+
+## Using Dr. Memory (Windows only)
+
+Build your application with debug information and then run it under
+Dr. Memory. Errors found are printed to the screen, and a summary is
+shown at the end of the run.
+
+### Obtain Dr. Memory
+
+The Dr. Memory package is provided as a self-extracting archive
+(DrMemory-Windows-sfx.exe) in tools/drmemory directory, which can be
+extracted by running command 'DrMemory-Windows-sfx.exe -ounpacked -y'.
+
+The Dr. Memory release package can be downloaded from
+https://github.com/DynamoRIO/drmemory/wiki/Downloads.
+
+Nightly builds can be downloaded from
+https://build.chromium.org/p/client.drmemory/builds/.
+
+The Dr. Memory source code can be found at
+https://github.com/DynamoRIO/drmemory.
+
+### Run your application with Dr. Memory
+
+To run your application with Dr. Memory, simply put 'drmemory.exe --'
+before the command that invokes the application.
+
+ * Running pdfium_unittests with Dr. Memory:
+ tools\drmemory\unpaced\bin\drmemory.exe -- out\Debug\pdfium_unittests.exe
+
+ * Running pdfium_tests with Dr. Memory:
+ tools\drmemory\unpaced\bin\drmemory.exe -- out\Debug\pdfium_tests.exe --png YourInputPDF.pdf
+
+### Run test suite with Dr. Memory
+
+A set of scripts are provided to run PDFium test suite with Dr. Memory
+on buildbots, which can also be used for running test suite locally.
+
+ * Running pdfium_unittests with Dr. Memory:
+ tools\drmemory\scripts\pdfium_tests.bat -t pdfium_unittests
+
+ * Running pixel test suite with Dr. Memory:
+ tools\drmemory\scripts\pdfium_tests.bat -t pdfium_pixel
+
+## Documentation
+
+Command 'drmemory.exe -help' prints a list of Dr. Memory runtime
+options with short description.
+
+To view the full documention, point your web browser at
+http://drmemory.org/docs/.
+
+
+## Contact
+
+This project is provided as-is, with no official support.
+Use the Dr. Memory Users group at
+http://groups.google.com/group/drmemory-users/ to ask questions and
+seek help on using Dr. Memory.
+
+Dr. Memory's source code and issue tracker live at
+https://github.com/DynamoRIO/drmemory
+
+If you would like to submit a patch, you will need to first sign a
+Contributor License Agreement.
+See https://github.com/DynamoRIO/drmemory/wiki/Contributing for more
+information.