/fuse-adfs

Python modules implementing a FUSE file system for ADFS floppy disk images.

Primary LanguagePython

<?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 &lt;mount point&gt; -o image=&lt;image path&gt;
</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 &lt;mount point&gt;
</pre>
<p>or type (possibly as root):</p>
<pre>
umount &lt;mount point&gt;
</pre>
</div>
</div>
</body>
</html>