command-help modified by Wolfgang Keller

Wolfgang Keller — Thu, 02 May 2024 06:49:58 -0000

--- v1
+++ v2
@@ -4,9 +4,8 @@

 QUICK REFERENCE
 ---------------
-
+~~~
 USAGE
-       a) "java -jar fhl-1-0-0.jar <arguments>"  (versioned Java package call)
       b) "java -jar fhl.jar <arguments>"  (general Java package call)
        c) "fhl <arguments>"   (script call - if available)

@@ -46,7 +45,7 @@
       +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
@@ -55,8 +54,8 @@
 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
+0 = no error 
+    1 = source invalid or undefined
      2 = target invalid
      3 = access key invalid 
      4 = source open error
</arguments></arguments></arguments>

command-help modified by Wolfgang Keller

Wolfgang Keller — Thu, 02 May 2024 06:40:30 -0000

Version 1.0.0
Date: 01 May 2024
Author: Wolfgang Keller

QUICK REFERENCE

USAGE
a) "java -jar fhl-1-0-0.jar <arguments>" (versioned Java package call)
b) "java -jar fhl.jar <arguments>" (general Java package call)
c) "fhl <arguments>" (script call - if available)</arguments></arguments></arguments>

 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 [<target>]</target> : creates an encrypted file from cleartext
-d [<target>]</target> : creates a cleartext file from encrypted
-b <batch> [</batch>

] : operates a batch-file <batch> (into )
-v : verify an encrypted (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:</passphrase></date></comment></size></size>

: sets 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

</file></file></batch>

Recent changes to command-help

command-help modified by Wolfgang Keller

command-help modified by Wolfgang Keller

QUICK REFERENCE