convmvfs

CONVMVFS(1)                 General Commands Manual                CONVMVFS(1)



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)