Universal Molotilka 0.3.7 DOCUMENTATION
Copyright (c) 2011, Alexej Silaev ArchFurry@gmail.com
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1. Installing
1.1 UNIX-like OS and MinGW
unpack molotilka-0.3.7.tar.gz:
$ tar xfz molotilka-0.3.7.tar.gz
$ cd molotilka-0.3.7
type:
$ make && make test
copy molotilka into /usr/local/bin
$ cp molotilka /usr/local/bin
2 Using command-line interface
2.1 Generating key file
Key file - 64kbyte file for replacement table
SYNTAX:
molotilka -g mykey.key 123466 # 123466 -- seed
2.2 Encrypting file
SYNTAX
molotilka -e -i input.txt -o output.pf2 -k mykey.key -p weryqwasdhjfs
-e -- Tells program that we encrypt given file(-e default)
-i input.txt -- input file to encrypt
-o output.pf2 -- encrypted output file
-k mykey.key -- key file
-p passw -- password
2.3 Decrypting file
SYNTAX
molotilka -d -i output.pf2 -o output.txt -k mykey.key -p weryqwasdhjfs
-d -- Tells program that we decrypt given file
-i output.pf2 -- input file to decrypt
-o output.txt -- decrypted output file
-k mykey.key -- key file
-p passw -- password
2.4 SIMPLE SYNTAX
Encryption:
molotilka -i input.txt -k mykey.key -p Wnsdb3dsf4u
Defaults: output file name: input.txt.pf2
Decryption:
molotilka -d -i input.txt.pf2 -k mykey.key -p Wnsdb3dsf4u
Defaults: output file name: input.txt.pf2.out
2.5 SIMPLE TOKEN SYNTAX
Encryption:
molotilka -i input.txt -t 123-4343-5665-afff -p Wnsdb3dsf4u
Defaults: output file name: input.txt.pf2
Decryption:
molotilka -d -i input.txt.pf2 -t 123-4343-5665-afff -p Wnsdb3dsf4u
Defaults: output file name: input.txt.pf2.out
================================================================================
= Universal Molotilka Version History
= Universal Molotilka is available at https://sourceforge.net/projects/puff/
================================================================================
=
= *+ Major new feature, or major overhaul to an area.
= *- Major bug fix or removal.
= + Added feature, or noticeable improvement.
= - Bug fix, or something removed.
= ! Something has changed, or just general information.
=
================================================================================
0.3.7
-----
*+Full rewrite!
0.3.6
-----
*+New api
*+SAFE_FILE_ENC
*-MD5 password hash
*+puffhash
*+PHASH password hash
-BMPsplitter
-SafeRM
0.3.5a
------
*+Puff_stream in library
+now libpuff.a
+Security fixes (Not compatible with 0.3.5)
+Without -o flag on encryption puff will append .pf2 suffix,
on decryption puff will append .out suffix
+puffgen is part of pufflib
use puff -g mykey.key
-Some bug fixes...
0.3.5
------
+void puff_form_keys(char *password, uint32_t *key, uint32_t *init_key);
Function that inizializes key & init_key
password -- null terminated password string
*+MD5 password hash
*-CRC32 password hash
-Some bug fixes...
0.3.4c
------
+SafeRM
use: saferm file
rm file
+Only one password!
+Proggress bar
Uncomment //#define PROGRESS_BAR 1 in config.h
-Removed FAST an CHEB mode, only DEEP
+Speed test
Uncomment //#define SPEED_TEST 1 in config.h
0.3.4b
------
-Some bug fixes...
!Deep mode is now default!
!Some code cleanings
*+ Two new string encryption functions and test program that shows how to use:
uint8_t * puff_data_enc(uint8_t *opentext, uint32_t key, uint32_t init_key);
uint8_t * puff_data_dec(uint8_t *cryptotext, uint32_t key, uint32_t init_key);
0.3.4a
------
+Some test in Makefile
-Magic Number!
*-Security changes: unsecure nulls at end of file
0.3.4
-----
*+Support fo large files(added size_t type)
!Splitted header for more compatibility
*+ Security changes: two new encryption modes
-Some bug fixes with command line
*+BMPsplitter
