CDimg|tools was mainly written under a GNU/Linux OS but should work under other UNIX flavours, and perhaps even on other platforms, albeit maybe only partially (see Dependencies below).
Installation instructions
The official source for release downloads is at http://download.gna.org/cdimgtools/. The dependencies to build the package have to be installed first (see Dependencies below).
To install directly from the sources' tree, download a release archive and extract it. The quick and simple way to install CDimg|tools with documentation in your home directory ~/.local is to run:
$ make .help $ make $ make install install-doc
Optionally, you can use the configure script to check for some dependencies and install system-wide in /usr/local:
$ ./configure
$ make
$ sudo make install
Running configure is optional but recommended. To adjust the installation process (as well as the build process) you can tell configure. For example:
$ ./configure --help $ ./configure --prefix=/usr
Or you can edit the file config.make after a call to configure, or set the Makefile variables on the command line:
$ make install prefix=$HOME/.local/stow/cdimgtools
Distributors might use the DESTDIR Makefile variable to install the files for packaging:
$ make install DESTDIR=./packagefiles
Documentation building
To avoid the installation of the documentation tool chain, pre-compiled documentation files are available in the release archives. To force the re-building of the documentation, delete the files first:
$ make distclean doc-man doc-html
RPM and DEB packages
If your system uses one of these package management systems and you have administrative privileges to install software, it is probably better to download pre-packaged source .rpm packages or .dsc (Debian source) packages, then build them to binary packages to be installed by your distribution’s package management system.
For RPM, download the file with the extension .src.rpm, then:
$ rpmbuild --rebuild --without docs cdimgtools-${version}-$RELEASE.src.rpm $ sudo rpm -i ~/rpmbuild/RPMS/$ARCH/cdimgtools-${version}-$RELEASE.$ARCH.rpm # to install it
For DEB, download the files with the extensions .dsc, .orig.tar.gz and .debian.tar.gz, then:
$ dpkg-source -x cdimgtools_${version}-${REVISION}.dsc $ cd cdimgtools-${version} $ dpkg-buildpackage -rfakeroot -b -uc $ sudo dpkg -i ../cdimgtools_${version}-${REVISION}_$ARCH.deb # to install it
Alternatively binary packages pre-built for your architecture might be available for download.
Or you can create binary (and source) packages directly from the sources' tree:
# For RPM: $ make distclean $ make rpm RPMBUILD_FLAGS="" # For DEB: $ make distclean $ make deb DEBUILD_FLAGS="--no-lintian -us -uc"
Verifying the signatures
You need to have the GnuPG key of the packager.
$ gpg --keyring cdimgtools-keyring.gpg -v cdimgtools-${version}.tar.gz.sig $ gpg --keyring cdimgtools-keyring.gpg -v cdimgtools-${version}-$RELEASE.src.rpm.sig $ dscverify --keyring cdimgtools-keyring.gpg cdimgtools_${version}-${REVISION}.dsc
Dependencies
The following tools are required:
Tool | Description |
---|---|
Perl (>= 5) |
The scripts are written in perl. |
Pod::Usage, String::Escape, Data::Hexdumper |
Perl modules required. |
a C compiler |
Only GCC has been tested. |
For decrypting scrambled DVD Video discs. |
|
For locating VOB files in an UDF filesystem. |
|
Used for building and installing. Other make programs will not work. |
The following optional tools and packages are needed for (re-)creating the configure script or for (re-)building the documentation:
Tool | Description |
---|---|
Contains autoreconf for generating configure from configure.ac. |
|
AsciiDoc (>= 8.4) |
Generates HTML and (DocBook) XML from text. |
Used by asciidoc to highlight sh code. |
|
pod2man, pod2text, pod2html are used to extract the documentation from the perl scripts. |
|
Generates UNIX manual pages from XML. |
|
xsltproc, DocBook XSL (>= 1.72.0) |
Used by xmlto for building the manual pages. |
Furthermore, you might need the programs that build RPM or DEB packages.