Menu

command-help

Wolfgang Keller

Version 1.0.0
Date: 01 May 2024
Author: Wolfgang Keller

QUICK REFERENCE

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


Related

Wiki: Home