
iPakk, (c) 2007 Pontscho / Fresh!mindworkz.
Email: pontscho(at)freshmindworkz(dot)hu

1. Introduction
~~~~~~~~~~~~~~~

iPakk is an LZMA based executable packer for Apple MaxOS X.

Why? Because I couldn't find a good executable packer for Apple MacOS X.

2. Download
~~~~~~~~~~~

You can download the latest binaries from here: http://www.freshmindworkz.hu/iPakk/

3. Comparison
~~~~~~~~~~~~~

Why is this packer better than others?

+ Better compression ratio than gzip or bzip2 (thanks to the LZMA compression method) 
+ It works in bundle executables (gzip or bzip2 method doesn't) 
+ Simpler usage (no need to shell script magic)

- v0.1: Bigger stub (14 KiBytes vs. 100 Bytes), I'm working on it...

+ v0.26: Smaller stub (only 2945 - 3316 bytes)

4. Changelog
~~~~~~~~~~~~

v0.1, 29/12/2006

 * initial version
 
v0.2, 20/01/2007

 * completly rewroted framework
 * completly and deeply optimized stub for MacOS X (it's only 3280-3684 bytes, 
   depend on calling and compression method)

v0.26, 02/03/2007

 * smaller stub (2945 - 3316 bytes, depend on calling and compression method)
 * several default settings changed 
         --lzma-filter-off -> --lzma-filter-auto
		 --mpl-system -> --mpl-execve
 * better compression ratio (just a very little bit:-)

v.0.27, 30/03/2007

 * smaller stub, only 2649 bytes (3020 bytes the bigger, this size is depend on filter using method)

v.0.28, 31/03/2007

 * small bugfix for PPC systems (stub size is 2801 byte)

5. Parameters
~~~~~~~~~~~~~

iPakk v0.27 (c) 2007, pontscho / fresh!mindworkz

Usage:

iPakk -i <input file> -o <output file> [...more parameters...]

Common options:
  -i : input file
  -o : output file
  --list : listing all packer and linker modules

Compressor options:
  --lzma : selecting LZMA compressor (default)

LZMA options:
  --lzma-ds : dictionary size (10..27, default: 27)
  --lzma-fb-min : fast bytes (lower limit) (5..273, default: 64)
  --lzma-fb-max : fast bytes (upper limit) (5..273, default: 273)
  --lzma-fb : fast bytes (5..273)
  --lzma-filter-on : filter turn on
  --lzma-filter-off : filter turn off
  --lzma-filter-auto : filter mode (default)
  --lzma-round-step : step value (default: 1)
  --lzma-round-inf : "infinite" compression round
  --lzma-round-n : number of compression round (default: 10)

MacOS X/PowerPC/LZMA stub options:
  --mpl-system : application calling method, like system()
  --mpl-execve : application calling method, like execve() (default)

Linker options:
  --no-stub : only compression, no link stub to the compressed datas
  --arch-ppc : for PPC architectures (default)
  --os-macosx : stub for Apple MacOS X (default)
