Intro Download and install Frequently Asked Questions Tips and tricks

Homepage







© J.C. Kessels 2009

MakeGap

Set the position of the beginning of the next zone. This command is commonly used to create a gap between zones, but the command can also be used to position a zone anywhere on disk.

  • The NUMBER specifies the beginning of the next zone, an absolute position on the disk. Usually it will be the ZoneBegin plus a number of bytes, but you can specify a different formula.
  • The command will do nothing if the NUMBER is negative.
  • The program will automatically vacate the gap between the current end of the zone and the NUMBER. It will not vacate if the DoNotVacate option is specified, or if the NUMBER is lower than current beginning of the zone (negative gap).
  • If the NUMBER does not leave enough room for files that have not been placed yet then the program will automatically change the NUMBER so that just enough space remains on the volume. This can be used to move files to the very end of the volume, although it is better to use the MaxNextZoneBegin number.
  • If all the next zones are sorted zones (using one of the SortBy fileactions) then DoNotVacate can be used, it will save some unnecessary data movements.
  • The *  FastFill and *  MoveDownFill fileactions will only move files down, never up, so files that are in a DoNotVacate gap will be left in the gap.

Syntax

MakeGap(NUMBER [, DoNotVacate])

Example

# Make a gap of 1% of the free size of the volume.
MakeGap(ZoneBegin + VolumeFree * 0.01)

# Same, but do not vacate.
MakeGap(ZoneBegin + VolumeFree * 0.01 , DoNotVacate)

# Place next zone at the end of the disk, with some extra maneuvering space.
MakeGap(MaxNextZoneBegin - VolumeFree * 0.01)

See also:

*  AddGap
*  VolumeActions