- Generated by
1.9.1
|
Rizin
unix-like reverse engineering framework and cli tools
|
Thank you for taking the time to package Rizin!
There are some things to consider when packaging Rizin for your distribution. We will look at each step below.
If you package a Rizin Release, you will find the tarball with all dependencies used by Rizin in the Release page and you can go to the next step in this document.
If you want to package a particular git version, keep in mind that Rizin uses meson subprojects to track versions of dependencies. Subprojects are usually downloaded during the meson setup step, however if you can't download additional code while building the package for your distribution you can predownload everything with the following command:
If you want to prepare a special tarball to use within your distribution, have a look at meson dist.
See BUILDING.md for more details.
Rizin uses the meson build system. Command line flags passed to meson can change how Rizin is built.
First, we suggest you use the options -Dpackager_version=<package-version> and -Dpackager=<packager> to help us track the version of Rizin users are using, because these options are used when you run rizin -v. In this way when a user reports a issue and he provides his rizin -v output, we know how Rizin was built. Below you can see an example of how rizin uses the additional information:
Then, to define the base install location for Rizin use the --prefix flag when invoking meson. For system installs it is common to use /usr. If in doubt check your distributions packaging guidelines.
If you do not use /usr as a prefix, you may want to use -Dlocal=disabled to avoid RPATH in the installed binaries.
If you want to specify different directories for binaries, libraries, header files, etc. you may want to look at --bindir, --libdir, --includedir or check meson setup --help for more options. For extra control over the directories used by Rizin, have a look at options rizin_sdb, rizin_zigns, etc. in meson_options.txt.
Rizin uses the Capstone disassembly engine and supports versions 3, 4, and 5. By default we use a custom version of Capstone based on v4 and statically link it into the Rizin executables. Some distributions might prefer that a system version of Capstone be dynamically linked at runtime. To do this, use the -Duse_sys_capstone=enabled command line option when running meson.
You can override the version of Capstone Rizin will use by setting use_capstone_version to one of v3, v4 or next.
There are more bundled dependencies that can be swapped out for system versions. At time of writing these are:
use_sys_magicuse_sys_libzipuse_sys_zlibuse_sys_lz4use_sys_xxhashuse_sys_openssluse_sys_tree_sitterSee meson_options.txt for a complete list of compile time options.
Once you are happy with the flags you have passed to meson to configure your build you need to actually compile Rizin using ninja. You can do this with ninja -C build.
See BUILDING.md for more details.
The final step is creating a package from the build outputs. To do this it may be required to invoke DESTDIR=$PKGDIR ninja -C build install based on the distribution you are targeting.
Recall in the building step how we defined a --prefix to choose where the software was going to be installed? If we just ran ninja -C build install then we would install the software into that prefix which would be /usr using the example above. That isn't what we want when we are packaging software for distributions! Defining DESTDIR allows us to choose a base location to install to that isn't our system root. It could be something as simple as rizin which would mean that ninja would actually copy our files to ./rizin/usr/**.
There are files we want to include in the package that aren't installed using ninja so we need to add these by hand.
To do this we can use install to create directories with the desired attributes and copy the files in.
For example:
Will create a directory ${destdir}/usr/share/doc/rizin, set the attributes to 644, and copy the docs files into that new directory. See https://wiki.archlinux.org/index.php/File_permissions_and_attributes for more information about attributes and permissions.
As Rizin is trying to use SPDX, if your packace needs license/copyright information, you can use the REUSE Software to extract the license/copyright of all files in the repository.
Arch Linux PKGBUILD
Try to create packages that do not conflict with existing radare2 packages. This may require removing some shared files from the Rizin package (like the esil man page).
OSX: execute dist/osx/build_osx_package.sh on a MacOS system to create a .pkg installer in the base directory, named rizin-${VERSION}.pkg. Windows installer: execute dist/windows/build_windows_installer.ps1 Powershell script on a Windows system to create a .exe installer in dist/windows/Output, named rizin.exe.
1.9.1