convmvfs - utility that mirrors a whole filesystem tree from one
charset to another.
convmvfs mountpoint [ options ]
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.
show summary of 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
allow access to other users
allow access to root
allow mounts over non-empty file/dir
enable permission checking by kernel
set filesystem name
issue large read requests (2.4 only)
set maximum size of read requests
immediate removal (don’t hide files)
let filesystem set inode numbers
try to fill in d_ino in readdir
use direct I/O
cache files in kernel
set file permissions (octal)
uid=N set file owner
gid=N set file group
cache timeout for names (1.0s)
cache timeout for deleted names (0.0s)
cache timeout for attributes (1.0s)
which directory to convert
charset used in srcdir
charset used in mounted filesystem
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!
$ convmvfs /ftp/pub_gbk -o srcdir=/ftp/pub,icharset=utf8,ocharset=gbk
$ fusermount -u /ftp/pub_gbk
convmvfs was written by Z.C. Miao <firstname.lastname@example.org>.
This manual page was written by Stanislav Maslovski
<email@example.com>, for the Debian project (but may be
used by others).
October 3, 2007