From 008cf7bcf4e6c315566b964985c14d776f74e636 Mon Sep 17 00:00:00 2001 From: Nikolaus Rath Date: Mon, 21 Dec 2015 19:21:50 -0800 Subject: Renamed README to README.md for Markdown rendering on Github. Remaining README file is just to make automake happy. --- README | 75 ++------------------------------------------------------------- README.md | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 74 insertions(+), 73 deletions(-) create mode 100644 README.md diff --git a/README b/README index 1fdad40..5efad5c 100644 --- a/README +++ b/README @@ -1,74 +1,3 @@ -Abstract -======== +Please look at README.md -This is a filesystem client based on the SSH File Transfer Protocol. -Since most SSH servers already support this protocol it is very easy -to set up: i.e. on the server side there's nothing to do. On the -client side mounting the filesystem is as easy as logging into the -server with ssh. - -The idea of sshfs was taken from the SSHFS filesystem distributed with -LUFS, which I found very useful. There were some limitations of that -codebase, so I rewrote it. Features of this implementation are: - - - Based on FUSE (the best userspace filesystem framework for Linux ;) - - - Multithreading: more than one request can be on it's way to the - server - - - Allowing large reads (max 64k) - - - Caching directory contents - - - Reconnect on failure - -Latest version -============== - -The latest version and more information can be found on - - http://fuse.sourceforge.net/sshfs.html - - -How to mount a filesystem -========================= - -Once sshfs is installed (see next section) running it is very simple: - - sshfs hostname: mountpoint - -Note, that it's recommended to run it as user, not as root. For this -to work the mountpoint must be owned by the user. If the username is -different on the host you are connecting to, then use the -"username@host:" form. If you need to enter a password sshfs will ask -for it (actually it just runs ssh which ask for the password if -needed). You can also specify a directory after the ":". The default -is the home directory. - -Also many ssh options can be specified (see the manual pages for -sftp(1) and ssh_config(5)), including the remote port number -('-oport=PORT') - -To unmount the filesystem: - - fusermount -u moutpoint - - -Installing -========== - -First you need to download FUSE 2.2 or later from: - - http://fuse.sourceforge.net - -You also need to install the devel package for glib2.0. After -installing FUSE, compile sshfs the usual way: - - ./configure - make - make install (as root) - -And you are ready to go. - -If checking out from CVS for the first time also do 'autoreconf -i' -before doing './configure'. +This file just exists to make automake happy. diff --git a/README.md b/README.md new file mode 100644 index 0000000..3738be8 --- /dev/null +++ b/README.md @@ -0,0 +1,72 @@ +Abstract +======== + +This is a filesystem client based on the SSH File Transfer Protocol. +Since most SSH servers already support this protocol it is very easy +to set up: i.e. on the server side there's nothing to do. On the +client side mounting the filesystem is as easy as logging into the +server with ssh. + +The idea of sshfs was taken from the SSHFS filesystem distributed with +LUFS, which I found very useful. There were some limitations of that +codebase, so I rewrote it. Features of this implementation are: + + - Based on FUSE (the best userspace filesystem framework for Linux ;) + + - Multithreading: more than one request can be on it's way to the + server + + - Allowing large reads (max 64k) + + - Caching directory contents + + - Reconnect on failure + +Latest version +============== + +The latest version and more information can be found on +http://github.com/libfuse/sshfs + + +How to mount a filesystem +========================= + +Once sshfs is installed (see next section) running it is very simple: + + sshfs hostname: mountpoint + +Note, that it's recommended to run it as user, not as root. For this +to work the mountpoint must be owned by the user. If the username is +different on the host you are connecting to, then use the +"username@host:" form. If you need to enter a password sshfs will ask +for it (actually it just runs ssh which ask for the password if +needed). You can also specify a directory after the ":". The default +is the home directory. + +Also many ssh options can be specified (see the manual pages for +sftp(1) and ssh_config(5)), including the remote port number +(`-oport=PORT`) + +To unmount the filesystem: + + fusermount -u moutpoint + + +Installing +========== + +First you need to download FUSE 2.2 or later from +http://github.com/libfuse/libfuse. + +You also need to install the devel package for glib2.0. After +installing FUSE, compile sshfs the usual way: + + ./configure + make + make install (as root) + +And you are ready to go. + +If checking out from git for the first time also do `autoreconf -i` +before doing `./configure`. -- cgit v1.2.3