<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"><title>sd-reader: FAT16 file functions</title><link href="doxygen.css" rel="stylesheet" type="text/css"><link href="tabs.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.5.3-20071008 --><div class="tabs"><ul><li><a href="index.html"><span>Main Page</span></a></li><li><a href="modules.html"><span>Modules</span></a></li><li><a href="annotated.html"><span>Data Structures</span></a></li><li><a href="files.html"><span>Files</span></a></li></ul></div><h1>FAT16 file functions<br><small>[<a class="el" href="group__fat16.html">FAT16 support</a>]</small></h1><hr><a name="_details"></a><h2>Detailed Description</h2>Functions for managing files.<p><p><table border="0" cellpadding="0" cellspacing="0"><tr><td></td></tr><tr><td colspan="2"><br><h2>Data Structures</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Describes a directory entry. <a href="structfat16__dir__entry__struct.html#_details">More...</a><br></td></tr><tr><td colspan="2"><br><h2>Defines</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g1c4ea0b6e1087b1a88d26b8942c5d923">FAT16_ATTRIB_READONLY</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The file is read-only. <a href="#g1c4ea0b6e1087b1a88d26b8942c5d923"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g229780f6a88ab775ea82264c9f1e0616">FAT16_ATTRIB_HIDDEN</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The file is hidden. <a href="#g229780f6a88ab775ea82264c9f1e0616"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#ga0badbbc92da7601b4a51d99ba7e8f8f">FAT16_ATTRIB_SYSTEM</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The file is a system file. <a href="#ga0badbbc92da7601b4a51d99ba7e8f8f"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#gc1341eb7b40d2f48cacf9b9d8aedbb6c">FAT16_ATTRIB_VOLUME</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The file is empty and has the volume label as its name. <a href="#gc1341eb7b40d2f48cacf9b9d8aedbb6c"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#gafdb0e859960ff33b11b6c55b3188274">FAT16_ATTRIB_DIR</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The file is a directory. <a href="#gafdb0e859960ff33b11b6c55b3188274"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g8e472239ee6baede688a01eaa45551a9">FAT16_ATTRIB_ARCHIVE</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The file has to be archived. <a href="#g8e472239ee6baede688a01eaa45551a9"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#gb90aeb34840c0ea33c8ae9d7577def65">FAT16_SEEK_SET</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The given offset is relative to the beginning of the file. <a href="#gb90aeb34840c0ea33c8ae9d7577def65"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g432820c6f8c90e11a92efc931c3b8a3a">FAT16_SEEK_CUR</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The given offset is relative to the current read/write position. <a href="#g432820c6f8c90e11a92efc931c3b8a3a"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g3793e580ccfcd5e68b95a0740c000e39">FAT16_SEEK_END</a></td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">The given offset is relative to the end of the file. <a href="#g3793e580ccfcd5e68b95a0740c000e39"></a><br></td></tr><tr><td colspan="2"><br><h2>Functions</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g0045fe378de2f7c52b528f985e1891a6">fat16_get_dir_entry_of_path</a> (struct fat16_fs_struct *fs, const char *path, struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> *dir_entry)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the directory entry of a path. <a href="#g0045fe378de2f7c52b528f985e1891a6"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">struct fat16_file_struct * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g3a43c9943251749978645ad8e3f16757">fat16_open_file</a> (struct fat16_fs_struct *fs, const struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> *dir_entry)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Opens a file on a FAT16 filesystem. <a href="#g3a43c9943251749978645ad8e3f16757"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g2b2812041f489bc7913bfa5cbcf0172b">fat16_close_file</a> (struct fat16_file_struct *fd)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Closes a file. <a href="#g2b2812041f489bc7913bfa5cbcf0172b"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">int16_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g0af2ef3d690626a5640a334cefbb27a6">fat16_read_file</a> (struct fat16_file_struct *fd, uint8_t *buffer, uint16_t buffer_len)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Reads data from a file. <a href="#g0af2ef3d690626a5640a334cefbb27a6"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">int16_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g4f0c785a47b1cf070839b5edec2c6f65">fat16_write_file</a> (struct fat16_file_struct *fd, const uint8_t *buffer, uint16_t buffer_len)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Writes data to a file. <a href="#g4f0c785a47b1cf070839b5edec2c6f65"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#gf1511fd1a5419d0828265566dc5d33e4">fat16_seek_file</a> (struct fat16_file_struct *fd, int32_t *offset, uint8_t whence)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Repositions the read/write file offset. <a href="#gf1511fd1a5419d0828265566dc5d33e4"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g23740742fa60ca148ef098caac7085c0">fat16_resize_file</a> (struct fat16_file_struct *fd, uint32_t size)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Resizes a file to have a specific size. <a href="#g23740742fa60ca148ef098caac7085c0"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#gf8029e3ec633902d08e8204d13afc350">fat16_create_file</a> (struct fat16_dir_struct *parent, const char *file, struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> *dir_entry)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a file. <a href="#gf8029e3ec633902d08e8204d13afc350"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#ge060faccbbeca802afe86be2f4d5b485">fat16_delete_file</a> (struct fat16_fs_struct *fs, struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> *dir_entry)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Deletes a file or directory. <a href="#ge060faccbbeca802afe86be2f4d5b485"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g82c7347c5b3cd8832633d5303552eb38">fat16_get_file_modification_date</a> (const struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> *dir_entry, uint16_t *year, uint8_t *month, uint8_t *day)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the modification date of a file. <a href="#g82c7347c5b3cd8832633d5303552eb38"></a><br></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__fat16__file.html#g5040fcab753ef55337292daf8c0d6784">fat16_get_file_modification_time</a> (const struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> *dir_entry, uint8_t *hour, uint8_t *min, uint8_t *sec)</td></tr><tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the modification time of a file. <a href="#g5040fcab753ef55337292daf8c0d6784"></a><br></td></tr></table><hr><h2>Define Documentation</h2><a class="anchor" name="g8e472239ee6baede688a01eaa45551a9"></a><!-- doxytag: member="fat16.h::FAT16_ATTRIB_ARCHIVE" ref="g8e472239ee6baede688a01eaa45551a9" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_ATTRIB_ARCHIVE </td></tr></table></div><div class="memdoc"><p>The file has to be archived.<p></div></div><p><a class="anchor" name="gafdb0e859960ff33b11b6c55b3188274"></a><!-- doxytag: member="fat16.h::FAT16_ATTRIB_DIR" ref="gafdb0e859960ff33b11b6c55b3188274" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_ATTRIB_DIR </td></tr></table></div><div class="memdoc"><p>The file is a directory.<p></div></div><p><a class="anchor" name="g229780f6a88ab775ea82264c9f1e0616"></a><!-- doxytag: member="fat16.h::FAT16_ATTRIB_HIDDEN" ref="g229780f6a88ab775ea82264c9f1e0616" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_ATTRIB_HIDDEN </td></tr></table></div><div class="memdoc"><p>The file is hidden.<p></div></div><p><a class="anchor" name="g1c4ea0b6e1087b1a88d26b8942c5d923"></a><!-- doxytag: member="fat16.h::FAT16_ATTRIB_READONLY" ref="g1c4ea0b6e1087b1a88d26b8942c5d923" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_ATTRIB_READONLY </td></tr></table></div><div class="memdoc"><p>The file is read-only.<p></div></div><p><a class="anchor" name="ga0badbbc92da7601b4a51d99ba7e8f8f"></a><!-- doxytag: member="fat16.h::FAT16_ATTRIB_SYSTEM" ref="ga0badbbc92da7601b4a51d99ba7e8f8f" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_ATTRIB_SYSTEM </td></tr></table></div><div class="memdoc"><p>The file is a system file.<p></div></div><p><a class="anchor" name="gc1341eb7b40d2f48cacf9b9d8aedbb6c"></a><!-- doxytag: member="fat16.h::FAT16_ATTRIB_VOLUME" ref="gc1341eb7b40d2f48cacf9b9d8aedbb6c" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_ATTRIB_VOLUME </td></tr></table></div><div class="memdoc"><p>The file is empty and has the volume label as its name.<p></div></div><p><a class="anchor" name="g432820c6f8c90e11a92efc931c3b8a3a"></a><!-- doxytag: member="fat16.h::FAT16_SEEK_CUR" ref="g432820c6f8c90e11a92efc931c3b8a3a" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_SEEK_CUR </td></tr></table></div><div class="memdoc"><p>The given offset is relative to the current read/write position.<p></div></div><p><a class="anchor" name="g3793e580ccfcd5e68b95a0740c000e39"></a><!-- doxytag: member="fat16.h::FAT16_SEEK_END" ref="g3793e580ccfcd5e68b95a0740c000e39" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_SEEK_END </td></tr></table></div><div class="memdoc"><p>The given offset is relative to the end of the file.<p></div></div><p><a class="anchor" name="gb90aeb34840c0ea33c8ae9d7577def65"></a><!-- doxytag: member="fat16.h::FAT16_SEEK_SET" ref="gb90aeb34840c0ea33c8ae9d7577def65" args="" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">#define FAT16_SEEK_SET </td></tr></table></div><div class="memdoc"><p>The given offset is relative to the beginning of the file.<p></div></div><p><hr><h2>Function Documentation</h2><a class="anchor" name="g2b2812041f489bc7913bfa5cbcf0172b"></a><!-- doxytag: member="fat16.c::fat16_close_file" ref="g2b2812041f489bc7913bfa5cbcf0172b" args="(struct fat16_file_struct *fd)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">void fat16_close_file </td><td>(</td><td class="paramtype">struct fat16_file_struct * </td><td class="paramname"> <em>fd</em> </td><td> ) </td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Closes a file.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>fd</em> </td><td>The file handle of the file to close. </td></tr></table></dl><dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__fat16.html#g3a43c9943251749978645ad8e3f16757" title="Opens a file on a FAT16 filesystem.">fat16_open_file</a> </dd></dl></div></div><p><a class="anchor" name="gf8029e3ec633902d08e8204d13afc350"></a><!-- doxytag: member="fat16.c::fat16_create_file" ref="gf8029e3ec633902d08e8204d13afc350" args="(struct fat16_dir_struct *parent, const char *file, struct fat16_dir_entry_struct *dir_entry)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">uint8_t fat16_create_file </td><td>(</td><td class="paramtype">struct fat16_dir_struct * </td><td class="paramname"> <em>parent</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">const char * </td><td class="paramname"> <em>file</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> * </td><td class="paramname"> <em>dir_entry</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Creates a file.<p>Creates a file and obtains the directory entry of the new file. If the file to create already exists, the directory entry of the existing file will be returned within the dir_entry parameter.<p><dl class="note" compact><dt><b>Note:</b></dt><dd>The file name is not checked for invalid characters.<p>The generation of the short 8.3 file name is quite simple. The first eight characters are used for the filename. The extension, if any, is made up of the first three characters following the last dot within the long filename. If the filename (without the extension) is longer than eight characters, the lower byte of the cluster number replaces the last two characters to avoid name clashes. In any other case, it is your responsibility to avoid name clashes.</dd></dl><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>parent</em> </td><td>The handle of the directory in which to create the file. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>file</em> </td><td>The name of the file to create. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>dir_entry</em> </td><td>The directory entry to fill for the new file. </td></tr></table></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>0 on failure, 1 on success. </dd></dl><dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__fat16.html#ge060faccbbeca802afe86be2f4d5b485" title="Deletes a file or directory.">fat16_delete_file</a> </dd></dl></div></div><p><a class="anchor" name="ge060faccbbeca802afe86be2f4d5b485"></a><!-- doxytag: member="fat16.c::fat16_delete_file" ref="ge060faccbbeca802afe86be2f4d5b485" args="(struct fat16_fs_struct *fs, struct fat16_dir_entry_struct *dir_entry)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">uint8_t fat16_delete_file </td><td>(</td><td class="paramtype">struct fat16_fs_struct * </td><td class="paramname"> <em>fs</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> * </td><td class="paramname"> <em>dir_entry</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Deletes a file or directory.<p>If a directory is deleted without first deleting its subdirectories and files, disk space occupied by these files will get wasted as there is no chance to release it and mark it as free.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>fs</em> </td><td>The filesystem on which to operate. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>dir_entry</em> </td><td>The directory entry of the file to delete. </td></tr></table></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>0 on failure, 1 on success. </dd></dl><dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__fat16.html#gf8029e3ec633902d08e8204d13afc350" title="Creates a file.">fat16_create_file</a> </dd></dl></div></div><p><a class="anchor" name="g0045fe378de2f7c52b528f985e1891a6"></a><!-- doxytag: member="fat16.c::fat16_get_dir_entry_of_path" ref="g0045fe378de2f7c52b528f985e1891a6" args="(struct fat16_fs_struct *fs, const char *path, struct fat16_dir_entry_struct *dir_entry)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">uint8_t fat16_get_dir_entry_of_path </td><td>(</td><td class="paramtype">struct fat16_fs_struct * </td><td class="paramname"> <em>fs</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">const char * </td><td class="paramname"> <em>path</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> * </td><td class="paramname"> <em>dir_entry</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Retrieves the directory entry of a path.<p>The given path may both describe a file or a directory.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>fs</em> </td><td>The FAT16 filesystem on which to search. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>path</em> </td><td>The path of which to read the directory entry. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>dir_entry</em> </td><td>The directory entry to fill. </td></tr></table></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>0 on failure, 1 on success. </dd></dl><dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__fat16.html#g73c8f0598e8224736b09644c48cf2970" title="Reads the next directory entry contained within a parent directory.">fat16_read_dir</a> </dd></dl></div></div><p><a class="anchor" name="g82c7347c5b3cd8832633d5303552eb38"></a><!-- doxytag: member="fat16.c::fat16_get_file_modification_date" ref="g82c7347c5b3cd8832633d5303552eb38" args="(const struct fat16_dir_entry_struct *dir_entry, uint16_t *year, uint8_t *month, uint8_t *day)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">void fat16_get_file_modification_date </td><td>(</td><td class="paramtype">const struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> * </td><td class="paramname"> <em>dir_entry</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint16_t * </td><td class="paramname"> <em>year</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint8_t * </td><td class="paramname"> <em>month</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint8_t * </td><td class="paramname"> <em>day</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Returns the modification date of a file.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>dir_entry</em> </td><td>The directory entry of which to return the modification date. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>year</em> </td><td>The year the file was last modified. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>month</em> </td><td>The month the file was last modified. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>day</em> </td><td>The day the file was last modified. </td></tr></table></dl></div></div><p><a class="anchor" name="g5040fcab753ef55337292daf8c0d6784"></a><!-- doxytag: member="fat16.c::fat16_get_file_modification_time" ref="g5040fcab753ef55337292daf8c0d6784" args="(const struct fat16_dir_entry_struct *dir_entry, uint8_t *hour, uint8_t *min, uint8_t *sec)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">void fat16_get_file_modification_time </td><td>(</td><td class="paramtype">const struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> * </td><td class="paramname"> <em>dir_entry</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint8_t * </td><td class="paramname"> <em>hour</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint8_t * </td><td class="paramname"> <em>min</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint8_t * </td><td class="paramname"> <em>sec</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Returns the modification time of a file.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>dir_entry</em> </td><td>The directory entry of which to return the modification time. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>hour</em> </td><td>The hour the file was last modified. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>min</em> </td><td>The min the file was last modified. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>sec</em> </td><td>The sec the file was last modified. </td></tr></table></dl></div></div><p><a class="anchor" name="g3a43c9943251749978645ad8e3f16757"></a><!-- doxytag: member="fat16.c::fat16_open_file" ref="g3a43c9943251749978645ad8e3f16757" args="(struct fat16_fs_struct *fs, const struct fat16_dir_entry_struct *dir_entry)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">struct fat16_file_struct* fat16_open_file </td><td>(</td><td class="paramtype">struct fat16_fs_struct * </td><td class="paramname"> <em>fs</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">const struct <a class="el" href="structfat16__dir__entry__struct.html">fat16_dir_entry_struct</a> * </td><td class="paramname"> <em>dir_entry</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"><code> [read]</code></td></tr></table></div><div class="memdoc"><p>Opens a file on a FAT16 filesystem.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>fs</em> </td><td>The filesystem on which the file to open lies. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>dir_entry</em> </td><td>The directory entry of the file to open. </td></tr></table></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>The file handle, or 0 on failure. </dd></dl><dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__fat16.html#g2b2812041f489bc7913bfa5cbcf0172b" title="Closes a file.">fat16_close_file</a> </dd></dl></div></div><p><a class="anchor" name="g0af2ef3d690626a5640a334cefbb27a6"></a><!-- doxytag: member="fat16.c::fat16_read_file" ref="g0af2ef3d690626a5640a334cefbb27a6" args="(struct fat16_file_struct *fd, uint8_t *buffer, uint16_t buffer_len)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">int16_t fat16_read_file </td><td>(</td><td class="paramtype">struct fat16_file_struct * </td><td class="paramname"> <em>fd</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint8_t * </td><td class="paramname"> <em>buffer</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint16_t </td><td class="paramname"> <em>buffer_len</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Reads data from a file.<p>The data requested is read from the current file location.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>fd</em> </td><td>The file handle of the file from which to read. </td></tr><tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>buffer</em> </td><td>The buffer into which to write. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>buffer_len</em> </td><td>The amount of data to read. </td></tr></table></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>The number of bytes read, 0 on end of file, or -1 on failure. </dd></dl><dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__fat16.html#g4f0c785a47b1cf070839b5edec2c6f65" title="Writes data to a file.">fat16_write_file</a> </dd></dl></div></div><p><a class="anchor" name="g23740742fa60ca148ef098caac7085c0"></a><!-- doxytag: member="fat16.c::fat16_resize_file" ref="g23740742fa60ca148ef098caac7085c0" args="(struct fat16_file_struct *fd, uint32_t size)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">uint8_t fat16_resize_file </td><td>(</td><td class="paramtype">struct fat16_file_struct * </td><td class="paramname"> <em>fd</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint32_t </td><td class="paramname"> <em>size</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Resizes a file to have a specific size.<p>Enlarges or shrinks the file pointed to by the file descriptor to have exactly the specified size.<p>If the file is truncated, all bytes having an equal or larger offset than the given size are lost. If the file is expanded, the additional bytes are allocated.<p><dl class="note" compact><dt><b>Note:</b></dt><dd>Please be aware that this function just allocates or deallocates disk space, it does not explicitely clear it. To avoid data leakage, this must be done manually.</dd></dl><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>fd</em> </td><td>The file decriptor of the file which to resize. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>size</em> </td><td>The new size of the file. </td></tr></table></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>0 on failure, 1 on success. </dd></dl></div></div><p><a class="anchor" name="gf1511fd1a5419d0828265566dc5d33e4"></a><!-- doxytag: member="fat16.c::fat16_seek_file" ref="gf1511fd1a5419d0828265566dc5d33e4" args="(struct fat16_file_struct *fd, int32_t *offset, uint8_t whence)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">uint8_t fat16_seek_file </td><td>(</td><td class="paramtype">struct fat16_file_struct * </td><td class="paramname"> <em>fd</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">int32_t * </td><td class="paramname"> <em>offset</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint8_t </td><td class="paramname"> <em>whence</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Repositions the read/write file offset.<p>Changes the file offset where the next call to <a class="el" href="group__fat16__file.html#g0af2ef3d690626a5640a334cefbb27a6" title="Reads data from a file.">fat16_read_file()</a> or <a class="el" href="group__fat16__file.html#g4f0c785a47b1cf070839b5edec2c6f65" title="Writes data to a file.">fat16_write_file()</a> starts reading/writing.<p>If the new offset is beyond the end of the file, <a class="el" href="group__fat16__file.html#g23740742fa60ca148ef098caac7085c0" title="Resizes a file to have a specific size.">fat16_resize_file()</a> is implicitly called, i.e. the file is expanded.<p>The new offset can be given in different ways determined by the <code>whence</code> parameter:<ul><li><b>FAT16_SEEK_SET:</b> <code>*offset</code> is relative to the beginning of the file.</li><li><b>FAT16_SEEK_CUR:</b> <code>*offset</code> is relative to the current file position.</li><li><b>FAT16_SEEK_END:</b> <code>*offset</code> is relative to the end of the file.</li></ul><p>The resulting absolute offset is written to the location the <code>offset</code> parameter points to.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>fd</em> </td><td>The file decriptor of the file on which to seek. </td></tr><tr><td valign="top"><tt>[in,out]</tt> </td><td valign="top"><em>offset</em> </td><td>A pointer to the new offset, as affected by the <code>whence</code> parameter. The function writes the new absolute offset to this location before it returns. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>whence</em> </td><td>Affects the way <code>offset</code> is interpreted, see above. </td></tr></table></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>0 on failure, 1 on success. </dd></dl></div></div><p><a class="anchor" name="g4f0c785a47b1cf070839b5edec2c6f65"></a><!-- doxytag: member="fat16.c::fat16_write_file" ref="g4f0c785a47b1cf070839b5edec2c6f65" args="(struct fat16_file_struct *fd, const uint8_t *buffer, uint16_t buffer_len)" --><div class="memitem"><div class="memproto"><table class="memname"><tr><td class="memname">int16_t fat16_write_file </td><td>(</td><td class="paramtype">struct fat16_file_struct * </td><td class="paramname"> <em>fd</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">const uint8_t * </td><td class="paramname"> <em>buffer</em>, </td></tr><tr><td class="paramkey"></td><td></td><td class="paramtype">uint16_t </td><td class="paramname"> <em>buffer_len</em></td><td> </td></tr><tr><td></td><td>)</td><td></td><td></td><td width="100%"></td></tr></table></div><div class="memdoc"><p>Writes data to a file.<p>The data is written to the current file location.<p><dl compact><dt><b>Parameters:</b></dt><dd><table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>fd</em> </td><td>The file handle of the file to which to write. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>buffer</em> </td><td>The buffer from which to read the data to be written. </td></tr><tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>buffer_len</em> </td><td>The amount of data to write. </td></tr></table></dl><dl class="return" compact><dt><b>Returns:</b></dt><dd>The number of bytes written, 0 on disk full, or -1 on failure. </dd></dl><dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="group__fat16.html#g0af2ef3d690626a5640a334cefbb27a6" title="Reads data from a file.">fat16_read_file</a> </dd></dl></div></div><p><hr size="1"><address style="text-align: right;"><small>Generated on Thu Dec 13 19:38:48 2007 for sd-reader by <a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3-20071008 </small></address></body></html>