Installation

Many major Linux distribution might already package rmlint -- but watch out for the version. This manual describes the rewrite of rmlint (i.e. version \(\geq 2\)). Old versions before this might contain bugs, have design flaws or might eat your hamster. We recommend using the newest version.

If there is no package yet or you want to try a development version, you gonna need to compile rmlint from source.

Dependencies

Hard dependencies:

  • glib \(\geq 2.32\) (general C Utility Library)
  • libblkid (detecting mountpoints)
  • libelf (nonstripped binary detection)

Build dependencies:

  • git (version control)
  • scons (build system)
  • sphinx>=3.0 (manpage/documentation generation)

Here's a list of readily prepared commands for known distributions:

  • Fedora:

    $ yum -y install git scons python3-sphinx gettext
    $ yum -y install glib2-devel libblkid-devel elfutils-libelf-devel
    
  • ArchLinux:

    $ pacman -S git scons python-sphinx
    $ pacman -S glib2 libutil-linux elfutils
    
  • Ubuntu:

    $ apt-get install git scons python3-sphinx python3-nose gettext
    $ apt-get install libelf-dev libglib2.0-dev libblkid-dev
    

Send us a note if you want to see your distribution here.

Compilation

Compilation consists of getting the source and translating it into a usable binary:

$ git clone -b develop https://github.com/sahib/rmlint.git
$ cd rmlint/
$ scons config       # Look what features scons would compile
$ scons DEBUG=1 -j4  # For releases you can omit DEBUG=1
$ sudo scons DEBUG=1 --prefix=/usr install

Done!

You should be now able to see the manpage with rmlint -h or man 1 rmlint.