Provided by: xfsprogs_5.3.0-1ubuntu2_amd64 bug

NAME

       xfs_fsr - filesystem reorganizer for XFS

SYNOPSIS

       xfs_fsr [-vdg] [-t seconds] [-p passes] [-f leftoff] [-m mtab]
       xfs_fsr [-vdg] [xfsdev | file] ...
       xfs_fsr -V

DESCRIPTION

       xfs_fsr is applicable only to XFS filesystems.

       xfs_fsr  improves  the  organization of mounted filesystems.  The reorganization algorithm
       operates on one file at a time, compacting or otherwise improving the layout of  the  file
       extents (contiguous blocks of file data).

       The following options are accepted by xfs_fsr.  The -m, -t, and -f options have no meaning
       if any filesystems or files are specified on the command line.

       -m mtab      Use this file for the list of filesystems to reorganize.  The default  is  to
                    use /etc/mtab.

       -t seconds   How long to reorganize.  The default is 7200 seconds (2 hours).

       -p passes    Number of passes before terminating global re-org.  The default is 10 passes.

       -f leftoff   Use  this  file  instead  of  /var/tmp/.fsrlast to read the state of where to
                    start and as the file to store the state of where reorganization left off.

       -v           Verbose.  Print cryptic information about each file being reorganized.

       -d           Debug.  Print even more cryptic information.

       -g           Print to syslog (default if stdout not a tty).

       -V           Prints the version number and exits.

       When invoked with no arguments xfs_fsr  reorganizes  all  regular  files  in  all  mounted
       filesystems.  xfs_fsr makes many cycles over /etc/mtab each time making a single pass over
       each XFS filesystem.  Each pass goes through and  selects  files  that  have  the  largest
       number of extents.  It attempts to defragment the top 10% of these files on each pass.

       It runs for up to two hours after which it records the filesystem where it left off, so it
       can  start  there  the  next   time.    This   information   is   stored   in   the   file
       /var/tmp/.fsrlast_xfs.   If  the  information found here is somehow inconsistent or out of
       date it is ignored and reorganization starts at the  beginning  of  the  first  filesystem
       found in /etc/mtab.

       xfs_fsr  can  be called with one or more arguments naming filesystems (block device name),
       and  files  to  reorganize.    In   this   mode   xfs_fsr   does   not   read   or   write
       /var/tmp/.fsrlast_xfs  nor  does  it  run  for  a  fixed time interval.  It makes one pass
       through each specified regular file and all regular files in each specified filesystem.  A
       command  line name referring to a symbolic link (except to a file system device), FIFO, or
       UNIX domain  socket  generates  a  warning  message,  but  is  otherwise  ignored.   While
       traversing the filesystem these types of files are silently skipped.

FILES

       /etc/mtab            contains default list of filesystems to reorganize.
       /var/tmp/.fsrlast_xfs
                            records the state where reorganization left off.

SEE ALSO

       xfs_fsr(8), mkfs.xfs(8), xfs_ncheck(8), xfs(5).

NOTES

       xfs_fsr  improves  the  layout  of  extents  for each file by copying the entire file to a
       temporary location and then interchanging the data extents of  the  target  and  temporary
       files  in an atomic manner.  This method requires that enough free disk space be available
       to copy any given file and that the space be less fragmented than the original  file.   It
       also  requires  the  owner  of the file to have enough remaining filespace quota to do the
       copy on systems running quotas.  xfs_fsr generates a  warning  message  if  space  is  not
       sufficient to improve the target file.

       A temporary file used in improving a file given on the command line is created in the same
       parent directory of the target file and is prefixed by the string '.fsr'.   The  temporary
       files  used in improving an entire XFS device are stored in a directory at the root of the
       target device and use the same naming scheme.   The  temporary  files  are  unlinked  upon
       creation so data will not be readable by any other process.

       xfs_fsr  does  not  operate  on  files that are currently mapped in memory.  A 'file busy'
       error can be seen for these files if the verbose flag (-v) is set.

       Files marked as no-defrag will be  skipped.  The  xfs_io(8)  chattr  command  with  the  f
       attribute  can  be  used  to  set  or  clear this flag. Files and directories created in a
       directory with the no-defrag flag will inherit the attribute.

       An entry in /etc/mtab or the file specified using the -m option must have  the  rw  option
       specified  for  read  and write access.  If this option is not present, then xfs_fsr skips
       the filesystem described by that line.  See the fstab(5) reference page for more details.

       In general we do not foresee the need to run xfs_fsr on system partitions such as /, /boot
       and  /usr  as  in general these will not suffer from fragmentation.  There are also issues
       with defragmenting files lilo(8) uses to boot your system. It is  recommended  that  these
       files should be flagged as no-defrag with the xfs_io(8) chattr command. Should these files
       be moved by xfs_fsr then you must rerun  lilo  before  you  reboot  or  you  may  have  an
       unbootable system.

                                                                                       xfs_fsr(8)