.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "VFS_PREALLOC" 8 "" "" ""
.SH NAME
vfs_prealloc \- preallocate matching files to a predetermined size
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 23
\fBvfs objects = prealloc\fR
.ad
.hy

.SH "DESCRIPTION"

.PP
This VFS module is part of the\fBsamba\fR(7) suite\&.

.PP
The \fBvfs_prealloc\fR VFS 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\&.

.PP
This module is stackable\&.

.SH "OPTIONS"

.TP
prealloc:EXT = BYTES
Preallocate all files with the extension EXT to the size specified by BYTES\&.

The following suffixes may be applied to BYTES:

.RS
.TP 3
\(bu
\fBK\fR \- BYTES is a number of kilobytes
.TP
\(bu
\fBM\fR \- BYTES is a number of megabytes
.TP
\(bu
\fBG\fR \- BYTES is a number of gigabytes
.LP
.RE
.IP

.SH "EXAMPLES"

.PP
A process writes TIFF files to a Samba share, and the is known these files will almost always be around 4 megabytes (4194304 bytes):

.nf

        \fI[frames]\fR
	path = /data/frames
	vfs objects = prealloc
	prealloc:tiff = 4M

.fi

.SH "CAVEATS"

.PP
\fBvfs_prealloc\fR is not supported on all platforms and filesystems\&. Currently only XFS filesystems on Linux and IRIX are supported\&.

.SH "VERSION"

.PP
This man page is correct for version 3\&.0\&.25 of the Samba suite\&.

.SH "AUTHOR"

.PP
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\&.