Difference between revisions of "Projects/KioFuse"

Jump to: navigation, search
(fix link)
m (Text replace - "<code>" to "<syntaxhighlight lang="text">")
Line 7: Line 7:
 
* Install kdelibs (version 4.0 or higher) provided by your Operating System or compile it according to these [http://techbase.kde.org/index.php?title=Getting_Started/Build/KDE4 intructions].
 
* Install kdelibs (version 4.0 or higher) provided by your Operating System or compile it according to these [http://techbase.kde.org/index.php?title=Getting_Started/Build/KDE4 intructions].
 
* Type the following commands into a terminal:
 
* Type the following commands into a terminal:
<code>
+
<syntaxhighlight lang="text">
 
svn checkout svn://anonsvn.kde.org/home/kde/trunk/playground/libs/kiofuse
 
svn checkout svn://anonsvn.kde.org/home/kde/trunk/playground/libs/kiofuse
 
cd kiofuse
 
cd kiofuse
Line 22: Line 22:
 
Real-world example:
 
Real-world example:
  
<code>
+
<syntaxhighlight lang="text">
 
# Create the mount point
 
# Create the mount point
 
mkdir ~/fuse-source
 
mkdir ~/fuse-source

Revision as of 21:49, 29 June 2011


Projects/KioFuse


KioFuse allows you to mount remote directories into the root hierarchy of your local file system, thereby exposing KDE's advanced access capabilities (SSH, SAMBA/Windows, FTP, TAR/GZip/BZip2, WebDav, etc) to POSIX-compliant applications such as Firefox, OpenOffice, GNOME apps, shell utilities and more. Another important advantage of KioFuse is that it allows you to arrange the hierarchy of all your remote, archived and compressed files in whichever way makes sense to you.

KioFuse works by acting as a bridge between KDE's KIO filesystem design and FUSE.

Installation

  • Install kdelibs (version 4.0 or higher) provided by your Operating System or compile it according to these intructions.
  • Type the following commands into a terminal:
svn checkout svn://anonsvn.kde.org/home/kde/trunk/playground/libs/kiofuse
cd kiofuse
cmake .
make
</code>
=== Running KioFuse ===
* Mount with:
<tt>kiofuse --mountpoint <mountpoint> --URL <URL></tt>
 
* Unmount with:
<tt>fusermount -u <mountpoint></tt>
 
Real-world example:
 
<syntaxhighlight lang="text">
# Create the mount point
mkdir ~/fuse-source
 
# Download the compressed archive of the FUSE source code
wget http://superb-east.dl.sourceforge.net/sourceforge/fuse/fuse-2.7.2.tar.gz -P ~
 
# Mount the archive in ~/fuse-source
./kiofuse --mountpoint ~/fuse-source --URL tar:~/fuse-2.7.2.tar.gz &
 
# Browse the source code in your favorite filemanager without ever needing to unpack the archive!
dolphin ~/fuse-source &
nautilus ~/fuse-source &
thunar ~/fuse-source &
</code>
=== Screenshots ===
[[image:kiofuse_example.png|frame|center]]
=== Features and TODO ===
* Some KIO slaves such as tar: don't support seeking and therefore won't be able to read or write to files. Fixing these slaves is on the [http://websvn.kde.org/trunk/playground/libs/kiofuse/TODO?view=markup TODO list].
* KIO needs to be modified so that it is aware of KioFuse mounts and so that it uses its native functions (as opposed to POSIX) to access those resources.
=== POSIX Capabilities ===
See the FUSE API for the list of all [http://fuse.sourceforge.net/doxygen/structfuse__operations.html file I/O commands].
{| border="1"
! Name !! Description !! Filename
|-
| GetAttr || Permissions, Owner, Group || style="background-color: lightgreen;" | Done
|-
| ReadLink || Determine destination of link || style="background-color: lightgreen;" | Done
|-
| MkNod || Create file || style="background-color: lightgreen;" | Done
|-
| MkDir || Create a directory || style="background-color: lightgreen;" | Done
|-
| UnLink || Remove a symlink || style="background-color: lightgreen;" | Done
|-
| RmDir || Remove a directory || style="background-color: lightgreen;" | Done
|-
| SymLink || Create a symlink || style="background-color: lightgreen;" | Done
|-
| Rename || Rename a file or directory || style="background-color: lightgreen;" | Done
|-
| Link || Create a hard link || style="background-color: lightgreen;" | Done
|-
| Chmod || Change permissions of a file or directory || style="background-color: lightgreen;" | Done
|-
| Chown || Change owner of a file or directory || style="background-color: lightgreen;" | Done
|-
| Truncate || Change the size of a file || style="background-color: lightgreen;" | Done
|-
| Open || Open a file for reading, writing, and/or truncating || style="background-color: lightgreen;" | Done
|-
| Read || Read the contents of a file || style="background-color: lightgreen;" | Done
|-
| Write || Write data to a file || style="background-color: lightgreen;" | Done
|-
| StatFS || Get Filesystem Statistics || style="background-color:#ff4242;" | Not Started
|-
| Flush || Flush cached data || style="background-color:#ff4242;" | Not Started
|-
| Release || Close an opened file || style="background-color: lightgreen;" | Done
|-
| FSync || Synchronize file contents || style="background-color:#ff4242;" | Not Started
|-
| SetXAttr || Set external attributes || style="background-color:#ff4242;" | Not Started
|-
| GetXAttr || Get external attributes || style="background-color:#ff4242;" | Not Started
|-
| ListXAttr || List external attributes || style="background-color:#ff4242;" | Not Started
|-
| RemoveXAttr || Remove external attributes || style="background-color:#ff4242;" | Not Started
|-
| OpenDir || Open a directory || style="background-color:#ff4242;" | Not Started
|-
| ReadDir || List files and subdirectories || style="background-color: lightgreen;" | Done
|-
| ReleaseDir || Release directory || style="background-color:#ff4242;" | Not Started
|-
| FSyncDir || Synchronize directory contents || style="background-color:#ff4242;" | Not Started
|-
| Init || Initialize filesystem || style="background-color:#ff4242;" | Not Started
|-
| Destroy || Clean up filesystem || style="background-color:#ff4242;" | Not Started
|-
| Access || Check file access permissions || style="background-color:#ffc642;" | Work In Progress
|-
| Create || Create and open a file || style="background-color:#ff4242;" | Not Started
|-
| FTruncate || Change the size of an open file || style="background-color:#ff4242;" | Not Started
|-
| FGetAttr || Get attributes of an open file || style="background-color:#ff4242;" | Not Started
|-
| Lock || Lock a resource || style="background-color:#ff4242;" | Not Started
|-
| UTimeNS || Change the access and mod times in nanoseconds || style="background-color:#ff4242;" | Not Started
|}
=== Source Code ===
The source code to KioFuse can be browsed at:
http://websvn.kde.org/trunk/playground/libs/kiofuse/

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal