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.

ffindex_build version: 0.999 (off_t = 64 bits)      July 2024                                   FFINDEX_BUILD(1)