===========================
Patching and compiling 
===========================

- install open2x libs first
- install sharutils worked fine 4.6.3
  * when cross compiling without sb, system should have these
- get and patch libraries (sources directory)

--prefix=PREFIX, It is actually same where to install. Just make sure if
library uses another library, they find each other. I install everything in the
/usr

...I think my sb is not in best shape yet. I don't have any idea why I need to
give LDFLAGS, CPPFLAGS... environment variables to these.


Everything but kernel module of the fuse is compiled in the scratchbox. Should
be buildable in other environments also. With some hacking at least.

-----------
fuse v2.5.3
-----------
There is two parts, library and kernel module part. Kernel module should be
compiled same compiler and flags as kernel is compiled.

* patches
  fuse-2.5.3-gp2x-kernel-module.patch
    - http://osdir.com/ml/file-systems.fuse.devel/2006-07/msg00028.html
    - workaround to the kernel module problems
  in fuse directory
    - patch p1 </path/to/patches/fuse-2.5.3-gp2x-kernel-module.patch

* Fuse tools and libraries are compiled in the scratchbox
  ./configure --prefix=/usr --disable-kernel-module
  make
  make install

* Kernel module is compiled outside scratchbox
  go to the fuse-2.5.3/kernel dir

  export PATH=/opt/open2x/gcc-3.4.4-glibc-2.3.6/arm-open2x-linux/arm-open2x-linux/bin:$PATH

  CFLAGS="-Wall  -Wstrict-prototypes -Wno-trigraphs -Os -fno-strict-aliasing\
   -fno-common -Uarm -fno-common -pipe -mapcs-32 -march=armv4 -mtune=arm9tdmi\
   -msoft-float -Uarm" ./configure --target=arm-open2x-linux\
   --host=arm-open2x-linux\
   --with-kernel=/path/to/your/already/compiled/open2x/kernel

------------------
libarchive v2.6.2
------------------
arhivemount uses libarchive to handle packages. So it have the same limits as
library have.

libarchive manual:
read support for:
     ·   old-style tar archives,
     ·   most variants of the POSIX "ustar" format,
     ·   the POSIX "pax interchange" format,
     ·   GNU-format tar archives,
     ·   most common cpio archive formats,
     ·   ISO9660 CD images (with or without RockRidge extensions),
     ·   Zip archives.
     The library automatically detects archives compressed with gzip(1),
     bzip2(1), or compress(1) and decompresses them transparently.
"""""""""""""""""""""""""""""""""""

libarchive-formats manual:
"""""""""""""""""""""""""""""""""""
   Zip format
     Libarchive can extract from most zip format archives.  It currently only
     supports uncompressed entries and entries compressed with the ``deflate''
     algorithm.  Older zip compression algorithms are not supported.
"""""""""""""""""""""""""""""""""

* patches
  libarchive-2.6.2-gp2x.patch
    - had the problem with name of the zip files. Always teo bytes later than
      it should be. So tried little trick and it worked. 
    - have investigate what really causes the problem.
  in libarchive directory
    - patch p1 </path/to/patches/libarchive-2.6.2-gp2x.patch

  ./configure --prefix=/user --disable-bsdtar LDFLAGS="-L/usr/lib -Wl,-z,defs"
  make
  make install

* -L/usr/lib - I had libbz2 installed there. -L/lib should not be mandatory.

-------------------
archivemount v0.6.0
-------------------

* patches
  archivemount-0.6.0-gp2x-configure.patch
    - patch to the configure that libarchige get libbz2 and libz to the compile test
  archivemount-0.6.0-gp2x-use-older-fuse.patch
    - make archivemount use fuse v2.5 instead of v2.6. v2.5 is last one working with 2.4.x kernels
  in archivemount directory
    - patch p1 </path/to/patches/archivemount-0.6.0-gp2x-configure.patch
    - patch p1 </path/to/patches/archivemount-0.6.0-gp2x-use-older-fuse.patch


* configure.ac is patched so
  autoreconf -f -i
  
  CPPFLAGS="-I/usr/include" LDFLAGS="-L/usr/lib" ./configure --prefix=/usr
  make
  make install


you do not have to create device node to the gp2x. Udev handles that At least with open2x.

But make sure the binaries get user and group as root (0) at the device. I got some problems with other user and group ids.

--------
examples
--------

* mount zip (zips are always readonly)
  archivemount /mnt/sd/zip-packages/app1.zip /tmp/app1

* umount
  fusermount -u /tmp/app1

* mount tar.bz2 as readonly
  archivemount -readonly /mnt/sd/tar-bz2-packages/app1.tar.bz2 /tmp/app1