puff Files

PUFF-0.3.5 DOCUMENTATION
1. Installing
1.1 UNIX-like OS and MinGW
	unpack puff-0.3.5.tar.gz:

	$ tar xfz puff-0.3.5.tar.gz
	$ cd puff-0.3.5
	
	type:
	
	$ make && make test

	copy puff and puffgen into /usr/local/bin

	$ cp puff /usr/local/bin
	$ cp puffgen /usr/local/bin

2 Using command-line interface
2.1 Generating key file
Key file - 64kbyte file for replacement table
SYNTAX:

	puffgen mykey.key

2.2 Encrypting file

SYNTAX

	puff -e -i input.txt -o output.pf -k mykey.key -p weryqwasdhjfs -bz 2048


-e -- Tells program that we encrypt given file(-e default)
-i input.txt -- input file to encrypt
-o output.pf -- encrypted output file
-k mykey.key -- key file
-p passw -- password
-bz 2048 block size must be divisible by 4



2.3 Decrypting file

SYNTAX

	puff -d -i output.pf -o output.txt -k mykey.key -p weryqwasdhjfs -bz 2048

-d -- Tells program that we decrypt given file
-i output.pf -- input file to decrypt
-o output.txt -- decrypted output file
-k mykey.key -- key file
-p passw -- password
-bz 2048 block size must be divisible by 4


================================================================================
= PUFF Version History
= Puff 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.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