diff options
| author | Alp Toker <alp@nuanti.com> | 2014-06-02 01:40:04 +0000 |
|---|---|---|
| committer | Alp Toker <alp@nuanti.com> | 2014-06-02 01:40:04 +0000 |
| commit | 125be8465d3a83e3ed3e9ed1813d7361729ebf9b (patch) | |
| tree | 5547dbf5f3068e594fbb1f284949efb07aedbd5a /llvm/docs/ProgrammersManual.rst | |
| parent | aaffd7060995c7679e9cb71bb4b941edd59b5b59 (diff) | |
| download | bcm5719-llvm-125be8465d3a83e3ed3e9ed1813d7361729ebf9b.tar.gz bcm5719-llvm-125be8465d3a83e3ed3e9ed1813d7361729ebf9b.zip | |
GraphWriter: detect graph viewer programs at runtime
Replace the crufty build-time configure checks for program paths with
equivalent runtime logic.
This lets users install graphing tools as needed without having to reconfigure
and rebuild LLVM, while eliminating a long chain of inappropriate compile
dependencies that included GUI programs and the windowing system.
Additional features:
* Support the OS X 'open' command to view graphs generated by any of the
Graphviz utilities. This is an alternative to the Graphviz OS X UI which is
no longer available on Mountain Lion.
* Produce informative log output upon failure to indicate which programs can
be installed to view graphs.
Ping me if this doesn't work for your particular environment.
llvm-svn: 210001
Diffstat (limited to 'llvm/docs/ProgrammersManual.rst')
| -rw-r--r-- | llvm/docs/ProgrammersManual.rst | 7 |
1 files changed, 4 insertions, 3 deletions
diff --git a/llvm/docs/ProgrammersManual.rst b/llvm/docs/ProgrammersManual.rst index 7e46ac4e8e6..8d9668e4eec 100644 --- a/llvm/docs/ProgrammersManual.rst +++ b/llvm/docs/ProgrammersManual.rst @@ -545,14 +545,15 @@ methods. Within GDB, for example, you can usually use something like ``call DAG.viewGraph()`` to pop up a window. Alternatively, you can sprinkle calls to these functions in your code in places you want to debug. -Getting this to work requires a small amount of configuration. On Unix systems +Getting this to work requires a small amount of setup. On Unix systems with X11, install the `graphviz <http://www.graphviz.org>`_ toolkit, and make sure 'dot' and 'gv' are in your path. If you are running on Mac OS X, download and install the Mac OS X `Graphviz program <http://www.pixelglow.com/graphviz/>`_ and add ``/Applications/Graphviz.app/Contents/MacOS/`` (or wherever you install it) to -your path. Once in your system and path are set up, rerun the LLVM configure -script and rebuild LLVM to enable this functionality. +your path. The programs need not be present when configuring, building or +running LLVM and can simply be installed when needed during an active debug +session. ``SelectionDAG`` has been extended to make it easier to locate *interesting* nodes in large complex graphs. From gdb, if you ``call DAG.setGraphColor(node, |
