Provided by: shfs-utils_0.35-5_i386 bug

NAME

       shfsmount - mount remote volumes using (secure) shell connection.

SYNOPSIS

       shfsmount [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
       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.

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 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
items (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).
       "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 (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 ALSO

       shfsumount(8), mount(8), ssh(1)

AUTHOR

       Zemljanka core team (Johanka, Dan, Qiq)
       Miroslav Spousta <qiq@ucw.cz>