[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.4, Thu Jan 25 19:55:30 2001 UTC (16 years, 8 months ago) by xfs
Branch: MAIN
CVS Tags: HEAD
Changes since 1.3: +27 -17 lines 

Man pages update.

<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.16.1  -->
<!-- CreationDate: Wed Jan 24 01:42:53 2001
 -->
<!-- Total number of pages: 1 -->
<!-- Page: 1 -->
<!-- left  margin: 220 -->
<!-- right margin: 750 -->
<a name="NAME"></a><h2>NAME</h2><p style="margin-left: 18%"><font size=3>xfs_bmap - print block mapping for an XFS file</font></p>
<a name="SYNOPSIS"></a><h2>SYNOPSIS</h2><p style="margin-left: 18%"><font size=3><B>xfs_bmap</B></font> <font size=3>[</font> <font size=3><B>-a</B></font> <font size=3>] [</font> <font size=3><B>-l</B></font> <font size=3>] [</font> <font size=3><B>-d</B></font> <font size=3>] [</font> <font size=3><B>-n</B></font> <font size=3><I>nnn</I></font> <font size=3>] file ...</font></p>
<a name="DESCRIPTION"></a><h2>DESCRIPTION</h2><p style="margin-left: 18%"><font size=3><I>xfs_bmap</I></font> <font size=3>prints the map of disk blocks used by files in an XFS filesystem. The map lists each</font> <font size=3><I>extent</I></font> <font size=3>used by the file, as well as regions in the file that do not have any corresponding blocks (</font><font size=3><I>hole</I></font><font size=3>s). Each line of the listings takes the following form:</font></p>
<p style="margin-left: 18%"><font size=3><I>extent: [startoffset..endoffset]: startblock..endblock</I></font></p>
<p style="margin-left: 18%"><font size=3>Holes are marked by replacing the</font> <font size=3><I>startblock..endblock</I></font> <font size=3>with</font> <font size=3><I>hole</I></font><font size=3>. All the file offsets and disk blocks are in units of 512&shy;byte blocks, no matter what the filesystem's block size is.</font></p>
<p style="margin-left: 18%"><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> <font size=3><B>&shy;d</B></font> <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.</font></p>
<p style="margin-left: 18%"><font size=3>If the</font> <font size=3><B>&shy;l</B></font> <font size=3>option is used, then</font></p>
<p style="margin-left: 18%"><font size=3><I>&lt;nblocks&gt; blocks</I></font></p>
<p style="margin-left: 18%"><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&shy;byte blocks.</I></font></p>
<p style="margin-left: 18%"><font size=3>If the</font> <font size=3><B>-a</B></font> <font size=3>option is given, information about the file's attribute fork is printed instead of the default data fork.</font></p>
<p style="margin-left: 18%"><font size=3>If the</font> <font size=3><B>-n</B></font> <font size=3><I>nnn</I></font> <font size=3>option is given,</font> <font size=3><B>xfs_bmap</B></font> <font size=3>obtains the extent list of the file in groups of</font> <font size=3><I>nnn</I></font> <font size=3>extents. In the absence of</font> <font size=3><B>-n</B></font><font size=3>,</font> <font size=3><B>xfs_bmap</B></font> <font size=3>queries the system for the number of extents in the file and uses that value to compute the group size.</font></p>
<a name="DIAGNOSTICS"></a><h2>DIAGNOSTICS</h2><p style="margin-left: 18%"><font size=3><I>fcntl(F_GETBMAPX) filename: Invalid argument</I></font>
<table width="99%" rules="none" frame="none" cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="27%">
</p>
</td>
<td valign="top" align="left" width="72%">
<p><font size=3>The file</font> <font size=3><I>filename</I></font> <font size=3>is not in an XFS filesystem.</font></p>
</td>
</tr>
</table>
</p>
<a name="SEE ALSO"></a><h2>SEE ALSO</h2><p style="margin-left: 18%"><font size=3>fcntl(2), lvm(8).</font><br>
</p>
</body>
</html>