source: branches/samba-3.0/docs/manpages/vfs_prealloc.8@ 158

Last change on this file since 158 was 158, checked in by Paul Smedley, 17 years ago

Update source to 3.0.32

File size: 2.1 KB
Line 
1.\" Title: vfs_prealloc
2.\" Author:
3.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
4.\" Date: 08/25/2008
5.\" Manual: System Administration tools
6.\" Source: Samba 3.0
7.\"
8.TH "VFS_PREALLOC" "8" "08/25/2008" "Samba 3\.0" "System Administration tools"
9.\" disable hyphenation
10.nh
11.\" disable justification (adjust text to left margin only)
12.ad l
13.SH "NAME"
14vfs_prealloc - preallocate matching files to a predetermined size
15.SH "SYNOPSIS"
16.HP 1
17vfs objects = prealloc
18.SH "DESCRIPTION"
19.PP
20This VFS module is part of the
21\fBsamba\fR(7)
22suite\.
23.PP
24The
25vfs_prealloc
26VFS 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\.
27.PP
28This module is stackable\.
29.SH "OPTIONS"
30.PP
31prealloc:EXT = BYTES
32.RS 4
33Preallocate all files with the extension EXT to the size specified by BYTES\.
34.sp
35The following suffixes may be applied to BYTES:
36.sp
37.RS 4
38.ie n \{\
39\h'-04'\(bu\h'+03'\c
40.\}
41.el \{\
42.sp -1
43.IP \(bu 2.3
44.\}
45K
46\- BYTES is a number of kilobytes
47.RE
48.sp
49.RS 4
50.ie n \{\
51\h'-04'\(bu\h'+03'\c
52.\}
53.el \{\
54.sp -1
55.IP \(bu 2.3
56.\}
57M
58\- BYTES is a number of megabytes
59.RE
60.sp
61.RS 4
62.ie n \{\
63\h'-04'\(bu\h'+03'\c
64.\}
65.el \{\
66.sp -1
67.IP \(bu 2.3
68.\}
69G
70\- BYTES is a number of gigabytes
71.sp
72.RE
73.RE
74.SH "EXAMPLES"
75.PP
76A process writes TIFF files to a Samba share, and the is known these files will almost always be around 4 megabytes (4194304 bytes):
77.sp
78.RS 4
79.nf
80 \fI[frames]\fR
81 \fIpath = /data/frames\fR
82 \fIvfs objects = prealloc\fR
83 \fIprealloc:tiff = 4M\fR
84.fi
85.RE
86.SH "CAVEATS"
87.PP
88vfs_prealloc
89is not supported on all platforms and filesystems\. Currently only XFS filesystems on Linux and IRIX are supported\.
90.SH "VERSION"
91.PP
92This man page is correct for version 3\.0\.25 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.