comparison docs/nitros9guide/dcheck.refentry @ 975:c565a4700689

The entitity replstart was replaced with <replaceable>
author roug
date Sat, 01 Feb 2003 20:25:53 +0000
parents f9c66ad345d1
children b5ff125a1d60
comparison
equal deleted inserted replaced
974:febcdde1466a 975:c565a4700689
9 <command>DCHECK</command> 9 <command>DCHECK</command>
10 <arg choice="opt"> 10 <arg choice="opt">
11 <option>-opts</option> 11 <option>-opts</option>
12 </arg> 12 </arg>
13 <arg choice="plain"> 13 <arg choice="plain">
14 &replstart;devnam&replend; 14 <replaceable>devnam</replaceable>
15 </arg> 15 </arg>
16 </cmdsynopsis> 16 </cmdsynopsis>
17 </refsynopsisdiv> 17 </refsynopsisdiv>
18 18
19 <refsect1><title>Description</title> 19 <refsect1><title>Description</title>
36 any file descriptor sectors (FDs) describe a segment with a cluster 36 any file descriptor sectors (FDs) describe a segment with a cluster
37 not within the file structure of the disk, a message is reported 37 not within the file structure of the disk, a message is reported
38 like: 38 like:
39 </para> 39 </para>
40 <screen> 40 <screen>
41 *** Bad FD segment ($xxxxxx-$yyyyyy) for file: &replstart;pathlist&replend; 41 *** Bad FD segment ($xxxxxx-$yyyyyy) for file: <replaceable>pathlist</replaceable>
42 </screen> 42 </screen>
43 <para> 43 <para>
44 This indicates that a segment starting at sector xxxxxx and ending 44 This indicates that a segment starting at sector xxxxxx and ending
45 at sector yyyyyy cannot really be on this disk. Because there is a 45 at sector yyyyyy cannot really be on this disk. Because there is a
46 good chance the entire FD is bad if any of it's segment descriptors 46 good chance the entire FD is bad if any of it's segment descriptors
95 <tgroup cols="2"> 95 <tgroup cols="2">
96 <colspec colwidth="1.3in"/> 96 <colspec colwidth="1.3in"/>
97 <colspec colwidth="3in"/> 97 <colspec colwidth="3in"/>
98 <tbody> 98 <tbody>
99 <row> 99 <row>
100 <entry>-w=&replstart;path&replend;</entry> 100 <entry>-w=<replaceable>path</replaceable></entry>
101 <entry>pathlist to directory for work files</entry> 101 <entry>pathlist to directory for work files</entry>
102 </row> 102 </row>
103 <row> 103 <row>
104 <entry>-p</entry> 104 <entry>-p</entry>
105 <entry>print pathlists for questionable clusters</entry> 105 <entry>print pathlists for questionable clusters</entry>
139 the disk being DCHECKed if the disk's file structure integrity is in 139 the disk being DCHECKed if the disk's file structure integrity is in
140 doubt. 140 doubt.
141 </para> 141 </para>
142 <para> 142 <para>
143 DCHECK builds its disk allocation map in a file called 143 DCHECK builds its disk allocation map in a file called
144 &replstart;pathlist&replend;/DCHECKppO, where &replstart;pathlist&replend; 144 <replaceable>pathlist</replaceable>/DCHECKppO, where <replaceable>pathlist</replaceable>
145 is as specified by the 145 is as specified by the
146 &quot;-w=&quot; option and pp is the process number in hexadecimal. Each bit 146 &quot;-w=&quot; option and pp is the process number in hexadecimal. Each bit
147 in this bitmap file corresponds to a cluster of sectors on the disk. 147 in this bitmap file corresponds to a cluster of sectors on the disk.
148 If the &quot;-p&quot; option appears on the command line, DCHECK creates a 148 If the &quot;-p&quot; option appears on the command line, DCHECK creates a
149 second bitmap file (&replstart;pathlist&replend;/DCHECKpp1) that has a bit set for 149 second bitmap file (<replaceable>pathlist</replaceable>/DCHECKpp1) that has a bit set for
150 each cluster DCHECK finds as &quot;previously allocated&quot; or &quot;in file 150 each cluster DCHECK finds as &quot;previously allocated&quot; or &quot;in file
151 structure but not in allocation map&quot; while building the allocation 151 structure but not in allocation map&quot; while building the allocation
152 map. DCHECK them makes another pass through the directory structure 152 map. DCHECK them makes another pass through the directory structure
153 to determine the pathlists for these questionable clusters. These 153 to determine the pathlists for these questionable clusters. These
154 bitmap work files may be saved by specifying the &quot;-m&quot; option on the 154 bitmap work files may be saved by specifying the &quot;-m&quot; option on the