shfsmount(8)
NAME
- shfsmount - mount remote volumes using (secure) shell con
- nection.
SYNOPSIS
shfsmount [options] [[user@]hostname[:root]] mount_point shfsmount [-hV]
DESCRIPTION
- The shfsmount is a mount-support utility which makes pos
- sible to mount remote volumes to the local file system tree
- through simple shell connection. It uses ssh (or any other pro
- gram) 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 direc
- tory.
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)
- -n, --nomtab
- do not update /etc/mtab
- -v, --verbose
- print debug messages; more options increases ver
- bosity; 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 between items (just like in mount(8)).
- %u %h %P in COMMAND are substituted by user, host and port re
- spectively.
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 re
- turned.
CONFORMING TO
Nothing.
BUGS
- 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 <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 (recon
- nect 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 pre- serve,rmode=755
- To see what is wrong (forces kernel debug output too):
shfsmount -vvv user@host /mnt/shfs
SEE ALSO
shfsumount(8), mount(8), ssh(1)
AUTHOR
- Zemljanka core team (Johanka, Dan, Qiq)
Miroslav Spousta <qiq@ucw.cz> - shfsmount 2004 Mar 17