From 2f1fa4f8ca020c5d96bd3ac8706c54cd881aaa03 Mon Sep 17 00:00:00 2001 From: Björn Jacke Date: Mon, 8 Mar 2010 12:38:38 +0100 Subject: s3: add man page for vfs_crossrename --- docs-xml/manpages-3/vfs_crossrename.8.xml | 115 ++++++++++++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 docs-xml/manpages-3/vfs_crossrename.8.xml diff --git a/docs-xml/manpages-3/vfs_crossrename.8.xml b/docs-xml/manpages-3/vfs_crossrename.8.xml new file mode 100644 index 0000000000..675c92e39d --- /dev/null +++ b/docs-xml/manpages-3/vfs_crossrename.8.xml @@ -0,0 +1,115 @@ + + + + + + vfs_crossrename + 8 + Samba + System Administration tools + 3.6 + + + + + vfs_crossrename + server side rename files across filesystem boundaries + + + + + vfs objects = crossrename + + + + + DESCRIPTION + + This VFS module is part of the + samba + 7 suite. + + The vfs_crossrename VFS module allows + server side rename operations even if source and target are on + differen physical devices. A "move" in Explorer is usually a + rename operation if it is inside of a single share or device. + Usually such a rename operation returns + NT_STATUS_NOT_SAME_DEVICE and the client has to move the file by + manual copy and delete operations. If the rename by copy is done by the + server this can be much more efficient. vfs_crossrename tries to do + this server-side cross-device rename operation. There are however + limitations that this module currently does not solve: + + + + the ACLs of files are not preserved + + + meta data in EAs are not preserved + + + renames of whole subdirectories cannot be done recursively, + in that case we still return STATUS_NOT_SAME_DEVICE and + let the client decide what to do + + + rename operations of huge files can cause hangs on the + client because clients expect a rename operation to + return fast + + + + + This module is stackable. + + + + + + OPTIONS + + + + + crossrename:sizelimit = BYTES + + server-side cross-device-renames are only done + for files if the filesize is not larger than the defined + size in MiB to prevent timeouts. The default sizelimit is + 20 (MiB) + + + + + + + EXAMPLES + + To add server-side cross-device renames inside of a share + for all files sized up to 50MB: + + + + /data/mounts + crossrename + 50 + + + + + VERSION + This man page is correct for version 3.6.0 of the Samba suite. + + + + + AUTHOR + + The original Samba software and related utilities + were created by Andrew Tridgell. Samba is now developed + by the Samba Team as an Open Source project similar + to the way the Linux kernel is developed. + + + + -- cgit