"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "sshfs.rst" between
sshfs-3.7.0.tar.xz and sshfs-3.7.1.tar.xz

About: SSH Filesystem is based on the FUSE (Filesystem in Userspace) kernel module and uses the SSH File Transfer Protocol (SFTP) without requiring root privileges for mounting a remote filesystem.

sshfs.rst  (sshfs-3.7.0.tar.xz):sshfs.rst  (sshfs-3.7.1.tar.xz)
skipping to change at line 40 skipping to change at line 40
SSHFS allows you to mount a remote filesystem using SSH (more precisely, the SFT P SSHFS allows you to mount a remote filesystem using SSH (more precisely, the SFT P
subsystem). Most SSH servers support and enable this SFTP access by default, so SSHFS is 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. 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 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 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 credentials that were used to connect to the server. If this is undesired, local
permission checking can be enabled with ``-o default_permissions``. 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 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 likel y also users can be enabled by passing ``-o allow_other``. In this case you most likely also
want to use ``-o default_permissions``. want to use ``-o default_permissions``.
It is recommended to run SSHFS as regular user (not as root). For this to work the 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 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 direct ory. If username. If the directory is omitted, SSHFS will mount the (remote) home direct ory. If
you need to enter a password sshfs will ask for it (actually it just runs ssh wh ich ask you need to enter a password sshfs will ask for it (actually it just runs ssh wh ich ask
for the password if needed). for the password if needed).
Options Options
======= =======
skipping to change at line 157 skipping to change at line 157
-o ssh_protocol=N -o ssh_protocol=N
ssh protocol to use (default: 2) ssh protocol to use (default: 2)
-o sftp_server=SERV -o sftp_server=SERV
path to sftp server or subsystem (default: sftp) path to sftp server or subsystem (default: sftp)
-o directport=PORT -o directport=PORT
directly connect to PORT bypassing ssh directly connect to PORT bypassing ssh
-o slave -o passive
communicate over stdin and stdout bypassing network communicate over stdin and stdout bypassing network. Useful for
mounting local filesystem on the remote side. An example using
dpipe command would be ``dpipe /usr/lib/openssh/sftp-server = ssh
RemoteHostname sshfs :/directory/to/be/shared ~/mnt/src -o passive``
-o disable_hardlink -o disable_hardlink
With this option set, attempts to call `link(2)` will fail with With this option set, attempts to call `link(2)` will fail with
error code ENOSYS. error code ENOSYS.
-o transform_symlinks -o transform_symlinks
transform absolute symlinks on remote side to relative transform absolute symlinks on remote side to relative
symlinks. This means that if e.g. on the server side symlinks. This means that if e.g. on the server side
``/foo/bar/com`` is a symlink to ``/foo/blub``, SSHFS will ``/foo/bar/com`` is a symlink to ``/foo/blub``, SSHFS will
transform the link target to ``../blub`` on the client side. transform the link target to ``../blub`` on the client side.
skipping to change at line 224 skipping to change at line 227
2. The return value of the read() and write() system calls will correspond 2. The return value of the read() and write() system calls will correspond
to the return values of the read and write operations. This is useful to the return values of the read and write operations. This is useful
for example if the file size is not known in advance (before reading it). for example if the file size is not known in advance (before reading it).
e.g. /proc filesystem e.g. /proc filesystem
-o max_conns=N -o max_conns=N
sets the maximum number of simultaneous SSH connections sets the maximum number of simultaneous SSH connections
to use. Each connection is established with a separate SSH process. to use. Each connection is established with a separate SSH process.
The primary purpose of this feature is to improve the responsiveness of the The primary purpose of this feature is to improve the responsiveness of the
file system during large file transfers. When using more than once file system during large file transfers. When using more than once
connection, the *password_stdin* and *slave* options can not be connection, the *password_stdin* and *passive* options can not be
used, and the *buflimit* workaround is not supported/ used, and the *buflimit* workaround is not supported.
In addition, SSHFS accepts several options common to all FUSE file In addition, SSHFS accepts several options common to all FUSE file
systems. These are described in the `mount.fuse` manpage (look systems. These are described in the `mount.fuse` manpage (look
for "general", "libfuse specific", and "high-level API" options). for "general", "libfuse specific", and "high-level API" options).
Caveats / Workarounds Caveats / Workarounds
===================== =====================
Hardlinks Hardlinks
~~~~~~~~~ ~~~~~~~~~
 End of changes. 3 change blocks. 
5 lines changed or deleted 8 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)