huschi.net

xfs_spaceman(8)             System Manager's Manual            xfs_spaceman(8)
NAME
       xfs_spaceman - show free space information about an XFS filesystem
SYNOPSIS
       xfs_spaceman [ -c cmd ] file
       xfs_spaceman -V
DESCRIPTION
       xfs_spaceman  reports  and controls free space usage in an XFS filesys-
       tem.
OPTIONS
       -c cmd    xfs_spaceman commands may be run interactively (the  default)
                 or  as  arguments  on the command line. Multiple -c arguments
                 may be given. The commands are run  in  the  sequence  given,
                 then the program exits.
COMMANDS
       freesp [ -dgrs ] [-a agno]... [ -b | -e bsize | -h bsize | -m factor ]
              With  no  arguments,  freesp shows a histogram of all free space
              extents in the filesystem.   The  command  takes  the  following
              options:
                 -a agno
                     Collect  free  space  information  from  this  allocation
                     group.  This option can be specified  multiple  times  to
                     collect from multiple groups.
                 -b  This  argument  establishes  that the histogram bin sizes
                     are successive powers of two.  This is the  default,  and
                     is mutually exclusive with the -e, -h, and -m options.
                 -d  Print  debugging  information  such as the raw free space
                     extent information.
                 -g  Print the free space block and extent counts for each AG.
                 -e bsize
                     Set all histogram bin sizes to a  specific  value.   This
                     option  is  mutually  exclusive  with  the -b, -h, and -m
                     options.
                 -h bsize
                     Create a histogram bin with a lower bound of this  value.
                     The  upper  bound  of  this bin will be one less than the
                     lower bound of the  next  highest  histogram  bin.   This
                     option  can  be given multiple times to control the exact
                     bin sizes.  This option is mutually  exclusive  with  the
                     -b, -e, and -m options.
                 -m factor
                     Create  each  histogram bin with a size that is this many
                     times the size of the prvious bin created.   This  option
                     is mutually exclusive with the -b, -e, and -h options.
                 -r  Query the realtime device for free space information.
                 -s  Display a summary of the free space information found.
       info   Displays  selected  geometry  information  about the filesystem.
              The opened file must be a mount point of a XFS filesystem.   The
              output  will  have  the same format that xfs_info(8) prints when
              querying a filesystem.
       help [ command ]
              Display a brief description of one or all commands.
       prealloc [ -u id ] [ -g id ] [ -p id ] [ -m minlen ] [ -s ]
              Removes speculative preallocation.  If no -u, -g, or -p  options
              are  given,  this  command acts on all files.  The command takes
              the following options:
                 -u uid
                     Clear all speculative preallocations for files with  this
                     user  id.   This  option can be given in combination with
                     the -g  and  -p options.
                 -g gid
                     Clear all speculative preallocations for files with  this
                     group  id.   This option can be given in combination with
                     the -u  and  -p options.
                 -p pid
                     Clear all speculative preallocations for files with  this
                     project id.  This option can be given in combination with
                     the -u  and  -g options.
                 -m minlen
                     Ignore all files smaller than this size.   Units  can  be
                     supplied for this argument.
                 -s  Wait for removal to complete.
       print  Display a list of all open files.
       quit   Exit xfs_spaceman.
       trim ( -a agno | -f | offset length ) [ -m minlen ]
              Instructs  the  underlying storage device to release all storage
              that may be backing free space in the filesystem.   The  command
              takes  the  following  options:  (One  of  -a,  -f,  or the off-
              set/length pair are required.)
                 -a agno
                     Trim free space extents in the  given  allocation  group.
                     This  option is mutually exclusive with the -f option and
                     the offset/length options.
                 -f  Trim all free space in the filesystem.   This  option  is
                     mutually  exclusive  with  the  -a  option  and  the off-
                     set/length options.
                 option, length
                     Trim all free space within the physical range defined  by
                     the offset and length from this filesystem.  Units can be
                     appended to these arguments.   This  option  is  mutually
                     exclusive with the -a and -f options.
                 -m minlen
                     Do  not trim free space extents shorter than this length.
                     Units can be appended to this argument.
                                                               xfs_spaceman(8)