savelij13
030f12c942
- Fixed assertion failure due to OS/2 EA on FAT12/16. - Changed f_open() and f_opendir() reject null object pointer to avoid crash. - Changed option name _FS_SHARE to _FS_LOCK.
87 lines
4.0 KiB
HTML
87 lines
4.0 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<meta http-equiv="Content-Style-Type" content="text/css">
|
|
<link rel="up" title="FatFs" href="../00index_e.html">
|
|
<link rel="alternate" hreflang="ja" title="Japanese" href="../ja/rc.html">
|
|
<link rel="stylesheet" href="../css_e.css" type="text/css" media="screen" title="ELM Default">
|
|
<title>FatFs - Return Codes</title>
|
|
</head>
|
|
|
|
<body>
|
|
<h1>Return Code of the File Functions</h1>
|
|
<p>On the FatFs API, most of file functions return common result code as enum type. When a function succeeded, it returns zero, otherwise returns non-zero value that indicates type of error.</p>
|
|
|
|
<dl class="ret">
|
|
<dt id="ok">FR_OK (0)</dt>
|
|
<dd>The function succeeded.</dd>
|
|
<dt id="de">FR_DISK_ERR</dt>
|
|
<dd>An unrecoverable error occured in the lower layer (disk I/O functions).</dd>
|
|
<dt id="ie">FR_INT_ERR</dt>
|
|
<dd>Assertion failed. An insanity is detected in the internal process. One of the following possibilities are suspected.
|
|
<ul>
|
|
<li>There is any error of the FAT structure on the volume.</li>
|
|
<li>Work area (file system object, file object or etc...) is broken by stack overflow or any other application. This is the reason in most case.</li>
|
|
<li>An <tt>FR_DISK_ERR</tt> has occured on the file object.</li>
|
|
</ul>
|
|
</dd>
|
|
<dt id="nr">FR_NOT_READY</dt>
|
|
<dd>The disk drive cannot work due to incorrect medium removal or disk_initialize function failed.</dd>
|
|
<dt id="nf">FR_NO_FILE</dt>
|
|
<dd>Could not find the file.</dd>
|
|
<dt id="np">FR_NO_PATH</dt>
|
|
<dd>Could not find the path.</dd>
|
|
<dt id="in">FR_INVALID_NAME</dt>
|
|
<dd>The given string is invalid as the <a href="filename.html">path name</a>.</dd>
|
|
<dt id="dn">FR_DENIED</dt>
|
|
<dd>The required access was denied due to one of the following reasons:
|
|
<ul>
|
|
<li>Write mode open against the file with read-only attribute.</li>
|
|
<li>Deleting the file or directory with read-only attribute.</li>
|
|
<li>Deleting the non-empty directory or current directory.</li>
|
|
<li>Reading the file opened without FA_READ flag.</li>
|
|
<li>Any modification to the file opened without FA_WRITE flag.</li>
|
|
<li>Could not create the file or directory due to the directory table is full.</li>
|
|
<li>Could not create the directory due to the volume is full.</li>
|
|
</ul>
|
|
</dd>
|
|
<dt id="ex">FR_EXIST</dt>
|
|
<dd>Any object that has the same name is already existing.</dd>
|
|
<dt id="io">FR_INVALID_OBJECT</dt>
|
|
<dd>The given file/directory object structure is invalid.</dd>
|
|
<dt id="wp">FR_WRITE_PROTECTED</dt>
|
|
<dd>Any write mode action against write-protected media.</dd>
|
|
<dt id="id">FR_INVALID_DRIVE</dt>
|
|
<dd>Invalid drive number is specified. (Related option: _VOLUMES)</dd>
|
|
<dt id="ne">FR_NOT_ENABLED</dt>
|
|
<dd>Work area for the logical drive has not been registered by f_mount function.</dd>
|
|
<dt id="ns">FR_NO_FILESYSTEM</dt>
|
|
<dd>There is no valid FAT volume on the drive.</dd>
|
|
<dt id="ma">FR_MKFS_ABORTED</dt>
|
|
<dd>The f_mkfs function aborted before start in format due to a reason as follows:
|
|
<ul>
|
|
<li>The disk size is too small.</li>
|
|
<li>Not allowable cluster size for this disk. This can occure when number of clusters gets near the 0xFF7 and 0xFFF7.</li>
|
|
</ul>
|
|
</dd>
|
|
<dt id="tm">FR_TIMEOUT</dt>
|
|
<dd>The function canceled due to a timeout of <a href="appnote.html#reentrant">thread-safe control</a>. (Related option: _TIMEOUT)</dd>
|
|
<dt id="lo">FR_LOCKED</dt>
|
|
<dd>The file access is rejected by <a href="appnote.html#dup">file sharing control</a>. (Related option: _FS_LOCK)</dd>
|
|
<dt id="nc">FR_NOT_ENOUGH_CORE</dt>
|
|
<dd>Not enough memory for the operation. There is one of the following reasons:
|
|
<ul>
|
|
<li>Could not allocate a memory for LFN working buffer. (Related option: _USE_LFN)</li>
|
|
<li>Given table size is insufficient for the required size.</li>
|
|
</ul>
|
|
</dd>
|
|
<dt id="tf">FR_TOO_MANY_OPEN_FILES</dt>
|
|
<dd>Number of open files has been reached maximum value and no more file can be opened. (Related option: _FS_LOCK)</dd>
|
|
<dt id="ip">FR_INVALID_PARAMETER</dt>
|
|
<dd>The given parameter is invalid or there is any inconsistent.</dd>
|
|
</dl>
|
|
|
|
</body>
|
|
</html>
|