source: vendor/3.6.23/docs/manpages/vfs_crossrename.8

Last change on this file was 860, checked in by Silvan Scherrer, 11 years ago

Samba 3.6: updated vendor to latest version

File size: 3.3 KB
Line 
1'\" t
2.\" Title: vfs_crossrename
3.\" Author: [see the "AUTHOR" section]
4.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5.\" Date: 09/18/2013
6.\" Manual: System Administration tools
7.\" Source: Samba 3.6
8.\" Language: English
9.\"
10.TH "VFS_CROSSRENAME" "8" "09/18/2013" "Samba 3\&.6" "System Administration tools"
11.\" -----------------------------------------------------------------
12.\" * Define some portability stuff
13.\" -----------------------------------------------------------------
14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15.\" http://bugs.debian.org/507673
16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18.ie \n(.g .ds Aq \(aq
19.el .ds Aq '
20.\" -----------------------------------------------------------------
21.\" * set default formatting
22.\" -----------------------------------------------------------------
23.\" disable hyphenation
24.nh
25.\" disable justification (adjust text to left margin only)
26.ad l
27.\" -----------------------------------------------------------------
28.\" * MAIN CONTENT STARTS HERE *
29.\" -----------------------------------------------------------------
30.SH "NAME"
31vfs_crossrename \- server side rename files across filesystem boundaries
32.SH "SYNOPSIS"
33.HP \w'\ 'u
34vfs objects = crossrename
35.SH "DESCRIPTION"
36.PP
37This VFS module is part of the
38\fBsamba\fR(7)
39suite\&.
40.PP
41The
42vfs_crossrename
43VFS module allows server side rename operations even if source and target are on different 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\&.
44.PP
45There are however limitations that this module currently does not solve:
46.PP
47.RS 4
48.PP
49The ACLs of files are not preserved,
50.RE
51.PP
52.RS 4
53.PP
54meta data in EAs are not preserved,
55.RE
56.PP
57.RS 4
58.PP
59renames 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,
60.RE
61.PP
62.RS 4
63.PP
64rename operations of huge files can cause hangs on the client because clients expect a rename operation to return fast\&.
65.RE
66.PP
67This module is stackable\&.
68.SH "OPTIONS"
69.PP
70crossrename:sizelimit = BYTES
71.RS 4
72server\-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)
73.RE
74.SH "EXAMPLES"
75.PP
76To add server\-side cross\-device renames inside of a share for all files sized up to 50MB:
77.sp
78.if n \{\
79.RS 4
80.\}
81.nf
82 \fI[testshare]\fR
83 \m[blue]\fBpath = /data/mounts\fR\m[]
84 \m[blue]\fBvfs objects = crossrename\fR\m[]
85 \m[blue]\fBcrossrename:sizelimit = 50\fR\m[]
86.fi
87.if n \{\
88.RE
89.\}
90.SH "VERSION"
91.PP
92This man page is correct for version 3\&.6\&.0 of the Samba suite\&.
93.SH "AUTHOR"
94.PP
95The 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\&.
Note: See TracBrowser for help on using the repository browser.