Please note that the CVS and issue trackers have moved to GitHub. These Trac pages are no longer kept up-to-date.

root/seattle/branches/nacl_repy/fuse/README.lind_fuse@5546

Revision 5546, 1.9 KB (checked in by cmatthew, 7 years ago)

Move the lind-fuse code from the github to seattle repo.

Line 
1The Lind-FUSE driver:
2July 2012 - Chris Matthews <cmatthew@cs.uvic.ca>
3
4
5INSTALLING:
6===========
7
8You need to have python-fuse installed to use lind fuse.  Right now there is not a lind-fuse installer. 
9
10Python fuse is in the Ubuntu package manager as "python-fuse" or it can be downloaded here:
11
12http://pypi.python.org/pypi/fuse-python/
13
14The kernel you are using must also support fuse.  That is most kernels now-a-days.
15
16Finding the Lind file system.  Lind has many subsystems, and is install in a central location. For those subsystems to interact, they use an environment variable named REPY_PATH, which is set to the location of the Lind and its Repy subfolder.
17
18USE:
19====
20
21To use lind-fuse, you can simply mount a file system, and perform operations on it. Then unmount it.  Some operations are not currently supported (such as df)
22
23EXAMPLE:
24========
25
26$ cd somepath
27$ mkdir mountpoint   # make an empty directory
28$ python <path_to_lindfuse>/lind_fuse.py mountpoint  # given the mountpoint you just made, mount a Lind-fuse filesystem into it.
29$ cd mountpoint   # now try it out
30$ ls
31$ cp -r /var/logs .
32$ ls
33$ cd ..  # when you are done
34$ fusermount -u mountpoint  # un-mount the file system.
35
36This should work as any user (not just root).
37
38The lind file system backing file used (or created) by the system will be whatever is in the local directory.
39
40
41DEBUGGING:
42==========
43
44lind fuse uses the python-fuse interface.  The code is very simple. Two classes, one which handles filesystem related system calls, and the other which does file related system calls.  To debug what is going on, you can run lind-fuse in the foreground, so you can see its output:
45
46$ python lind_fuse.py mountpoint -f
47
48Output will come out in this shell. Now go to another and do things in mountpoint.
49
50LIMITATIONS:
51============
52
53Many system calls are not implented in lind-fuse.  Most of the basic ones related to file directory creation and read/write work though.  More could be added easily.
Note: See TracBrowser for help on using the browser.