diff options
| author | Nikolaus Rath <Nikolaus@rath.org> | 2019-11-03 13:38:35 +0000 |
|---|---|---|
| committer | Nikolaus Rath <Nikolaus@rath.org> | 2019-11-03 13:39:23 +0000 |
| commit | 6935b49eea03ae9e6a5cd1cb9cdaa36061ee26ca (patch) | |
| tree | 00ef17e5129f87d7afd45ce4b7a881b1bc9eaf1a /sshfs.rst | |
| parent | a548abd1f33a8423bec72724a5f48eb96fa55dd2 (diff) | |
| download | sshfs-6935b49eea03ae9e6a5cd1cb9cdaa36061ee26ca.tar sshfs-6935b49eea03ae9e6a5cd1cb9cdaa36061ee26ca.tar.gz sshfs-6935b49eea03ae9e6a5cd1cb9cdaa36061ee26ca.tar.bz2 sshfs-6935b49eea03ae9e6a5cd1cb9cdaa36061ee26ca.zip | |
Add documentation of permission handling to manpage.
Fixes: #182
Diffstat (limited to 'sshfs.rst')
| -rw-r--r-- | sshfs.rst | 33 |
1 files changed, 18 insertions, 15 deletions
@@ -27,21 +27,24 @@ To unmount it:: Description =========== -SSHFS allows you to mount a remote filesystem using SSH (more -precisely, the SFTP subsystem). 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. - -SSHFS uses FUSE (Filesystem in Userspace) and should work on any -operating system that provides a FUSE implementation. Currently, -this includes Linux, FreeBSD and Mac OS X. - -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). +SSHFS allows you to mount a remote filesystem using SSH (more precisely, the SFTP +subsystem). 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. + +By default, file permissions are ignored by SSHFS. Any user that can access the filesystem +will be able to perform any operation that the remote server permits - based on the +credentials that were used to connect to the server. If this is undesired, local +permission checking can be enabled with ``-o default_permissions``. + +By default, only the mounting user will be able to access the filesystem. Access for other +users can be enabled by passing ``-o allow_others``. In this case you most likely also +want to use ``-o default_permissions``. + +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). Options |