README

Fuse-ext2 is a EXT2 Filesystem support for FUSE.

This software is based on both ntfs-3g, and ext2fuse packages.


Dependencies
------------

  Fuse-ext2 requires at least Fuse version 2.6.0 for linux, for max os latest
version of macfuse would be fine (2.0.3).

- Linux:
	Fuse from http://fuse.sourceforge.net/

- Mac OS:
	Mac Fuse from http://code.google.com/p/macfuse/


Build
-----	

- Linux:
	$ ./autogen.sh
	$ ./configure
	$ make
	$ sudo make install

	You can use checkinstall or some other equivalent tool to generate install
	package for your distribution.

- Mac OS:
	Standart build:
	$ ./autogen.sh
	$ ./configure
	$ make
	$ sudo make install

	Universal build:
	$ ./autogen.sh
	$ CFLAGS="-arch i386 -arch ppc" ./configure --disable-dependency-tracking
	$ make
	$ sudo make install
	
	Tiger (Universal) build:
	$ export MACOSX_DEPLOYMENT_TARGET="10.4"
	$ export OSX_SDK="/Developer/SDKs/MacOSX10.4u.sdk"
	$ export OSX_CFLAGS="-isysroot $OSX_SDK -arch ppc -arch i386"
	$ export OSX_LDFLAGS="-Wl,-syslibroot,$OSX_SDK -arch ppc -arch i386"
	$ ./autogen.sh
	$ CFLAGS="$OSX_CFLAGS" CXXFLAGS="$OSX_CFLAGS" LDFLAGS="$OSX_LDFLAGS" ./configure --disable-dependency-tracking
	$ make
	$ sudo make install
	
	Generating package:
	$ make package

Usage
-----

Usage:    fuse-ext2 <device|image_file> <mount_point> [-o option[,...]]

Options:  ro, force, allow_others
          Please see details in the manual.

Example:  fuse-ext2 /dev/sda1 /mnt/sda1

Advanced Example:
  Create an image:  dd if=/dev/zero of=ext2.img bs=1024 count=102400
  Format it with ext2: mke2fs ext2.img
  Mount it:  ./fuseext2 ext2.img mountpoint -o rw+
  Get debug info: ./fuseext2 ext2.img mountpoint -o rw+,debug


Bugs
----

there are no known bugs for read-only mode, read only mode should be ok for every one.

altough, write support is available (and it is pretty stable) please do not mount your
filesystems with write support unless you do not have anything to loose.

please send output the output of below command while reporting bugs.

$ /usr/local/bin/fuse-ext2 -v /dev/path /mnt/point -o debug

Labels
------

please do not use comma ',' in partition labels.

wrong: e2label /dev/disk0s3 "linux,ext3"

correct: e2label /dev/disk0s3 "linux-ext3"

Contact
-------

Alper Akcan <alper.akcan@gmail.com>