XLocate version 0.82, January 20, 2024
Copyright © version Alexandre Oberlin <https://migo.info/contact_en.php>
----------------------------------------------------------------------
XLocate is a file system index management tool and a front-end to the most popular GNU-Linux fast search utilities. XLocate allows you to maintain a collection of databases for fixed and removable hard disks, shelved CD/DVD/Blu-ray collections, network places, memory sticks etc. You can define search sets and get a high level of flexibility through extensive options. XLocate automatically recognizes through libmagic the most widespread locate database formats (GNU locate, slocate and mlocate/plocate). XLocate’s versions from 0.81 keep track of your disk partitions using their UUID, so you don’t have to specify anything in order to add them to the catalogue. You can conveniently search for files using any of the locate tools, even if not installed in your path. You can also transparently create and update indices from within the application.
Prerequisites for source package
- Qt development kit, version, 4.7 or higher (mandatory), available at:
https://www.qt.io/download-open-source
- at least one of those:
- slocate version, 2.7 or higher
- GNU locate from package findutils version, 4.2.15 or higher
- mlocate version, 0.23.1 or higher
- plocate, any version
All the above software comes along with any recent distribution.
Configuration options:
$ ./configure --help
Usage: configure [ -e | -u | -p | -t | -d install_dir | -h ]
Configure script for XLocate-0.82, relying on installed version of Qt.
-e configure without file display/edition functionality
-u configure without input method menu item
-p add debugging code
-t do nothing, just test for Qt version
-d dir install to given directory (default /usr)
-h this help.
Please check value of environment variable QT_SELECT before running this script.
Examples:
Standard version: ./configure
Standard development version: ./configure -p -d /usr/local
Do not forget to check INCLUDEPATH VPATH and QMAKE_MAKEFILE in pro file !
No use of slinks in src or cleansrc directories, use INCLUDEPATH and VPATH in dotpro file
Do not forget to adjust OBJECTS_DIR, MOC_DIR and DESTDIR,
Quick installation instructions:
Let's suppose you downloaded the archive xlocate-0.82.tar.gz in /tmp
$> cd /tmp
$> tar -xvzf xlocate-0.82.tar.gz
$> cd xlocate-0.82
$> ./configure
$> make
$> su -c 'make install' # (enter root password)
Notes
1. Building on Qt3 is now deprecated, as you wouldn't get the last improvements since version, 0.65.
2.If you have several versions of Qt installed, be sure your QTDIR environment variable is set correctly.
3. The default installation stores index files in a directory /var/lib/xlocate having permissions 775. Since this directory has group write access you can create new index files in it by calling locate updating utilities (updatedb) through XLocate as a simple user. You can also update/delete/rename existing index files provided the individual file permissions are set accordingly (recommended setting 664, with group owner slocate). XLocate should not be setuid nor setgid. Giving universal write access to the directory /var/lib/xlocate is strongly discouraged.
4. XLocate can manage index files from several directories outside /var/lib/xlocate. In case you have permissions issues due to administration policies, you then can index whatever you want and put the index files in a personal directory (e.g. ~/xlocate).
