xfs_reno(1M)

NAME
     xfs_reno - renumber XFS inodes

SYNOPSIS
     /usr/etc/xfs_reno [-fpqv] [-P interval] <path>
     /usr/etc/xfs_reno [-r] <path>

DESCRIPTION
     xfs_reno is applicable only to XFS filesystems.

     xfs_reno renumbers inodes.  XFS supports 64bit inode numbers, although by
     default it will avoid creating inodes with numbers greater than what can
     be contained within a 32bit number.  If a filesystem does contain inode
     numbers greater than 32bits, then this can conflict with applications
     that do not support them, such as Legato Networker.  To recover from this
     situation previously, affected files would need to be copied (and so get
     a new inode number) and the old version removed.  This can be time
     consuming and impractical for very large files and filesystems.  xfs_reno
     can be used to renumber such inodes quickly.  xfs_reno will copy the
     inodes of affected files and move the data from the old inode to the new
     without having to copy the data.  xfs_reno relies on XFS in the kernel to
     allocate a new inode number, so if the filesystem has been mounted with
     the inode64 mount option, the new inodes will quite possibly have inode
     numbers greater than 32bits.

     xfs_reno should only be used on a filesystem where it is necessary to
     renumber inodes.  Use of xfs_reno on a regular basis is not recommended.
     Apart from application compatibility, there is no particular advantage to
     be had from renumbering inodes.

     xfs_reno works by traversing a directory tree, scanning all the
     directories and noting which files require renumbering.  Once the
     scanning phase is done, it will process the appropriate files and
     directories. The directory's absolute pathname must be given to xfs_reno.
     The following options are accepted by xfs_reno.

     -f   Force conversion on all inodes, rather than just those with a 64bit
          inode number.  This is not particularly useful except for debugging
          purposes.

     -v   Increases the verbosity of progress and error messages.  Additional
          -v's can be used to further increase verbosity.

     -q   Do not report progress, only errors.

     -p   Show progress status.

     -P seconds
          Set the interval for the progress status in seconds.  The default is
          1 second.
     -r   Recover from an interrupted run.  If xfs_reno is interrupted, it
          will leave a file called xfs_reno.recover in the directory specified
          on the command line.  This file will contain enough information so
          that xfs_reno can either finish processing the file it was working
          on when interrupted or back out the last change it made, depending
          on how far through the process it had progressed.  xfs_reno will
          only recover the single file it was working on so it will need to be
          run again on the directory to be sure that all the appropriate
          inodes have been converted.

NOTES
     xfs_reno may not be run on a CXFS client.

EXAMPLES
     To renumber inodes with 64bit inode numbers:

          # xfs_reno -p /path/to/directory

     To recover from an interrupted run:

          # xfs_reno -r /path/to/directory/xfs_reno.recover


FILES
     /path/xfs_reno.recover
          records the state where renumbering was interrupted

SEE ALSO
     fsr(1M), xfs_ncheck(1M), fstab(4), xfs(4).