Documentation/NuttShell.html: Document the mkfatfs the -r option which can be used to specify the number of entries in the FAT12/FAT16 root directory.

This commit is contained in:
Gregory Nutt 2018-05-11 09:52:08 -06:00
parent f12f2c3828
commit f11dec3e20
1 changed files with 9 additions and 2 deletions

View File

@ -8,7 +8,7 @@
<tr align="center" bgcolor="#e4e4e4">
<td>
<h1><big><font color="#3c34ec"><i>NuttShell (NSH)</i></font></big></h1>
<p>Last Updated: January 12, 2018</p>
<p>Last Updated: May 11, 2018</p>
</td>
</tr>
</table>
@ -2311,7 +2311,7 @@ nsh&gt;
<p><b>Command Syntax:</b></p>
<ul><pre>
mkfatfs [-F &lt;fatsize&gt;] &lt;block-driver&gt;
mkfatfs [-F &lt;fatsize&gt;] [-r &lt;rootdirentries&gt;] &lt;block-driver&gt;
</pre></ul>
<p>
<b>Synopsis</b>.
@ -2320,6 +2320,13 @@ mkfatfs [-F &lt;fatsize&gt;] &lt;block-driver&gt;
Without the <code>&lt;fatsize&gt;</code> option, <code>mkfatfs</code> will select either the FAT12 or FAT16 format.
For historical reasons, if you want the FAT32 format, it must be explicitly specified on the command line.
</p>
<p>
The <code>-r</code> option may be specified to select the the number of entries in the root directory for FAT12 and FAT16 file systems.
Typical values for small volumes would be 112 or 224; 512 should be used for large volumes, such as hard disks or very large SD cards. The default is 512 entries in all cases.
</p>
<p>
The reported number of root directory entries used with FAT32 is zero because the FAT32 root directory is a cluster chain.
</p>
<p>
NSH provides this command to access the <a href="mkfatfs"><code>mkfatfs()</code></a> NuttX API.
This block device must reside in the NuttX <a href="NuttxUserGuide.html#FileSystemOverview"><i>pseudo</i> file system</a> and