[BACK]Return to xfs_bmap.html CVS log [TXT][DIR] Up to [Development] / xfs-website.orig / manpages
File: [Development] / xfs-website.orig / manpages / xfs_bmap.html (download) (as text)

Revision 1.3, Wed Sep 27 05:01:47 2000 UTC (17 years, 1 month ago) by xfs
Branch: MAIN
Changes since 1.2: +3 -3 lines 

Update manpages.
These changes from Martin Peterson.

<html>
<head>
<meta name="Content-Style" content="text/css">
</head>
<body>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<!-- Creator     : groff version 1.15  -->
<!-- CreationDate: Tue Sep 26 23:59:41 2000
 -->
<!-- Total number of pages: 1 -->
<!-- Page: 1 -->
<!-- left  margin: 100 -->
<!-- right margin: 750 -->
<a name="NAME"></a><h2>NAME</h2><p><font size=3>xfs_bmap - print block mapping for an XFS file</p>
<a name="SYNOPSIS"></a><h2>SYNOPSIS</h2><p><font size=3><B>xfs_bmap</B> <font size=3>[ <font size=3><B>-a</B> <font size=3>] [ <font size=3><B>-l</B> <font size=3>] [ <font size=3><B>-d</B> <font size=3>] [ <font size=3><B>-n</B> <font size=3><I>nnn</I> <font size=3>] file ...</p>
<a name="DESCRIPTION"></a><h2>DESCRIPTION</h2><p><font size=3><I>xfs_bmap</I> <font size=3>prints the map of disk blocks used by files in an XFS filesystem. The map lists each <font size=3><I>extent</I> <font size=3>used by the file, as well as regions in the file that do not have any corresponding blocks (<font size=3><I>hole</I><font size=3>s). Each line of the listings takes the following form:</p>
<p><font size=3><I>extent: [startoffset..endoffset]: startblock..endblock</p>
</I><p><font size=3>Holes are marked by replacing the <font size=3><I>startblock..endblock</I> <font size=3>with <font size=3><I>hole</I><font size=3>. All the file offsets and disk blocks are in units of 512-byte blocks, no matter what the filesystem's block size is.</p>
<p><font size=3>If portions of the file have been migrated offline by a DMAPI application, a DMAPI read event will be generated to bring those portions back online before the disk block map is printed. However if the <font size=3><B>-d</B> <font size=3>option is used, no DMAPI read event will be generated for a DMAPI file and offline portions will be reported as holes.</p>
<p><font size=3>If the <font size=3><B>-l</B> <font size=3>option is used, then</p>
<p><font size=3><I>&lt;nblocks&gt; blocks</p>
</I><p><font size=3><I>will be appended to each line. Nblocks is the length of the extent described on the line in units of 512-byte blocks.</p>
</I><p><font size=3>If the <font size=3><B>-a</B> <font size=3>option is given, information about the file's attribute fork is printed instead of the default data fork.</p>
<p><font size=3>If the <font size=3><B>-n</B> <font size=3><I>nnn</I> <font size=3>option is given, <font size=3><B>xfs_bmap</B> <font size=3>obtains the extent list of the file in groups of <font size=3><I>nnn</I> <font size=3>extents. In the absence of <font size=3><B>-n</B><font size=3>, <font size=3><B>xfs_bmap</B> <font size=3>queries the system for the number of extents in the file and uses that value to compute the group size.</p>
<a name="DIAGNOSTICS"></a><h2>DIAGNOSTICS</h2><p><font size=3><I>fcntl(F_GETBMAPX) filename: Invalid argument<br>
<span style=" text-indent: 0.6000in;"></span></I>The file <font size=3><I>filename</I> <font size=3>is not in an XFS filesystem.</p>
<a name="SEE ALSO"></a><h2>SEE ALSO</h2><p><font size=3>fcntl(2), lvm(8).<br>
</p>
</body>
</html>