fstrim man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

FSTRIM(8)		     System Administration		     FSTRIM(8)

NAME
       fstrim - discard unused blocks on a mounted filesystem

SYNOPSIS
       fstrim [-o offset] [-l length] [-m minimum-free-extent] [-v] mountpoint

DESCRIPTION
       fstrim  is  used	 on a mounted filesystem to discard (or "trim") blocks
       which are not in use by the filesystem.	This is useful for solid-state
       drives (SSDs) and thinly-provisioned storage.

       By  default,  fstrim  will discard all unused blocks in the filesystem.
       Options may be used to modify this behavior based on range or size,  as
       explained below.

       The  mountpoint	argument  is  the  pathname of the directory where the
       filesystem is mounted.

OPTIONS
       The offset, length, and minimum-free-extent arguments may  be  followed
       by  binary  (2^N) suffixes KiB, MiB, GiB, TiB, PiB and EiB (the "iB" is
       optional, e.g. "K" has the same meaning as  "KiB")  or  decimal	(10^N)
       suffixes KB, MB, GB, PB and EB.

       -h, --help
	      Print help and exit.

       -o, --offset offset
	      Byte offset in filesystem from which to begin searching for free
	      blocks to discard.  Default  value  is  zero,  starting  at  the
	      beginning of the filesystem.

       -l, --length length
	      Number  of  bytes after starting point to search for free blocks
	      to discard.  If the specified value extends past the end of  the
	      filesystem,  fstrim  will	 stop at the filesystem size boundary.
	      Default value extends to the end of the filesystem.

       -m, --minimum minimum-free-extent
	      Minimum contiguous free range to discard, in bytes. (This	 value
	      is  internally  rounded up to a multiple of the filesystem block
	      size).  Free ranges smaller  than	 this  will  be	 ignored.   By
	      increasing  this	value, the fstrim operation will complete more
	      quickly  for  filesystems	 with  badly   fragmented   freespace,
	      although	not  all  blocks  will be discarded.  Default value is
	      zero, discard every free block.

       -v, --verbose
	      Verbose execution. When specified fstrim will output the	number
	      of  bytes passed from the filesystem down the block stack to the
	      device for potential discard. This number is a  maximum  discard
	      amount  from  the	 storage  device's perspective, because FITRIM
	      ioctl called repeated will keep sending  the  same  sectors  for
	      discard repeatedly.

	      fstrim  will  report the same potential discard bytes each time,
	      but only sectors which had been written to between the  discards
	      would actually be discarded by the storage device.  Further, the
	      kernel block layer reserves the  right  to  adjust  the  discard
	      ranges  to fit raid stripe geometry, non-trim capable devices in
	      a LVM setup, etc.	 These reductions would not  be	 reflected  in
	      fstrim_range.len (the --length option).

AUTHOR
       Lukas Czerner <lczerner@redhat.com>
       Karel Zak <kzak@redhat.com>

SEE ALSO
       mount(8)

AVAILABILITY
       The  fstrim  command is part of the util-linux package and is available
       from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.

util-linux			 November 2010			     FSTRIM(8)
[top]

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net