Provided by: shfs-utils_0.35-5_i386
shfsmount - mount remote volumes using (secure) shell connection.
shfsmount [options] [[user@]hostname[:root]] mount_point
The shfsmount is a mount-support utility which makes possible to mount
remote volumes to the local file system tree through simple shell
connection. It uses ssh (or any other program) connection to remote
servers. It requires shfs.o kernel module to be loaded. If you set suid
bit on shfsmount you enable ANY USER to mount remote dirs. User must be
owner (or member of group) of mount_point and must have write access
for that directory.
execute command (ssh) as this user (root only)
command to connect to remote side (see below)
connect to this port
make connection persistent (broken connection is re-established)
connection server type (currently only "perl" and "shell" are
dereference symbolic links (if possible)
mount options (see below)
do not update /etc/mtab
print debug messages; more options increases verbosity; this
affects kernel module too
print version number
print usage information
user log in using this user name
specify remote host
root remote directory to become root of the new mounted tree
set read-ahead and write-back cache size in pages, page size is
4KB on i386, 0 = disable filecache (default is 32, i.e. 128KB)
set maximum number of files cached at once (default is 10)
preserve uid/gid (root only)
time to live (sec) of cached directory entries
owner of all files/dirs on mounted file system (root only)
group of all files/dirs on mounted file system (root only)
root dir mode (default is 700)
see mount(8) (root only).
ro, rw, nosuid, nodev, exec, noexec, user, users
cmd-user, cmd, port, persistent, type, stable
items (just like in mount(8)).
%u %h %P in COMMAND are substituted by user, host and port respectively.
Mount errors will be written through syslog(3). Stderr is redirected
to /dev/null unless -v option is given (may be useful if you cannot
connect to remote side). On success, 0 is returned.
Date of remote file/dir may not be shown correctly (+- 1 day).
"stable" symlinks option may not work on OSF1.
Please report bugs [with diff -u patches, of course ;-)] to
The simplest version (mount home dir of user at host):
shfsmount user@host /mnt/shfs
To specify remote directory:
shfsmount user@host:/tmp /mnt/shfs
To specify another port:
shfsmount -P 2222 user@host /mnt/shfs
To specify another ssh option:
shfsmount --cmd="ssh -c blowfish %u@%h /bin/bash"
To make mount survive temporary connection outage (reconnect mode):
shfsmount --persistent user@host /mnt/shfs
Longer transfers? Increase cache size (here 1MB cache per file
shfsmount user@host /mnt/shfs -o cachesize=256
To enable symlink resolution:
shfsmount -s user@host /mnt/shfs
To preserve uid (gid) (NFS replace mode :-)):
shfsmount root@host /mnt/shfs -o preserve,rmode=755
To see what is wrong (forces kernel debug output too):
shfsmount -vvv user@host /mnt/shfs
shfsumount(8), mount(8), ssh(1)
Zemljanka core team (Johanka, Dan, Qiq)
Miroslav Spousta <firstname.lastname@example.org>