en ru
SF.net Project Page Download Forums

build_e2fs

Section: Maintenance Commands (8)
Updated: 04 Aug 2006
Index
 

NAME

build_xfs - build XFS filesystem proceeding from information from external inode table file.  

SINOPSYS

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 
 

DESCRIPTION

build_xfs proceeds from external inode table information for building
XFS 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 -N 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 data loss.         
 

OPTIONS

build_xfs utility based on mkfs.xfs from xfsprogs 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 reblock(8) 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.
-N
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.
-q
Don't print any messages.
-v
you may to point this option to 3 times, with each time more increase quantity of output messages.
-V
Print the version number and exit.
inode_table
external inode table, from which it will read information about locating user data files of current filesystem, its access permissions and directory structure.
device
device for building new filesystem.

 

USAGE EXAMPLES

Check for enough free space on device:
$ build_xfs -N inode.table /dev/hda1

Build XFS:
$ build_xfs inode.table /dev/hda1

 

AUTHOR

Nikolaj Krivchenkov aka unDEFER <undefer@gmail.com>

 

BUG REPORTS

Messages about any problem with using anyfs-tools package send to undefer@gmail.com

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>`

 

AVAILABILITY

You can obtain the last version of package at http://anyfs-tools.sourceforge.net

 

SEE ALSO

anyfs-tools(8), anyfs_inode_table(5), build_e2fs(8), mkfs.xfs(8)


 

Index

NAME
SINOPSYS
DESCRIPTION
OPTIONS
USAGE EXAMPLES
AUTHOR
BUG REPORTS
AVAILABILITY
SEE ALSO

This document was created by man2html (from man 1.5o1), using the manual pages.
Time: 21:52:21 GMT, August 16, 2008
SourceForge.net Logo Valid HTML 4.0 Transitional