SF.net Project Page
Section: Maintenance Commands (8)
Updated: 04 Aug 2006
build_xfs - build XFS filesystem proceeding from information
from external inode table file.
build_xfs [-b subopt=value ] [-d subopt[=value]]
[-i subopt=value] [-l subopt[=value]] [-f]
[-n subopt[=value]] [-q] [-r subopt[=value]]
[-s subopt[=value]] [-N] [-L label] inode_table devicename
proceeds from external inode table information for building
filesystems on device.
Filesystem building consist of several steps:
1) at first it remaps anyfs inodes to XFS inodes numbers.
So it choose location for information about inodes.
2) then in separate bits map marks all blocks in which will be kept
filesystem system information (including one about inodes).
3) it frees this blocks from user information.
WARNING. If device has small free space, at this stage possible not
shortage space for new filesystem, so not only old filesystem will be
destroyed, but new filesystem will not be built. Nevertheless changed
inode table will be saved if it's possible. But it will better to avoid
so situation by running utility with
option at first.
4) it writes information about filesystem inodes.
5) it builds B-trees of free blocks and inodes, and writes superblocks.
At 4-5 stages also may be errors, nevertheless after third stage
new inode table already saved and it should not to lead to irrevocable
utility based on
package version 2.7.11. The most options keeps its original meaning
and here will not be explained. Here describes only some important
options, new options and options with changing meaning.
- -b Block size options.
Filesystem blocksize given in inode table. Trying to point using this option
blocksize different with pointed in inode table leads to error message
and advice to use
for changing filesystem blocksize.
- -p protofile
This options and its functions was removes from the utility --
self external inode table is more powerful protofile analogue.
causes build_xfs to not actually build a filesystem, nevertheless
so you may to know if there are not enough space for locating new
filesystem on device.
Don't print any messages.
you may to point this option to 3 times, with each time more increase
quantity of output messages.
Print the version number and exit.
external inode table, from which it will read information about locating
user data files of current filesystem, its access permissions and
device for building new filesystem.
Check for enough free space on device:
$ build_xfs -N inode.table /dev/hda1
$ build_xfs inode.table /dev/hda1
Nikolaj Krivchenkov aka unDEFER <firstname.lastname@example.org>
Messages about any problem with using
package send to
You may append to problem description also the inode table
(compressed with gzip or bzip2 it must has not so more size)
and device/image size.
Block device size in 512 byte blocks you can get with command
`/sbin/blockdev --getsize <device>`
You can obtain the last version of package at
- USAGE EXAMPLES
- BUG REPORTS
- SEE ALSO
This document was created by
man2html (from man 1.5o1),
using the manual pages.
Time: 21:52:21 GMT, August 16, 2008