Home > Commands A-M > Commands F

FSUTIL SPARSE


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Manages sparse files. A sparse file is a file with one or more regions of unallocated data in it. A program will see these unallocated regions as containing bytes with the value zero, but there is actually no disk space used to represent these zeros. In other words, all meaningful or nonzero data is allocated, whereas all non-meaningful data (large strings of data composed of zeros) is not allocated. When a sparse file is read, allocated data is returned as stored and unallocated data is returned, by default, as zeros, in accordance with the C2 security requirement specification. Sparse file support allows data to be de-allocated from anywhere in the file.


Syntax

FSUTIL SPARSE help

FSUTIL SPARSE queryflag drive

FSUTIL SPARSE queryrange drive

FSUTIL SPARSE setflag drive

FSUTIL SPARSE setrange drive offset length


Parameters
drive (NTXP)
Specifies the drive letter (followed by a colon), mount point, or volume name.
(NT2003)
Specifies the full path to the file including the file name and extension.
help (NTXP)
Display help.
length (NTXP)
Length of the region in the file to be marked as sparse, in bytes.
offset (NTXP)
Offset within the file to mark as sparse.
queryflag (NTXP)
Queries sparse.
queryrange (NTXP)
Scans a file looking for ranges that may contain nonzero data.
setflag (NTXP)
Marks the indicated file as sparse.
setrange (NTXP)
Fills a specified range of a file with zeroes.

Switches

none.


Related

FSUTIL BEHAVIOR
FSUTIL DIRTY
FSUTIL FILE
FSUTIL FSINFO
FSUTIL HARDLINK
FSUTIL OBJECTID
FSUTIL QUOTA
FSUTIL REPARSEPOINT
FSUTIL USN
FSUTIL VOLUME


Notes

In a sparse file, large ranges of zeroes may not require disk allocation. Space for nonzero data will be allocated as needed as the file is written.

Only compressed or sparse files can have zeroed ranges known to the operating system.

If the file is sparse or compressed, NTFS may de-allocate disk space within the file. This sets the range of bytes to zeroes without extending the file size.


Examples

none.


Errorlevels

none.


Availability
External
DOS
none
Windows
none
Windows NT
NTXP NT2003