%general-entities; ]> $LastChangedBy$ $Date$ xfsprogs-&xfsprogs-version; XFS Introduction to xfsprogs The xfsprogs package contains administration and debugging tools for the XFS file system. &lfs72_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &xfsprogs-md5sum; Download size: &xfsprogs-size; Estimated disk space required: &xfsprogs-buildsize; Estimated build time: &xfsprogs-time; The XFS developers regularly remove the current package when a new package is available. Unfortunately, this has led to severe incompatibilities, including unmountable filesystems, due to kernel version requirements in new versions of the package. Using a version not in the book is strongly discouraged. Additional information, is available at the XFS project page. User Notes: Kernel Configuration Enable the following options in the kernel configuration and recompile the kernel: File Systems: XFS filesystem support: M or Y XFS Programs Installation of xfsprogs Install xfsprogs by running the following commands: make DEBUG=-DNDEBUG INSTALL_USER=root INSTALL_GROUP=root \ LOCAL_CONFIGURE_OPTIONS="--enable-readline=yes" This package does not come with a test suite. Now, as the root user: make install && make install-dev && chmod -v 755 /lib/libhandle.so.1.* Command Explanations make DEBUG=-DNDEBUG: Turns off debugging symbols. INSTALL_USER=root INSTALL_GROUP=root: This sets the owner and group of the installed files. LOCAL_CONFIGURE_OPTIONS="...": This passes extra configuration options to the configure script. The example --enable-readline=yes parameter enables linking the XFS programs with the libreadline.so library, in order to allow editing interactive commands. OPTIMIZER="...": Adding this parameter to the end of the make command overrides the default optimization settings. make install-dev: This command installs static XFS libraries, their headers and the corresponding documentation. Contents Installed Programs Installed Libraries Installed Directory fsck.xfs, mkfs.xfs, xfs_admin, xfs_bmap, xfs_check, xfs_copy, xfs_db, xfs_freeze, xfs_growfs, xfs_info, xfs_io, xfs_logprint, xfs_mdrestore, xfs_metadump, xfs_mkfile, xfs_ncheck, xfs_quota, xfs_repair, and xfs_rtcp libdisk.a, libhandle.{so,a}, libxcmd.a, libxfs.a, and libxlog.a /usr/share/doc/xfsprogs Short Descriptions fsck.xfs simply exits with a zero status, since XFS partitions are checked at mount time. fsck.xfs mkfs.xfs constructs an XFS file system. mkfs.xfs xfs_admin changes the parameters of an XFS file system. xfs_admin xfs_bmap prints block mapping for an XFS file. xfs_bmap xfs_check checks XFS file system consistency. xfs_check xfs_copy copies the contents of an XFS file system to one or more targets in parallel. xfs_copy xfs_db is used to debug an XFS file system. xfs_db xfs_freeze suspends access to an XFS file system. xfs_freeze xfs_growfs expands an XFS file system. xfs_growfs xfs_info is equivalent to invoking xfs_growfs, but specifying that no change to the file system is to be made. xfs_info xfs_io is a debugging tool like xfs_db, but is aimed at examining the regular file I/O path rather than the raw XFS volume itself. xfs_io xfs_logprint prints the log of an XFS file system. xfs_logprint xfs_mdrestore restores an XFS metadump image to a filesystem image. xfs_mdrestore xfs_metadump copies XFS filesystem metadata to a file. xfs_metadump xfs_mkfile creates an XFS file, padded with zeroes by default. xfs_mkfile xfs_ncheck generates pathnames from inode numbers for an XFS file system. xfs_ncheck xfs_quota is a utility for reporting and editing various aspects of filesystem quota. xfs_quota xfs_repair repairs corrupt or damaged XFS file systems. xfs_repair xfs_rtcp copies a file to the real-time partition on an XFS file system. xfs_rtcp libhandle.so contains XFS-specific functions that provide a way to perform certain filesystem operations without using a file descriptor to access filesystem objects. libhandle.so