source: trunk-3.0/docs/manpages/vfs_prealloc.8@ 101

Last change on this file since 101 was 44, checked in by Paul Smedley, 18 years ago

Update source to 3.0.25b

File size: 1.9 KB
Line 
1.\"Generated by db2man.xsl. Don't modify this, modify the source.
2.de Sh \" Subsection
3.br
4.if t .Sp
5.ne 5
6.PP
7\fB\\$1\fR
8.PP
9..
10.de Sp \" Vertical space (when we can't use .PP)
11.if t .sp .5v
12.if n .sp
13..
14.de Ip \" List item
15.br
16.ie \\n(.$>=3 .ne \\$3
17.el .ne 3
18.IP "\\$1" \\$2
19..
20.TH "VFS_PREALLOC" 8 "" "" ""
21.SH "NAME"
22vfs_prealloc - preallocate matching files to a predetermined size
23.SH "SYNOPSIS"
24.HP 1
25vfs objects = prealloc
26.SH "DESCRIPTION"
27.PP
28This VFS module is part of the
29\fBsamba\fR(7)
30suite.
31.PP
32The
33vfs_prealloc
34VFS module preallocates files to a specified size each time a new file is created. This is useful in environments where files are of a predetermined size will be written to a disk subsystem where extending file allocations is expensive.
35.PP
36This module is stackable.
37.SH "OPTIONS"
38.PP
39prealloc:EXT = BYTES
40.RS 3n
41Preallocate all files with the extension EXT to the size specified by BYTES.
42.sp
43The following suffixes may be applied to BYTES:
44.RS 3n
45.TP 3n
46\(bu
47K
48- BYTES is a number of kilobytes
49.TP 3n
50\(bu
51M
52- BYTES is a number of megabytes
53.TP 3n
54\(bu
55G
56- BYTES is a number of gigabytes
57.RE
58.RE
59.SH "EXAMPLES"
60.PP
61A process writes TIFF files to a Samba share, and the is known these files will almost always be around 4 megabytes (4194304 bytes):
62
63.nf
64
65 \fI[frames]\fR
66 path = /data/frames
67 vfs objects = prealloc
68 prealloc:tiff = 4M
69
70.fi
71.SH "CAVEATS"
72.PP
73vfs_prealloc
74is not supported on all platforms and filesystems. Currently only XFS filesystems on Linux and IRIX are supported.
75.SH "VERSION"
76.PP
77This man page is correct for version 3.0.25 of the Samba suite.
78.SH "AUTHOR"
79.PP
80The 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.
81
Note: See TracBrowser for help on using the repository browser.