Version 1.0.0
Date: 01 May 2024
Author: Wolfgang Keller
USAGE
b) "java -jar fhl.jar <arguments>" (general Java package call)
c) "fhl <arguments>" (script call - if available)
Arguments: <command> [<option> [<option>]..]
For these calls you need to be in a console in the directory where the program
is located, otherwise the program package has to be addressed with path prefix.
COMMANDS
-e <source> [<target>] : creates an encrypted file from cleartext <source>
-d <source> [<target>] : creates a cleartext file from encrypted <source>
-b <batch> [<dir>] : operates a batch-file <batch> (into <dir>)
-v <source> : verify an encrypted <source> (prints registry)
-h <file> : outputs a user manual document to <file>
-h : prints a command overview to the console
-t : performs a security package selftest
OPTIONS
+a : all commands successful (batch option)
+b:<size> : activates random file-size blurring with max=<size>
+c:"<comment>" : sets a user comment
+d:<date> : sets the file timestamp (use YYYYMMDD[,hhmm])
+f : enhanced access delay loops (2.5E6)
+i : takes user passphrase from console (shows text)
+j : ignore symbolic links (directories)
+k : minor encryption quality (128 bit key)
+l : follow and replace symbolic links (directories)
+m : prune target folder (directories)
+n : sets actual time as file timestamp
+o : overwrite existing target files
+p:"<passphrase>" : sets the encryption passphrase
+q : always request user passphrase input (overrides +p)
+r : recurse into sub-folders (directories)
+s : silent mode (where possible)
+t:<dir> : sets <dir> for temporary files folder
+u : update new or younger files only
+v : activates file content verification
+w : wipe the cleartext file (implies +v)
+z : activates ZIP compression
CALL EXAMPLES
fhl -e doc/myfairy.doc a:/safes/ +v +z +o "+c:fairy has been captured, 10.2020"
fhl -d a:/safes/myfairy.doc.fhl c:/mail/postout
fhl -v a:/safes/myfairy.doc.fhl "+p:peter ging nach lourd" +v
RETURN CODES
Upon successful operation the program returns the value zero. Documented error conditions are returned as values greater zero. The following table holds the meanings of the codes.
0 = no error
1 = source invalid or undefined
2 = target invalid
3 = access key invalid
4 = source open error
5 = target create error
6 = access key mismatch
7 = file format error
8 = integrity error in result file
9 = FHL code version mismatch
10 = invalid option parameter
11 = source file too long
12 = verification failure source file
13 = verification failure target file
14 = identical source and target file
15 = target file already exists (without overwrite permission)
16 = system verification failure (self-test)
17 = batch execution error
18 = invalid batch command
19 = user termination
20 = unknown command
21 = update target restriction
99 = IO-Exception, memory overflow or system failure