Tools for people envious of nvidia's blob driver.
C C++ Python Perl CMake Yacc Other
Permalink
Failed to load latest commit information.
cupti_trace cupti_trace: Fix python invocation line for better portability Feb 25, 2017
demmt demmt: more gracefully handle GET_CHIPSET ioctl failure Mar 13, 2017
docs envyas: Document the command line for envyas Mar 12, 2017
easm Fix license text everywhere. Mar 14, 2013
envydis gk110: ffma32i: move predicate before instruction name Mar 25, 2017
hwtest hwtest/pfifo: Test free count reads. Jan 11, 2017
include nva: Handle NV17 RDI properly. Jan 15, 2017
nva test: Update and document build requirements Feb 11, 2017
nvbios nvbios: Handle ramcfg ram type detection failure gracefully when miss… Feb 26, 2017
nvhw nvhw/pgraph: Start refactoring nv03_pgraph_rop. Jan 25, 2017
ptxgen ptxgen: add simple cubin fuzzer (cuobjfuzz.c); use CUDA 6 by default;… Jun 23, 2014
rnn Merge pull request #87 from Echelon9/fix/pylint-errors-warnings Mar 14, 2017
rnndb rnndb: mark POLYGON_OFFSET_CLAMP as float Mar 13, 2017
util demmt: let -l option accept compressed files Jul 12, 2014
vdpow vdpow: update dumpstruct to handle mpeg4 correctly Sep 8, 2014
vstream vstream/h261,h262: Fix block encoding. Oct 19, 2015
.gitignore Add ninja files to .gitignore May 8, 2016
.travis.yml test: Update and document build requirements Feb 11, 2017
CMakeLists.txt Always compile as C11 and C++11. Oct 22, 2016
COPYING put the repo under the MIT license as it was agreed on Jul 24, 2013
README.rst docs: Enhance readability of README header Feb 25, 2017
bftool GK110: WIP atom-related decoding bug, bftool: allow mixed 32/64 bit i… Oct 12, 2012

README.rst

envytools

Tools for people envious of nvidia's blob driver.

https://travis-ci.org/envytools/envytools.svg?branch=master https://readthedocs.org/projects/envytools/badge/?version=latest

The canonical repo is at: https://github.com/envytools/envytools/. Pushing anywhere else will result in a de-facto fork!

Contents

Subdirectories:

  • docs: plain-text documentation of the GPUs, nVidia binary driver, and the tools (in-sync HTML version at https://envytools.readthedocs.io)
  • envydis: Disassembler and assembler for various ISAs found on nvidia GPUs
  • rnn: Tools and libraries for the rules-ng-ng XML register database format
  • rnndb: rnn database of nvidia MMIO registers, FIFO methods, and memory structures.
  • nvbios: Tools to decode the card description structures found in nvidia VBIOS
  • nva: Tools to directly access the GPU registers
  • vstream: Tools to decode and encode raw video bitstreams
  • vdpow: A tool aiding in VP3 reverse engineering
  • easm: Utility code dealing with assembly language parsing & printing.
  • util: Misc utility code shared between envytools modules

Building, installing

Dependencies:

  • cmake
  • libxml2
  • flex
  • bison
  • pkg-config

Optional dependencies needed by hwtest:

  • libpciaccess

Optional dependencies needed by demmt:

  • libdrm (nouveau)
  • libseccomp

Optional dependencies needed by nva:

  • libpciaccess
  • libx11
  • libxext
  • python3
  • cython

Optional dependencies needed by vdpow:

  • libpciaccess
  • libx11
  • vdpau

Optional dependencies needed for ninja build (faster recompile times):

  • ninja

If your distribution has -dev or -devel packages, you'll also need ones corresponding to the dependencies above.

On ubuntu it can be done like this:

apt-get install cmake flex libpciaccess-dev bison libx11-dev libxext-dev libxml2-dev libvdpau-dev python3-dev

To build using ninja (recommended if you work on envytools):

$ cmake . -G Ninja
$ ninja

If you prefer to stay with make, use

$ cmake .
$ make

To install [which is optional], use

$ ninja install

or

$ make install

If you want to install to a non-default directory, you'll also need to pass it as an option to cmake before building, eg.:

$ cmake -D CMAKE_INSTALL_PREFIX:PATH=/usr/local .

Cmake options

If you don't want to compile some parts of envytools, you can pass the following options to cmake:

  • Hwtest: -DDISABLE_HWTEST=ON
  • Nva: -DDISABLE_NVA=ON
  • VDPOW: -DDISABLE_VDPOW=ON