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)