CurlFtpFS - A FTP filesystem based on cURL and FUSE
CurlFtpFS - A FTP filesystem based on cURL and FUSE Description CurlFtpFS is a filesystem for accessing FTP hosts based on FUSE and libcurl. Features CurlFtpFS differentiates itself from other FTP filesystems because it features: SSLv3 and TLSv1 support connecting through tunneling HTTP proxies automatically reconnection if the server times out transform absolute symlinks to point back into the ftp file system Downloads Use the project page at sourceforge: http://sf.net/projects/curlftpfs Examples Using CurlFtpFS is quite simple. Take a look at this example: $ mkdir sunet $ curlftpfs ftp://ftp.sunet.se/ sunet/ $ cd sunet/ $ ls -l total 0 Dr-xr-xr-x 3 root root 96 Feb 23 2004 bin dr-xr-xr-x 2 root root 72 Mar 2 2004 dev dr-xr-xr-x 2 root root 48 Feb 23 2004 etc dr-xr-xr-x 2 root root 120 Feb 23 2004 lib -rw-r--r-- 1 root root 622187310 Mar 11 06:13 ls-lR -rw-r--r-- 1 root root 76389037 Mar 11 06:15 ls-lR.gz drwxrwxr-x 37 root root 1272 Feb 27 14:17 pub dr-xr-xr-x 3 root root 72 Feb 23 2004 usr $ cd .. $ fusermount -u sunet/ News 05-Apr-2007 - Version 0.9.1 released This release adds options for inputting the password in the terminal, support for different codepages, caching of files not found, support for SOCKS proxy, and bug fixes as usual. 12-Feb-2007 - New libcurl version I noticed there is a new version of libcurl: 7.16.1. It seems to be working fine with CurlFtpFS. Problem with 7.15.5: curlftpfs hangs when making differential backups using DAR Problem with 7.16.0: Problem downloading 2 zero byte files with FTP 22-Jan-2007 - Bad libcurl versions A lot of users are reporting problems with CurlFtpFS. We tracked this problems to bugs in libcurl versions 7.15.5 and 7.16.0. Since we depend on 7.15.2 or later and versions 7.15.2 and 7.15.3 have a bug that makes CurlFtpFS do not reuse the connection all the time, the current recommended version of libcurl is either 7.15.4 or the development branch. 02-Oct-2006 - Version 0.9 released This release adds patches to enable utf8 support and to enable chmod and chown. 25-May-2006 - Version 0.8 released The long awaited chunk downloading is here! Now you can stream your music/video, download more than one file or browse the filesystem while you download. Thanks a lot to Andreas Jackisch that helped a lot during the test phase. Note that this version only works with libcurl version 7.15.2 or higher. The older versions had a bug that made the FTP connection hang after aborting a download. I contributed a patch to libcurl that will prevent CurlFtpFS from reconnecting to the FTP server every time it has to restart a download. It will be released with libcurl 7.15.4. If you need this functionality, you can grab the CVS version of libcurl or grab a curl daily snapshot. FAQ How do I specify a user name and password? There are two ways. First using the url, as in ftp://user:pass@site.com/. The second is using the option -o user, as in -o user="user:pass". How can I prevent the password from showing in the process list? You can put the user and password in a .netrc file in the home directory of the user that executes CurlFtpFS. It can have 600 permission. It's still clear text but at least is not accessible by all. The format is: machine ftp.host.com login myuser password mypass How can I make CurlFtpFS mount automatically at startup? You can add it to /etc/fstab. Example: curlftpfs#ftp.host.com /mnt/host fuse rw,uid=500,user,noauto 0 0 My FTP server puts me in my home dir. How do I mount the root directory? Just use as many ".." as necessary. Example: curlftpfs ftp://ftp.myserver.com/../../.. /mnt/ftp CurlFtpFS just hangs. What should I do? There is a bug with curl 7.15.5 and 7.16.0, please use another version. See: http://sourceforge.net/tracker/index.php?func=detail&aid=1618359&group_id=976&atid=100976. If this is not the problem, run the program with -d -v -o ftpfs_debug in a separate terminal, repeat the commands that make it crash and file an issue posting the output. Enjoy! Robson Braga Araujo - <braga (a) users sf net> Last Updated: Mon Jun 14 10:41:52 BRT 2007 This project is kindly hosted by:
CurlFtpFS differentiates itself from other FTP filesystems because it features: SSLv3 and TLSv1 support connecting through tunneling HTTP proxies automatically reconnection if the server times out transform absolute symlinks to point back into the ftp file system
