SHFSMOUNT(8) SHFS Manual SHFSMOUNT(8)NAMEshfsmount - mount remote volumes using (secure) shell connection.
SYNOPSISshfsmount [options] [[user@]hostname[:root]] mount_point
shfsmount [-hV]
DESCRIPTION
The shfsmount is a mount-support utility which makes possible to mount
remote volumes to the local file system tree through simple shell con‐
nection. 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.
OPTIONS-u, --cmd-user=user
execute command (ssh) as this user (root only)
-c, --cmd=COMMAND
command to connect to remote side (see below)
-P, --port=PORT
connect to this port
-p, --persistent
make connection persistent (broken connection is re-established)
-t, --type=TYPE
connection server type (currently only "perl" and "shell" are
supported)
-s, --stable
dereference symbolic links (if possible)
-o, --options
mount options (see below)
-v, --verbose
print debug messages; more options increases verbosity; this
affects kernel module too
-V, --version
print version number
-h, --help
print usage information
user log in using this user name
hostname
specify remote host
root remote directory to become root of the new mounted tree
MOUNT OPTIONS
cachesize=N
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)
cachemax=N
set maximum number of files cached at once (default is 10)
preserve
preserve uid/gid (root only)
ttl=TIME
time to live (sec) of cached directory entries
uid=USER
owner of all files/dirs on mounted file system (root only)
gid=GROUP
group of all files/dirs on mounted file system (root only)
rmode=mode
root dir mode (default is 700)
suid, dev
see mount(8) (root only).
ro, rw, nosuid, nodev, exec, noexec, user, users
see mount(8).
cmd-user, cmd, port, persistent, type, stable
see above
Options in mount_options list are separated by comma without spaces betweenitems (just like in mount(8)).
%u %h %P in COMMAND are substituted by user, host and port respectively.
ERRORS
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.
CONFORMING TO
Nothing.
BUGS
Date of remote file/dir may not be shown correctly (+- 1 day). "sta‐
ble" symlinks option may not work on OSF1.
Please report bugs [with diff -u patches, of course ;-)] to
<qiq@ucw.cz>
EXAMPLES
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"
user@host:/tmp /mnt/shfs/
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
(256*4KB)):
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
SEE ALSOshfsumount(8), mount(8), ssh(1)AUTHOR
Zemljanka core team (Johanka, Dan, Qiq)
Miroslav Spousta <qiq@ucw.cz>
shfsmount 2004 Mar 17 SHFSMOUNT(8)