puff Files

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