Scroll to navigation

FFINDEX_BUILD(1) User Commands FFINDEX_BUILD(1)

NAME

ffindex_build - build file index from files in directories

DESCRIPTION

USAGE: ffindex_build [-a|-v] [-s] [-f file]* OUT_DATA_FILE OUT_INDEX_FILE [-d 2ND_DATA_FILE -i 2ND_INDEX_FILE] [DIR_TO_INDEX|FILE]*
-a
append files/indexes, also needed for sorting an already existing ffindex
-d FFDATA_FILE
a second ffindex data file for inserting/appending
-i FFINDEX_FILE a second ffindex index file for inserting/appending
-f FILE
file containing a list of file names, one per line -f can be specified up to 4096 times
-s
sort index file, so that the index can queried. Another append operations can be done without sorting.
-v
print version and other info then exit
-h
display this help message
ENVIRONMENT
FFINDEX_MAX_INDEX_ENTRIES - allocate memory for this number of entries

EXAMPLES:

Create a new ffindex containing all files from the "bar/" directory containing say myfile1.txt, myfile2.txt and sort ( -s) it so that e.g. ffindex_get can use it.
$ ffindex_build -s foo.ffdata foo.ffindex bar/
Add (-a) more files: myfile3.txt, myfile4.txt.
$ ffindex_build -a foo.ffdata foo.ffindex myfile3.txt myfile4.txt
Oops, forgot to sort it (-s) so do it afterwards:
$ ffindex_build -as foo.ffdata foo.ffindex

NOTE:

Compiled with a maximum key/filename length is 63 and default maximum entries 80000000. This can be changed in the sources.
Designed and implemented by Andreas Hauser <andy@splashground.de>.

BUGS

User feedback is welcome, especially bugs, performance issues and last but not least convenience of the programs and API.
Email Andreas Hauser hauser@genzentrum.lmu.de.
April 2018 ffindex_build version: 0.997 (off_t = 64 bits)