<?xml version="1.0" encoding="utf-8" ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" /> <title>fuse_adfs</title> <meta name="author" content="David Boddie" /> <meta name="date" content="2017-11-25" /> </head> <body> <div> <h1>fuse_adfs</h1> <table frame="void" rules="none"> <col /> <col /> <tbody valign="top"> <tr><th>Author:</th> <td>David Boddie</td></tr> <tr><th>Date:</th> <td>2017-11-25</td></tr> <tr><th>Version:</th> <td>0.21</td></tr> </tbody> </table> <div> <p><a name="contents">Contents</a></p> <ul> <li><a href="#introduction">Introduction</a></li> <li><a href="#requirements">Requirements</a></li> <li><a href="#installing-fuse-adfs">Installing fuse_adfs</a></li> <li><a href="#mounting-an-image">Mounting an image</a></li> <li><a href="#unmounting-an-image">Unmounting an image</a></li> <li><a href="#references">References</a></li> </ul> </div> <div> <h1><a name="introduction">Introduction</a></h1> <p>The <tt><span>fuse_adfs</span></tt> module provides a Filesystem in Userspace (<a href="http://fuse.sourceforge.net/">FUSE</a>) utility for presenting the contents of ADFS floppy disc images as a mountable filing system on Linux, relying on the <tt><span>ADFSlib</span></tt> module for its image reading facilities.</p> <p>With this filing system, disc images can be mounted in the same way as floppy discs and CDROMs, and navigated at the command line or with a file manager. The filing system translates ADFS-style filenames to Unix-friendly ones and adds suffixes to filenames to help applications recognize certain types of files.</p> </div> <div> <h1><a name="requirements">Requirements</a></h1> <p>This utility requires both <a href="http://fuse.sourceforge.net/">FUSE</a> and the <a href="http://cvs.sourceforge.net/viewcvs.py/fuse/python/">Python bindings package for FUSE</a>. The Python bindings need to be obtained from the FUSE project site - see the following Wiki page for more information:</p> <pre> http://fuse.sourceforge.net/wiki/index.php/FusePython </pre> <p>Follow the instructions given in the package for the Python bindings to install them. Once this has been done, the <tt><span>fuse_adfs</span></tt> utility can be installed.</p> </div> <div> <h1><a name="installing-fuse-adfs">Installing fuse_adfs</a></h1> <p>Enter the <tt><span>fuse-adfs</span></tt> directory and type:</p> <pre> python setup.py build </pre> <p>Then, as root, type:</p> <pre> python setup.py install </pre> </div> <div> <h1><a name="mounting-an-image">Mounting an image</a></h1> <p>Before the <tt><span>fuse_adfs.py</span></tt> script can be run, the kernel module that provides the userspace support must be loaded. The <tt><span>fuse_setup.py</span></tt> script provided can be run as root to load the <tt><span>fuse</span></tt> kernel module as required.</p> <p>Alternatively, you can type the following as root:</p> <pre> modprobe fuse </pre> <p>As a normal user, you can now mount an ADFS image with the <tt><span>fuse_adfs.py</span></tt> utility, using the following syntax:</p> <pre> fuse_adfs.py <mount point> -o image=<image path> </pre> <p>Note that the mount point must refer to an empty directory.</p> </div> <div> <h1><a name="unmounting-an-image">Unmounting an image</a></h1> <p>When you have finished with an image, type:</p> <pre> fusermount -u <mount point> </pre> <p>or type (possibly as root):</p> <pre> umount <mount point> </pre> </div> </div> </body> </html>