Skip to content

Commit

Permalink
Doc tweaks for release: limits, Win10 path
Browse files Browse the repository at this point in the history
Updates stale comments in the Limitations section.
Adds a note about the Win10 path propagation issue.

Review-URL: https://codereview.appspot.com/308280043
  • Loading branch information
derekbruening committed Aug 29, 2016
1 parent f0c33ff commit 6f015d7
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 22 deletions.
20 changes: 3 additions & 17 deletions drmemory/docs/release.dox
Original file line number Diff line number Diff line change
Expand Up @@ -402,27 +402,13 @@ some bugs. The missing features include:
- Uninitialized read checking is not yet supported for 64-bit applications
nor for ARM platforms.
- Windows system call parameters are not all known, which can
result in false positives and false negatives, especially on Vista or
Windows 7+, or with code that interacts with the network.
result in false positives and false negatives, especially on graphical
applications on more recent versions of Windows.
Often, these false positives are solely in system library code.
Dr. Memory attempts to separate such errors into potential_errors.txt.
- The malloc in the Cygwin C library is not yet tracked separately from
the Windows API malloc which can lead to false negatives.
- Definedness is tracked at the byte level, not at the bit level,
which when bitfields are in use can lead to false positives.
- 64-bit uninitialized read support: we plan to add this in the future.
All other error types are detected in 64-bit applications.
- 32-bit applications on 64-bit Windows have some limitations (these are
actually limitations of the current version of the underlying DynamoRIO
engine): if the app creates threads prior to image entry (as Cygwin apps
often do) and does not link user32.dll, Dr. Memory will not take over
early enough to avoid problems with the other thread(s). On 32-bit
Windows this can be worked around by taking over from a parent process
(e.g., cmd.exe). Instructions on how to do this will appear in an
upcoming version (basically you need to use DynamoRIO's drdeploy to set
up the child; in the future the drmemory front-end will support doing
that for you).
- Multiple thread corner cases:
- Race corner cases:
- Pathological races between mallocs and frees can result in Dr. Memory's
shadow memory structures becoming mis-aligned with subsequent false
positives. However, such a scenario will always be preceded by
Expand Down
12 changes: 7 additions & 5 deletions drmemory/docs/using.dox
Original file line number Diff line number Diff line change
Expand Up @@ -129,11 +129,13 @@ you will need to <a href="http://drmemory.org">download the installer</a>.
********************
\section sec_windows_system System Install

Download the \p .exe version of Dr. Memory. Run the downloaded file to
launch the installer. The installer automatically adds Dr. Memory to the
PATH for the current user, to simplify use of the tool. It also
places a Dr. Memory icon on the desktop if you would like to run your
applications under Dr. Memory by dragging and dropping.
Download the \p .msi version of Dr. Memory and launch it to run the
Dr. Memory installer. The installer automatically adds Dr. Memory to the
PATH for the current user, to simplify use of the tool (however, currently
on Windows 10 the PATH is not propagated: manually applying an empty change
to the PATH, or rebooting, will update the PATH for newly created shells).
It also places a Dr. Memory icon on the desktop if you would like to run
your applications under Dr. Memory by dragging and dropping.

If you already have a prior version of Dr. Memory installed, uninstall it
before installing a new version. The uninstaller can be run either from
Expand Down

0 comments on commit 6f015d7

Please sign in to comment.