DOKK / manpages / debian 10 / fuse-convmvfs / convmvfs.1.en
CONVMVFS(1) General Commands Manual CONVMVFS(1)

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.

-o opt[,opt...]
mount options
print help
print version
show summary of options

enable debug output (implies -f)
foreground operation
disable multi-threaded operation
Mount options are specified with a -o flag followed by a comma separated list of options. The following options are recognized:
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)
set file owner
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!

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

to unmount:
$ fusermount -u /ftp/pub_gbk

fusermount(1), mount(8)

convmvfs was written by Z.C. Miao <>.

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

October 3, 2007