NAME

       convmvfs - utility that mirrors a whole filesystem tree from one charset to another.

SYNOPSIS

       convmvfs mountpoint [ options ]

DESCRIPTION

       This manual page documents briefly the convmvfs command.

       convmvfs  is  a  FUSE  (File  System  in  Userspace)  utility that transparently mirrors a
       filesystem tree converting the filenames from one charset to another on the fly. Only  the
       names  of  files  and  directories  are  converted,  the  file content remains intact. The
       mirrored tree is mounted at the given mountpoint.

OPTIONS

   General options
       -o opt[,opt...]
              mount options

       -h, --help
              print help

       -V, --version
              print version

       -h, --help
              show summary of options

   FUSE options
       -d, -o debug
              enable debug output (implies -f)

       -f     foreground operation

       -s     disable multi-threaded operation

       -o     Mount options are specified with a -o flag followed by a comma  separated  list  of
              options.  The following options are recognized:

              allow_other
                     allow access to other users

              allow_root
                     allow access to root

              nonempty
                     allow mounts over non-empty file/dir

              default_permissions
                     enable permission checking by kernel

              fsname=NAME
                     set filesystem name

              large_read
                     issue large read requests (2.4 only)

              max_read=N
                     set maximum size of read requests

              hard_remove
                     immediate removal (don't hide files)

              use_ino
                     let filesystem set inode numbers

              readdir_ino
                     try to fill in d_ino in readdir

              direct_io
                     use direct I/O

              kernel_cache
                     cache files in kernel

              umask=M
                     set file permissions (octal)

              uid=N  set file owner

              gid=N  set file group

              entry_timeout=T
                     cache timeout for names (1.0s)

              negative_timeout=T
                     cache timeout for deleted names (0.0s)

              attr_timeout=T
                     cache timeout for attributes (1.0s)

              srcdir=PATH
                     which directory to convert

              icharset=CHARSET
                     charset used in srcdir

              ocharset=CHARSET
                     charset used in mounted filesystem

NOTES

       If  you use a normal user account to mount the file system be sure to have r/w permissions
       to /dev/fuse.

       Use iconv --list to see which charsets are supported.

       To allow other users to access the mount point use allow_other option.

       IMPORTANT: if the mount point and srcdir point at the same directory,  readdir  call  will
       enter a dead loop.  BE SURE TO AVOID THIS SITUATION!

SAMPLE USE

       to mount:
       $ convmvfs /ftp/pub_gbk -o srcdir=/ftp/pub,icharset=utf8,ocharset=gbk

       to unmount:
       $ fusermount -u /ftp/pub_gbk

SEE ALSO

       fusermount(1), mount(8)

AUTHOR

       convmvfs was written by Z.C. Miao <hellwolf.misty@gmail.com>.

       This  manual  page was written by Stanislav Maslovski <stanislav.maslovski@gmail.com>, for
       the Debian project (but may be used by others).

                                         October 3, 2007                              CONVMVFS(1)