2019-08-31 16:59:21 +08:00
|
|
|
# Hi maintainers!
|
2019-08-31 05:53:13 +08:00
|
|
|
|
|
|
|
|
Here are some tips how to integrate this repo in some nice package for your distro.
|
|
|
|
|
Feel free to contact us via Github issues for any question, suggestion or if you want to share useful tricks in this file for other maintainers.
|
|
|
|
|
|
|
|
|
|
Makefile
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
`PREFIX` and `UDEV_PREFIX` can be provided by environment variable, else it defaults to `/usr/local/share` and `/etc/udev/rules.d`.
|
|
|
|
|
|
|
|
|
|
`DESTDIR` can be provided by environment variable, it can be a relative path and it will be prepended to `PREFIX`, so you can use e.g.:
|
|
|
|
|
|
2019-09-01 01:57:49 +08:00
|
|
|
```
|
|
|
|
|
make -j
|
|
|
|
|
make install DESTDIR=build PREFIX=/usr UDEV_PREFIX=/lib/udev/rules.d
|
|
|
|
|
```
|
2019-08-31 05:53:13 +08:00
|
|
|
|
|
|
|
|
and it will be deployed as
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
./build/lib/udev/rules.d/77-pm3-usb-device-blacklist.rules
|
|
|
|
|
./build/usr/bin/proxmark3 ...
|
|
|
|
|
./build/usr/share/doc/proxmark3/...
|
2019-08-31 06:26:35 +08:00
|
|
|
./build/usr/share/proxmark3/firmware/fullimage.elf
|
|
|
|
|
etc.
|
2019-08-31 05:53:13 +08:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
That should be a good start for you to create your package :)
|
|
|
|
|
|
2019-09-05 14:45:12 +08:00
|
|
|
If you need to tune some more paths, see their definition in `Makefile.defs`.
|
|
|
|
|
E.g. you might need to move the documentation elsewhere according to your distro policy:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
make install PREFIX=/usr INSTALLDOCSRELPATH=/share/doc/proxmark3-${version}/
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Be careful to respect the same leading/closing `/` schema else you'll mess up your paths!
|
|
|
|
|
|
2019-08-31 06:26:35 +08:00
|
|
|
It's possible to add other firmwares as well with tagged names (`FWTAG=<mytag>`), e.g. here we're compiling another image for non-RDV4 devices:
|
|
|
|
|
|
2019-09-05 06:37:25 +08:00
|
|
|
```
|
|
|
|
|
make -j fullimage PLATFORM=PM3OTHER PLATFORM_EXTRAS=
|
|
|
|
|
make fullimage/install PLATFORM=PM3OTHER PLATFORM_EXTRAS= DESTDIR=build PREFIX=/usr FWTAG=other
|
|
|
|
|
```
|
2019-08-31 06:26:35 +08:00
|
|
|
|
|
|
|
|
and it will be added along the other firmware as:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
./build/usr/share/proxmark3/firmware/fullimage-other.elf
|
|
|
|
|
```
|
|
|
|
|
|
2019-08-31 05:53:13 +08:00
|
|
|
For verbose usage and see the actual commands being executed, add `V=1`.
|
|
|
|
|
|
|
|
|
|
`CFLAGS` and `LDFLAGS` can be overriden by environment variables.
|
|
|
|
|
|
|
|
|
|
Default compiler is gcc but you can use clang for the non-ARM parts with e.g. `make client CC=clang CXX=clang++ LD=clang++`.
|
|
|
|
|
|
2019-09-05 01:15:13 +08:00
|
|
|
`make install` is actually triggering the following individual targets which can be accessed individually:
|
|
|
|
|
|
|
|
|
|
* `make client/install`
|
|
|
|
|
* `make bootrom/install`
|
|
|
|
|
* `make fullimage/install` (alias of `make armsrc/install`)
|
|
|
|
|
* `make recovery/install`
|
|
|
|
|
* `make mfkey/install`
|
|
|
|
|
* `make nonce2key/install`
|
|
|
|
|
* `make fpga_compress/install` (dummy)
|
2019-09-05 06:37:25 +08:00
|
|
|
* `make common/install` (some shared content installation:)
|
2019-09-05 01:15:13 +08:00
|
|
|
* `pm3-*` scripts
|
|
|
|
|
* `tools/jtag_openocd`, `traces`
|
|
|
|
|
* `doc/md`, `doc/*.md`
|
|
|
|
|
* Tools scripts (`pm3_eml2lower.sh` etc)
|
2019-09-05 15:29:45 +08:00
|
|
|
* SIM firmware
|
2019-09-05 01:15:13 +08:00
|
|
|
* udev rule on Linux
|
|
|
|
|
|
|
|
|
|
Same logic for `make all`, `make clean`, `make uninstall`
|
