sshfs.pdf

SSHFS(1) User Commands SSHFS(1)

NAMESSHFS − filesystem client based on ssh

SYNOPSISmounting

sshfs [user @]host:[dir ] mountpoint [options]

unmounting

fusermount -u mountpoint

DESCRIPTIONSSHFS (Secure SHell FileSystem) is a file system for Linux (and other operating systems with a FUSE

implementation, such as Mac OS X or FreeBSD) capable of operating on files on a remote computer using

just a secure shell login on the remote computer. On the local computer where the SSHFS is mounted, the

implementation makes use of the FUSE (Filesystem in Userspace) kernel module. The practical effect of

this is that the end user can seamlessly interact with remote files being securely served over SSH just as if

they were local files on his/her computer. On the remote computer the SFTP subsystem of SSH is used.

If host is a numeric IPv6 address, it needs to be enclosed in square brackets.

OPTIONSgeneral options:

−o opt,[opt...]

mount options

−h −−help

print help

−V −−version

print version

SSHFS options:

−p PORT

equivalent to ’−o port=PORT’

−C equivalent to ’−o compression=yes’

−F ssh_configfile

specifies alternative ssh configuration file

−1 equivalent to ’−o ssh_protocol=1’

−o reconnect

reconnect to server

−o delay_connect

delay connection to server

−o sshfs_sync

synchronous writes

−o no_readahead

synchronous reads (no speculative readahead)

−o sshfs_debug

print some debugging information

−o cache=BOOL

enable caching {yes,no} (default: yes)

−o cache_timeout=N

sets timeout for caches in seconds (default: 20)

−o cache_X_timeout=N

sets timeout for {stat,dir,link} cache

SSHFS version 2.0 April 2008 1


−o workaround=LIST

colon separated list of workarounds

none no workarounds enabled

all all workarounds enabled

[no]rename

fix renaming to existing file (default: off)

[no]nodelaysrv

set nodelay tcp flag in ssh (default: off)

[no]truncate

fix truncate for old servers (default: off)

[no]buflimit

fix buffer fillup bug in server (default: on)

−o idmap=TYPE

user/group ID mapping, possible types are:

none no translation of the ID space (default)

user only translate UID of connecting user

file translate UIDs/GIDs based upon the contents of uidfile and gidfile

−o uidfile=FILE

file containing username:uid mappings for idmap=file

−o gidfile=FILE

file containing groupname:gid mappings for idmap=file

−o nomap=TYPE

with idmap=file, how to handle missing mappings

ignore don’t do any re-mapping

error return an error (default)

−o ssh_command=CMD

execute CMD instead of ’ssh’

−o ssh_protocol=N

ssh protocol to use (default: 2)

−o sftp_server=SERV

path to sftp server or subsystem (default: sftp)

−o directport=PORT

directly connect to PORT bypassing ssh −o slave communicate over stdin and stdout bypassing

network

−o transform_symlinks

transform absolute symlinks to relative

−o follow_symlinks

follow symlinks on the server

−o no_check_root

don’t check for existence of ’dir’ on server

−o password_stdin

read password from stdin (only for pam_mount!)

−o SSHOPT=VAL

ssh options (see man ssh_config)



FUSE options:

−d −o debug

enable debug output (implies −f )

−f foreground operation

−s disable multi−threaded operation

−o allow_other

allow access to other users

−o allow_root

allow access to root

−o nonempty

allow mounts over non−empty file/dir

−o default_permissions enable permission checking by kernel

−o fsname=NAME

set filesystem name

−o subtype=NAME

set filesystem type

−o large_read

issue large read requests (2.4 only)

−o max_read=N

set maximum size of read requests

−o hard_remove

immediate removal (don’t hide files)

−o use_ino

let filesystem set inode numbers

−o readdir_ino

try to fill in d_ino in readdir

−o direct_io

use direct I/O

−o kernel_cache

cache files in kernel

−o [no]auto_cache

enable caching based on modification times

−o umask=M

set file permissions (octal)

−o uid=N

set file owner

−o gid=N

set file group

−o entry_timeout=T

cache timeout for names (1.0s)

−o negative_timeout=T

cache timeout for deleted names (0.0s)

−o attr_timeout=T

cache timeout for attributes (1.0s)



−o ac_attr_timeout=T

auto cache timeout for attributes (attr_timeout)

−o intr allow requests to be interrupted

−o intr_signal=NUM

signal to send on interrupt (10)

−o modules=M1[:M2...]

names of modules to push onto filesystem stack

−o max_write=N

set maximum size of write requests

−o max_readahead=N

set maximum readahead

−o async_read

perform reads asynchronously (default)

−o sync_read

perform reads synchronously

Module options:

[subdir]

−o subdir=DIR

prepend this directory to all paths (mandatory)

−o [no]rellinksa

transform absolute symlinks to relative

[iconv]

−o from_code=CHARSET

original encoding of file names (default: UTF-8)

−o to_code=CHARSET

new encoding of the file names (default: ISO-8859-2)

AUTHORSSSHFS has been written by Miklos Szeredi <[email protected]>.

This man page was written by Bartosz Fenski <[email protected]> for the Debian GNU/Linux distribution

(but it may be used by others).


sshfs.pdf

Documents

Transcript of sshfs.pdf