blob: c72a0b882d6dd3620e527eb92078c40aa6f22849 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
envytools - Tools for people envious of nvidia's blob driver.
The canonical repo is at: http://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 http://envytools.rtfd.org)
- ``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 nva:
- ``libpciaccess``
Optional dependencies needed by vdpow:
- ``vdpau``
- ``libx11``
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``
|