Miscellaneous filesystem support for OpenSolaris on x86
=======================================================

This is the initial release of the fsmisc package that enables access to
NTFS and EXT2FS filesystems from OpenSolaris on x86 platforms.

Some of the code has been derived from the following project:

http://mount-ntfs.sourceforge.net/

HOW TO Install
--------------
1) Install the FSWpart package

   Download http://www.belenix.org/binfiles/FSWpart.tar.gz
   Uncompress:  gunzip -c FSWpart.tar.gz | tar xvf -
   Install:  pkgadd -d . FSWpart

2) Install the FSWfsmisc package

   Download http://www.belenix.org/binfiles/FSWfsmisc.tar.gz
   Uncompress:  gunzip -c FSWfsmisc.tar.gz | tar xvf -
   Install:  pkgadd -d . FSWfsmisc

Features
--------
Ability to mount NTFS and EXT2FS filesystems on primary as well as extended
partitions using the userland NFS server approach.

The ntfsprogs toolset from the Linux-NTFS project built for OpenSolaris. Allows
read/write access to NTFS primary partitions without having to mount it first.

The ntfsprogs toolset also provides a library for user programs.

The e2fsprogs toolset compiled for OpenSolaris.

Dependencies
------------
Needs the SUNWgccruntime package. This should be installed by default on
Solaris Express, or will be available on the install DVD.

Usage: Mounting EXT2FS
----------------------
To mount an EXT2FS partition you first need to identify logical device name of
the partition. Execute /usr/bin/prtpart without arguments to see the physical
device name of your harddisk. It will be of the form: /dev/rdsk/cNdNp0.  This
will also display information about the entire partition table.

Note: For more info on prtpart execute prtpart -help

Now execute:
/usr/bin/prtpart /dev/rdsk/cNdNp0 -ldevs

to list out all the logical devices and the partition types. Your Linux
partitions will be listed as "Linux Native".

Now execute:
mount -F ext2fs <logical device name> <mountpoint>

to mount the EXT2FS partition.

Usage: Mounting NTFS
--------------------
As per the above description once you list out the logical device names using
"prtpart -ldevs", You will know the device name for the NTFS partitions.

Now execute:
mount -F ntfs <logical device name> <mountpoint>

to mount the NTFS partition

Usage: Displaying mount info and Unmounting
-------------------------------------------
Since these filesystems are mounted in a different way you need to execute:
 /usr/bin/xlsmounts to see the detailed mount table info of these mounts.

The normal commands "df -h" and "cat /etc/mnttab" will only show partial NFS
related infomation.

Use "/usr/bin/xumount <logical device name>" or "/usr/bin/xumount <mountpoint>"
to cleanly unmount these filesytems. Just using umount will unmount the
filesystem but will not remove the background NFS server process.

Limitations
-----------
The approach used here uses a userland NFSv2 server to access filesystems on
raw partitions. So the NFS client in the kernel is used to access the server.
Thus the kernel's mount table always shows the filesystem as NFS and the device
as 127.0.0.1:/. You will need to execute "/usr/bin/xlsmounts" to see the real
detailed info.

Due to the same reason "/usr/bin/xumount" must be used to unmount the
filesystem and kill the NFS server.

The current implementation uses a minimal NFSv2 server and provides read-only
access. However the ntfsprogs utilities like: ntfsls, ntfscp etc. do provide
read/write access to NTFS partitions.

The NTFS mount implementation does not yet suport compressed NTFS volumes and
is a bit low on performance.  However the ntfsprogs utilities can access
compressed volumes and perform well.

The bundled ntfsprogs utilities like: ntfsls, ntfscp etc.  only operate on
primary partitions.