---------------------------------------------------------------------------

         Compute a 32-bit Fowler-Noll-Vo hash of a Given Input File

---------------------------------------------------------------------------

-----------------------
>> About
-----------------------

This is a small command-line utility that computes a 32-bit Fowler-Noll-Vo
(FNV) hash of an input file supplied on the command line. The Fowler-Noll-Vo
hash is a non-cryptographic hash function created by Glenn Fowler, Landon
Curt Noll and Phong Vo. Compared to other hash functions, the FNV hash
function is a small hashing function. The implementation in this package
computes a 32-bit hash function from an input file and is implemented using
AmigaOS functions - optionally benefiting from asyncio.library if present. 

-----------------------
>> How to install
-----------------------

  1.) Extract the archive
  2.) Copy any desired optimised variant of bin/fnv32_* to C: (or any other
      directory in the executable path)

-----------------------
>> How to compile
-----------------------

The current implementation was written to be compiled with SAS/C but you can
compile it with whatever tool available that has the required AmigaOS
libraries and include files. You may need to download dev/c/AsyncIO.lha by
Magnus Holmgren since it contains the required include files. If needed, the
include files and libraries should be moved to the SAS/C folder (libs under
libs, include under include, etc...).

After all the includes and libraries are setup correctly, you can change
directory to "src" and then issue the command:

sc link fnv32.c

and it should result in a fnv32 binary file.

-----------------------
>> How to use
-----------------------

After copying the binary to an executable path, issue:

fnv32 input.txt

where input.txt is file.

The program should print out the FNV hash of the file.

You can also specify which bits to mask off but MASK (the default is 32):

fnv32 mask=16 input.txt

-----------------------
>> Project Website
-----------------------

More information on the FNV hash can be found at:

  * http://www.isthe.com/chongo/tech/comp/fnv/
  
This implementation's website is at:

  * http://grimore.org/amiga/development/os3/fowler-noll-vo

-----------------------
>> Feedback
-----------------------

You can reach us at:

   Wizardry and Steamworks
   e-mail: office@grimore.org

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                  598    1233  48.5% -lh5- aa46 Jul 14 18:04 fnv32.info
[unknown]                  600    1233  48.7% -lh5- 3ada Jul 14 18:04 fnv32/bin.info
[unknown]                 1751    2524  69.4% -lh5- 6c27 Jul 14 17:52 fnv32/bin/fnv32_68000
[unknown]                  390     831  46.9% -lh5- 18a5 Jul 14 14:01 fnv32/bin/fnv32_68000.info
[unknown]                 1901    2732  69.6% -lh5- 0285 Jul 14 17:57 fnv32/bin/fnv32_68000FPU
[unknown]                  387     831  46.6% -lh5- 5a04 Jul 14 17:57 fnv32/bin/fnv32_68000FPU.info
[unknown]                 1755    2520  69.6% -lh5- 9ab2 Jul 14 17:58 fnv32/bin/fnv32_68020
[unknown]                  387     831  46.6% -lh5- 5a04 Jul 14 17:58 fnv32/bin/fnv32_68020.info
[unknown]                 1901    2728  69.7% -lh5- 2529 Jul 14 17:59 fnv32/bin/fnv32_68020FPU
[unknown]                  387     831  46.6% -lh5- 5a04 Jul 14 17:59 fnv32/bin/fnv32_68020FPU.info
[unknown]                 1096    2635  41.6% -lh5- 8f72 Jul 14 18:03 fnv32/fnv32.readme
[unknown]                  454     886  51.2% -lh5- 5b74 Jul 14 18:04 fnv32/fnv32.readme.info
[unknown]                  600    1233  48.7% -lh5- c1e1 Jul 14 18:04 fnv32/src.info
[unknown]                 1571    5404  29.1% -lh5- d20b Jul 14 17:43 fnv32/src/fnv32.c
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        14 files   13778   26452  52.1%            Jul 14 20:20