Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
DXR --- Introduction: ------------- DXR is a source code cross-reference tool that uses static analysis data collected by instrumented compilers. DXR was created in order to build on tools like LXR and MXR. DXR only runs on Linux for the moment. Prerequisites: -------------- You need a copy of python (at least 2.6), python-sqlite. If you want to use the output HTML, you will need a web-server of some kind. Individual tools have further requirements: cxx-clang: A copy of clang. Setup: ------ DXR is primarily a database of source code information. You need a lot of space to do this, and a fast computer helps a lot. 1) DXR uses config info from an INI style config file. Alter the variables in dxrsrc/www/dxr.config for your environment. 2) Create the wwwdir (e.g., /var/www/html/dxr) you specified in your dxr.config 3) Copy (or symlink) the contents of dxrsrc/www to your web dir. 4) Run . dxrsrc/setup-env.sh srcdir to set up your environment, where srcdir is the root source directory of your codebase. The single `.' at the beginning is very important; otherwise, your shell will not have the necessary variables exported. 5) Compile and build your program. It is recommended that you use a separate build directory from your source directory. If the variable DXR_INDEX_OUTPUT is set on the command line, this will be used to store the output csv files instead of the original source directory, so it should match the objdir specified in dxr.config. This can also be specified by passing it in as the last argument to setup-env.sh 6) Run the cross-reference generator: dxrsrc/dxr-index.py -f /path/to/web/dir/dxr.config 7) You can optionally install sqlite 3 if it is not already installed on your system. You don't strictly need it, but it makes accessing the database manually eaiser. Running: ------- You can build your source, create the xref database, and create the static HTML content as follows: dxrsrc/dxr-index.py -f /path/to/web/dir/dxr.config This will post-process the data into dxr.sqlite. It will also build the static html and create a full-text search index. All these files will be created in the wwwdir using the name of the tree you provided in dxr.config. You will end up with the following structure: /var/www/html/dxr (or whereever your wwwdir is located) /index.html (auto-generated during dxr-index.py) /tree (symlink to tree-current) /tree-current /.dxr_xref /tree.sqlite /index_bob.dat [A pickle file of plugin data] /file_list.txt [A list of source files] /file_index.txt [An index of the source files]