xfs_reno(1M)xfs_reno(1M)NAMExfs_reno - renumber XFS inodes
SYNOPSIS
/usr/etc/xfs_reno [-fpqv] [-P interval] <path>
/usr/etc/xfs_reno [-r] <path>
DESCRIPTIONxfs_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.
Page 1
xfs_reno(1M)xfs_reno(1M)-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.
NOTESxfs_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 ALSOfsr(1M), xfs_ncheck(1M), fstab(4), xfs(4).
Page 2
