diff options
author | Nikolaus Rath <Nikolaus@rath.org> | 2017-06-06 10:03:15 -0400 |
---|---|---|
committer | Nikolaus Rath <Nikolaus@rath.org> | 2017-06-06 10:03:15 -0400 |
commit | 8cc069f666a8c0f1b3d2e7c8904e5b88032b410f (patch) | |
tree | ea074bea3357be1662e5e1c915063fb160376d3e /README.md | |
parent | d7cb098f1d1f1f5e1663c61794074934443a095d (diff) | |
download | sshfs-8cc069f666a8c0f1b3d2e7c8904e5b88032b410f.tar sshfs-8cc069f666a8c0f1b3d2e7c8904e5b88032b410f.tar.gz sshfs-8cc069f666a8c0f1b3d2e7c8904e5b88032b410f.tar.bz2 sshfs-8cc069f666a8c0f1b3d2e7c8904e5b88032b410f.zip |
Reworked README
Now also includes mailing list.
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 93 |
1 files changed, 45 insertions, 48 deletions
@@ -1,75 +1,72 @@ -Abstract -======== +======= + SSHFS +======= -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: +About +===== - - Based on FUSE (the best userspace filesystem framework for Linux ;) +SSHFS allows you to mount a remote filesystem using SFTP. Most SSH +servers support and enable this SFTP access by default, so SSHFS is +very simple to use - there's nothing to do on the server-side. - - 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 -========================= +How to use +========== Once sshfs is installed (see next section) running it is very simple: - sshfs hostname: mountpoint + sshfs [user@]hostname:[directory] 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. +It is recommended to run SSHFS as regular user (not as root). For +this to work the mountpoint must be owned by the user. If username is +omitted SSHFS will use the local username. If the directory is +omitted, SSHFS will mount the (remote) home directory. If you need to +enter a password sshfs will ask for it (actually it just runs ssh +which ask for the password if needed). Also many ssh options can be specified (see the manual pages for -sftp(1) and ssh_config(5)), including the remote port number +*sftp(1)* and *ssh_config(5)*), including the remote port number (`-oport=PORT`) To unmount the filesystem: fusermount -u mountpoint -On macOS, to unmount the filesystem: +On BSD and OS-X, to unmount the filesystem: umount mountpoint -Installing -========== -First you need to download FUSE 2.2 or later from -http://github.com/libfuse/libfuse. +Installation +============ + +First, download the latest SSHFS release from +https://github.com/libfuse/sshfs/releases. On Linux and BSD, you will +also need to have [libfuse](http://github.com/libfuse/libfuse) +installed. On OS-X, you need [OSXFUSE](https://osxfuse.github.io/) +instead. Finally, you need the +[glib](https://developer.gnome.org/glib/stable/) development package +(which should be available from your operating system's package +manager). -You also need to install the devel package for glib2.0. After -installing FUSE, compile sshfs the usual way: +To compile and install SSHFS, extract the tarball and run: ./configure make - make install (as root) + sudo make install + +When checking out from git (instead of using a release tarball), you +will need to run `autoreconf -i` before `./configure`. + +Getting Help +============ + +If you need help, please ask on the [SSHFS mailing +list](http://groups.google.com/group/sshfs). To post to the list, +please don't use the web interface but send an email to +<sshfs@googlegroups.com>. -And you are ready to go. +Please report any bugs on the GitHub issue tracker at +https://github.com/libfuse/libfuse/issues. -If checking out from git for the first time also do `autoreconf -i` -before doing `./configure`. |