installation.rst

Installation

There are several options for installing drgn.

Dependencies

drgn depends on:

• Python 3.6 or newer
• elfutils 0.165 or newer

It optionally depends on:

• libkdumpfile for makedumpfile compressed kernel core dump format support

The build requires:

• GCC
• GNU Make
• pkgconf
• setuptools

Running tests requires:

• check 0.10.0 or newer

Building from the Git repository (rather than a release tarball) additionally requires:

• autoconf
• automake
• libtool

Virtual Environment

The above options all install drgn globally. You can also install drgn in a virtual environment, either with pip:

$ python3 -m venv drgnenv
$ source drgnenv/bin/activate
(drgnenv) $ pip3 install drgn
(drgnenv) $ drgn --help

Or from source:

$ python3 -m venv drgnenv
$ source drgnenv/bin/activate
(drgnenv) $ python3 setup.py install
(drgnenv) $ drgn --help

Running Locally

If you build drgn from source, you can also run it without installing it:

$ python3 setup.py build_ext -i
$ python3 -m drgn --help