tbimount
~~~~~~~~~
tbimount is a free utility that allows you to mount .tbi files that have
been created by TeraByte Unlimited's Image for DOS, Image for Linux, or
Image for Windows applications on Linux based OSes.

If the partition in the image being mounted is supported by Linux then
you'll be able to mount the device to access individual files or folders 
within the image via standard linux mount point.

License
~~~~~~~
See the license.txt file which is included with this package.


Installation:
~~~~~~~~~~~~~

1.  Extract the files in the ZIP archive to a new folder.

Use:
~~~~

1.  Load the module (tbimount.ko) from the appropriate subdirectory
    using the insmod command.  e.g. insmod tbimount.ko
	
1.  Once the module is loaded and active you can run the tbimount 
    application from the same folder you extracted the ZIP archive.
	
	To mount a file: ./tbimount mount filename.tbi 
	To unmount all mounted: ./tbimount unmount
    
	For the full command line options, simply run tbimount without
	any command line options.


Uninstallation:
~~~~~~~~~~~~~~~

1.  Remove the module using rmmod.  e.g. rmmod tbimount

2.  Delete the folder to which you extrated the tbimount ZIP file to 
    during installation or only the tbimount files if you extracted
	the files to a folder shared with other files that should not be 
	deleted.


Notes:
~~~~~~
*) The devices created for mounting are /dev/tbia, /dev/tbib, etc..

*) When mounting a mount point in linux you must use the read-only 
   option.   e.g. mount -o ro /dev/tbia /mnt

*) You should use .tbi files that will be available to the system
   for the entire time the file is mounted.  In other words, don't 
   use files split across CD's, UFD's, etc..

*) The following module parameters are available:

   MountMajor:
     Use this option to force a major device number for the /dev/tbi*
     devices created.  The default is zero to have the system create 
     a unique value.
  
   MountNumDevices:
     Use this option to choose the number of mounted devices to support.  
     The default is 10.  Valid range is 2 to 27
  
   MountNumIndexes:
     Use this to adjust the internal indexes used by TBIMount.  The
     valid range for the value is 20 to 500, the default is 100.
     Larger values may be slower on systems with a slow CPU, but may
     be faster when the file is on a slow IO device.  Lower values
     may speed up access on systems with a slow CPU, but may slow down
     access on a slower IO device.

	 
Distro Use:
~~~~~~~~~~~
This section is for avanced users.  Normal users should just use the
Image for Linux boot disk to load the module.  More details on how
to use in IFL will be given in the future.

The zip includes builds based on the ubuntu kernel configuration files
found at http://kernel.ubuntu.com/~kernel-ppa/configs/ and running
make olddefconfig prior to the build.

The kernel version chosen was based starting at 3.08 and finding 
versions where modules_layout was sure to change due to source code
changes to the modules structure layout.  3.8->3.11, 3.12, 3.13->3.17, 
3.18, 3.19, 4.0, 4.1, 4.2->4.3, 4.4->

Built using Debian Wheezy: 3.2.0-4-686-pae (gcc version 4.6.3)

Note the following:

*) Unless a custom kernel was built to not use signatures, the modules
will need to be signed.  You will need to rebuild your kernel to acquire 
the certificates needed to sign the module.   From the directory containing
the source of the built kernel:

  scripts/sign-file sha512 signing_key.priv signing_key.x509 tbimount.ko

*) To add it for use by modprobe:
	sodo -s
	ln -s /path/to/tbimount.ko /lib/modules/`uname -r`
	depmod -a
	modprobe tbimount
