You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
					
					
						
							321 lines
						
					
					
						
							13 KiB
						
					
					
				
			
		
		
		
			
			
			
				
					
				
				
					
				
			
		
		
	
	
							321 lines
						
					
					
						
							13 KiB
						
					
					
				
								<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
							 | 
						|
								<html xmlns="http://www.w3.org/1999/xhtml">
							 | 
						|
								<head>
							 | 
						|
								<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
							 | 
						|
								<meta http-equiv="X-UA-Compatible" content="IE=9"/>
							 | 
						|
								<meta name="generator" content="Doxygen 1.8.13"/>
							 | 
						|
								<meta name="viewport" content="width=device-width, initial-scale=1"/>
							 | 
						|
								<title>EmbeddedEtcher: os/error.c File Reference</title>
							 | 
						|
								<link href="tabs.css" rel="stylesheet" type="text/css"/>
							 | 
						|
								<script type="text/javascript" src="jquery.js"></script>
							 | 
						|
								<script type="text/javascript" src="dynsections.js"></script>
							 | 
						|
								<link href="search/search.css" rel="stylesheet" type="text/css"/>
							 | 
						|
								<script type="text/javascript" src="search/searchdata.js"></script>
							 | 
						|
								<script type="text/javascript" src="search/search.js"></script>
							 | 
						|
								<link href="doxygen.css" rel="stylesheet" type="text/css" />
							 | 
						|
								</head>
							 | 
						|
								<body>
							 | 
						|
								<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
							 | 
						|
								<div id="titlearea">
							 | 
						|
								<table cellspacing="0" cellpadding="0">
							 | 
						|
								 <tbody>
							 | 
						|
								 <tr style="height: 56px;">
							 | 
						|
								  <td id="projectalign" style="padding-left: 0.5em;">
							 | 
						|
								   <div id="projectname">EmbeddedEtcher
							 | 
						|
								   </div>
							 | 
						|
								  </td>
							 | 
						|
								 </tr>
							 | 
						|
								 </tbody>
							 | 
						|
								</table>
							 | 
						|
								</div>
							 | 
						|
								<!-- end header part -->
							 | 
						|
								<!-- Generated by Doxygen 1.8.13 -->
							 | 
						|
								<script type="text/javascript">
							 | 
						|
								var searchBox = new SearchBox("searchBox", "search",false,'Search');
							 | 
						|
								</script>
							 | 
						|
								<script type="text/javascript" src="menudata.js"></script>
							 | 
						|
								<script type="text/javascript" src="menu.js"></script>
							 | 
						|
								<script type="text/javascript">
							 | 
						|
								$(function() {
							 | 
						|
								  initMenu('',true,false,'search.php','Search');
							 | 
						|
								  $(document).ready(function() { init_search(); });
							 | 
						|
								});
							 | 
						|
								</script>
							 | 
						|
								<div id="main-nav"></div>
							 | 
						|
								<!-- window showing the filter options -->
							 | 
						|
								<div id="MSearchSelectWindow"
							 | 
						|
								     onmouseover="return searchBox.OnSearchSelectShow()"
							 | 
						|
								     onmouseout="return searchBox.OnSearchSelectHide()"
							 | 
						|
								     onkeydown="return searchBox.OnSearchSelectKey(event)">
							 | 
						|
								</div>
							 | 
						|
								
							 | 
						|
								<!-- iframe showing the search results (closed by default) -->
							 | 
						|
								<div id="MSearchResultsWindow">
							 | 
						|
								<iframe src="javascript:void(0)" frameborder="0" 
							 | 
						|
								        name="MSearchResults" id="MSearchResults">
							 | 
						|
								</iframe>
							 | 
						|
								</div>
							 | 
						|
								
							 | 
						|
								<div id="nav-path" class="navpath">
							 | 
						|
								  <ul>
							 | 
						|
								<li class="navelem"><a class="el" href="dir_8b7cb6c889a10e2a101a7e90c854ca4d.html">os</a></li>  </ul>
							 | 
						|
								</div>
							 | 
						|
								</div><!-- top -->
							 | 
						|
								<div class="header">
							 | 
						|
								  <div class="summary">
							 | 
						|
								<a href="#func-members">Functions</a>  </div>
							 | 
						|
								  <div class="headertitle">
							 | 
						|
								<div class="title">error.c File Reference</div>  </div>
							 | 
						|
								</div><!--header-->
							 | 
						|
								<div class="contents">
							 | 
						|
								<div class="textblock"><code>#include <stdio.h></code><br />
							 | 
						|
								<code>#include <string.h></code><br />
							 | 
						|
								<code>#include <stdint.h></code><br />
							 | 
						|
								<code>#include "<a class="el" href="error_8h_source.html">error.h</a>"</code><br />
							 | 
						|
								<code>#include "<a class="el" href="helpers_8h_source.html">helpers.h</a>"</code><br />
							 | 
						|
								<code>#include "<a class="el" href="printf_8h_source.html">printf.h</a>"</code><br />
							 | 
						|
								<code>#include "<a class="el" href="ossettings_8h_source.html">ossettings.h</a>"</code><br />
							 | 
						|
								</div><div class="textblock"><div class="dynheader">
							 | 
						|
								Include dependency graph for error.c:</div>
							 | 
						|
								<div class="dyncontent">
							 | 
						|
								<div class="center"><img src="error_8c__incl.png" border="0" usemap="#os_2error_8c" alt=""/></div>
							 | 
						|
								<map name="os_2error_8c" id="os_2error_8c">
							 | 
						|
								<area shape="rect" id="node5" href="error_8h.html" title="error.h" alt="" coords="135,80,194,107"/>
							 | 
						|
								<area shape="rect" id="node7" href="ossettings_8h.html" title="ossettings.h" alt="" coords="126,229,219,256"/>
							 | 
						|
								<area shape="rect" id="node8" href="helpers_8h.html" title="helpers.h" alt="" coords="454,80,529,107"/>
							 | 
						|
								<area shape="rect" id="node11" href="printf_8h.html" title="printf.h" alt="" coords="340,80,403,107"/>
							 | 
						|
								<area shape="rect" id="node6" href="ostypes_8h.html" title="ostypes.h" alt="" coords="56,155,135,181"/>
							 | 
						|
								</map>
							 | 
						|
								</div>
							 | 
						|
								</div><table class="memberdecls">
							 | 
						|
								<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
							 | 
						|
								Functions</h2></td></tr>
							 | 
						|
								<tr class="memitem:af770cfb23cba6e7aa7c69aad1bbf968c"><td class="memItemLeft" align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="error_8c.html#af770cfb23cba6e7aa7c69aad1bbf968c">osExplainError</a> (const char *ifile, const uint8_t iline, const <a class="el" href="ostypes_8h.html#acd9f76a1fbd8bc9084ff34add637094f">osError_t</a> ierror, char *iomessage)</td></tr>
							 | 
						|
								<tr class="separator:af770cfb23cba6e7aa7c69aad1bbf968c"><td class="memSeparator" colspan="2"> </td></tr>
							 | 
						|
								<tr class="memitem:a540c46d0a32421cad29354147a02c4ea"><td class="memItemLeft" align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="error_8c.html#a540c46d0a32421cad29354147a02c4ea">osPrintError</a> (const char *ifile, const int iline, const <a class="el" href="ostypes_8h.html#acd9f76a1fbd8bc9084ff34add637094f">osError_t</a> ierror)</td></tr>
							 | 
						|
								<tr class="separator:a540c46d0a32421cad29354147a02c4ea"><td class="memSeparator" colspan="2"> </td></tr>
							 | 
						|
								<tr class="memitem:a29238a23e284dd0a6278434447be4682"><td class="memItemLeft" align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="error_8c.html#a29238a23e284dd0a6278434447be4682">osExplainWarning</a> (const char *ifile, const uint8_t iline, const <a class="el" href="ostypes_8h.html#a5c976ef3f21f800d03382e5cc640c362">osWarning_t</a> ierror, char *iomessage)</td></tr>
							 | 
						|
								<tr class="separator:a29238a23e284dd0a6278434447be4682"><td class="memSeparator" colspan="2"> </td></tr>
							 | 
						|
								<tr class="memitem:adeb03b63a59cac38dbdc0e3963d9d479"><td class="memItemLeft" align="right" valign="top">uint8_t </td><td class="memItemRight" valign="bottom"><a class="el" href="error_8c.html#adeb03b63a59cac38dbdc0e3963d9d479">osPrintWarning</a> (const char *ifile, const int iline, const <a class="el" href="ostypes_8h.html#a5c976ef3f21f800d03382e5cc640c362">osWarning_t</a> iwarning)</td></tr>
							 | 
						|
								<tr class="separator:adeb03b63a59cac38dbdc0e3963d9d479"><td class="memSeparator" colspan="2"> </td></tr>
							 | 
						|
								</table>
							 | 
						|
								<h2 class="groupheader">Function Documentation</h2>
							 | 
						|
								<a id="af770cfb23cba6e7aa7c69aad1bbf968c"></a>
							 | 
						|
								<h2 class="memtitle"><span class="permalink"><a href="#af770cfb23cba6e7aa7c69aad1bbf968c">◆ </a></span>osExplainError()</h2>
							 | 
						|
								
							 | 
						|
								<div class="memitem">
							 | 
						|
								<div class="memproto">
							 | 
						|
								      <table class="memname">
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="memname">uint8_t osExplainError </td>
							 | 
						|
								          <td>(</td>
							 | 
						|
								          <td class="paramtype">const char * </td>
							 | 
						|
								          <td class="paramname"><em>ifile</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">const uint8_t </td>
							 | 
						|
								          <td class="paramname"><em>iline</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">const <a class="el" href="ostypes_8h.html#acd9f76a1fbd8bc9084ff34add637094f">osError_t</a> </td>
							 | 
						|
								          <td class="paramname"><em>ierror</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">char * </td>
							 | 
						|
								          <td class="paramname"><em>iomessage</em> </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td>)</td>
							 | 
						|
								          <td></td><td></td>
							 | 
						|
								        </tr>
							 | 
						|
								      </table>
							 | 
						|
								</div><div class="memdoc">
							 | 
						|
								<p>Creating a error message string from inter alia an error code.</p>
							 | 
						|
								<dl class="params"><dt>Parameters</dt><dd>
							 | 
						|
								  <table class="params">
							 | 
						|
								    <tr><td class="paramname">ifile</td><td>Filename where error occurs. </td></tr>
							 | 
						|
								    <tr><td class="paramname">iline</td><td>Line where error occurs. </td></tr>
							 | 
						|
								    <tr><td class="paramname">ierror</td><td>Error code. </td></tr>
							 | 
						|
								    <tr><td class="paramname">message</td><td>Message related to the error. </td></tr>
							 | 
						|
								  </table>
							 | 
						|
								  </dd>
							 | 
						|
								</dl>
							 | 
						|
								<dl class="retval"><dt>Return values</dt><dd>
							 | 
						|
								  <table class="retval">
							 | 
						|
								    <tr><td class="paramname">1</td><td>(SUCCESS) or 0 (FAILURE). </td></tr>
							 | 
						|
								  </table>
							 | 
						|
								  </dd>
							 | 
						|
								</dl>
							 | 
						|
								
							 | 
						|
								</div>
							 | 
						|
								</div>
							 | 
						|
								<a id="a29238a23e284dd0a6278434447be4682"></a>
							 | 
						|
								<h2 class="memtitle"><span class="permalink"><a href="#a29238a23e284dd0a6278434447be4682">◆ </a></span>osExplainWarning()</h2>
							 | 
						|
								
							 | 
						|
								<div class="memitem">
							 | 
						|
								<div class="memproto">
							 | 
						|
								      <table class="memname">
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="memname">uint8_t osExplainWarning </td>
							 | 
						|
								          <td>(</td>
							 | 
						|
								          <td class="paramtype">const char * </td>
							 | 
						|
								          <td class="paramname"><em>ifile</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">const uint8_t </td>
							 | 
						|
								          <td class="paramname"><em>iline</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">const <a class="el" href="ostypes_8h.html#a5c976ef3f21f800d03382e5cc640c362">osWarning_t</a> </td>
							 | 
						|
								          <td class="paramname"><em>ierror</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">char * </td>
							 | 
						|
								          <td class="paramname"><em>iomessage</em> </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td>)</td>
							 | 
						|
								          <td></td><td></td>
							 | 
						|
								        </tr>
							 | 
						|
								      </table>
							 | 
						|
								</div><div class="memdoc">
							 | 
						|
								<p>Creating a warning message string from inter alia a warning code.</p>
							 | 
						|
								<dl class="params"><dt>Parameters</dt><dd>
							 | 
						|
								  <table class="params">
							 | 
						|
								    <tr><td class="paramname">ifile</td><td>Filename where warning occurs. </td></tr>
							 | 
						|
								    <tr><td class="paramname">iline</td><td>Line where warning occurs. </td></tr>
							 | 
						|
								    <tr><td class="paramname">ierror</td><td>Warning code. </td></tr>
							 | 
						|
								    <tr><td class="paramname">message</td><td>Message related to the warning. </td></tr>
							 | 
						|
								  </table>
							 | 
						|
								  </dd>
							 | 
						|
								</dl>
							 | 
						|
								<dl class="retval"><dt>Return values</dt><dd>
							 | 
						|
								  <table class="retval">
							 | 
						|
								    <tr><td class="paramname">1</td><td>(SUCCESS) or 0 (FAILURE). </td></tr>
							 | 
						|
								  </table>
							 | 
						|
								  </dd>
							 | 
						|
								</dl>
							 | 
						|
								
							 | 
						|
								</div>
							 | 
						|
								</div>
							 | 
						|
								<a id="a540c46d0a32421cad29354147a02c4ea"></a>
							 | 
						|
								<h2 class="memtitle"><span class="permalink"><a href="#a540c46d0a32421cad29354147a02c4ea">◆ </a></span>osPrintError()</h2>
							 | 
						|
								
							 | 
						|
								<div class="memitem">
							 | 
						|
								<div class="memproto">
							 | 
						|
								      <table class="memname">
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="memname">uint8_t osPrintError </td>
							 | 
						|
								          <td>(</td>
							 | 
						|
								          <td class="paramtype">const char * </td>
							 | 
						|
								          <td class="paramname"><em>ifile</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">const int </td>
							 | 
						|
								          <td class="paramname"><em>iline</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">const <a class="el" href="ostypes_8h.html#acd9f76a1fbd8bc9084ff34add637094f">osError_t</a> </td>
							 | 
						|
								          <td class="paramname"><em>ierror</em> </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td>)</td>
							 | 
						|
								          <td></td><td></td>
							 | 
						|
								        </tr>
							 | 
						|
								      </table>
							 | 
						|
								</div><div class="memdoc">
							 | 
						|
								<p>Print error. This is where the error output can be redirected (later).</p>
							 | 
						|
								<dl class="params"><dt>Parameters</dt><dd>
							 | 
						|
								  <table class="params">
							 | 
						|
								    <tr><td class="paramname">ifile</td><td>Filename where error occurs. </td></tr>
							 | 
						|
								    <tr><td class="paramname">iline</td><td>Line where error occurs. </td></tr>
							 | 
						|
								    <tr><td class="paramname">ierror</td><td>Error code. </td></tr>
							 | 
						|
								  </table>
							 | 
						|
								  </dd>
							 | 
						|
								</dl>
							 | 
						|
								<dl class="retval"><dt>Return values</dt><dd>
							 | 
						|
								  <table class="retval">
							 | 
						|
								    <tr><td class="paramname">1</td><td>(SUCCESS) or 0 (FAILURE). </td></tr>
							 | 
						|
								  </table>
							 | 
						|
								  </dd>
							 | 
						|
								</dl>
							 | 
						|
								
							 | 
						|
								</div>
							 | 
						|
								</div>
							 | 
						|
								<a id="adeb03b63a59cac38dbdc0e3963d9d479"></a>
							 | 
						|
								<h2 class="memtitle"><span class="permalink"><a href="#adeb03b63a59cac38dbdc0e3963d9d479">◆ </a></span>osPrintWarning()</h2>
							 | 
						|
								
							 | 
						|
								<div class="memitem">
							 | 
						|
								<div class="memproto">
							 | 
						|
								      <table class="memname">
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="memname">uint8_t osPrintWarning </td>
							 | 
						|
								          <td>(</td>
							 | 
						|
								          <td class="paramtype">const char * </td>
							 | 
						|
								          <td class="paramname"><em>ifile</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">const int </td>
							 | 
						|
								          <td class="paramname"><em>iline</em>, </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td class="paramkey"></td>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td class="paramtype">const <a class="el" href="ostypes_8h.html#a5c976ef3f21f800d03382e5cc640c362">osWarning_t</a> </td>
							 | 
						|
								          <td class="paramname"><em>ierror</em> </td>
							 | 
						|
								        </tr>
							 | 
						|
								        <tr>
							 | 
						|
								          <td></td>
							 | 
						|
								          <td>)</td>
							 | 
						|
								          <td></td><td></td>
							 | 
						|
								        </tr>
							 | 
						|
								      </table>
							 | 
						|
								</div><div class="memdoc">
							 | 
						|
								<p>Print warning. This is where the warning output can be redirected (later).</p>
							 | 
						|
								<dl class="params"><dt>Parameters</dt><dd>
							 | 
						|
								  <table class="params">
							 | 
						|
								    <tr><td class="paramname">ifile</td><td>Filename where warning occurs. </td></tr>
							 | 
						|
								    <tr><td class="paramname">iline</td><td>Line where warning occurs. </td></tr>
							 | 
						|
								    <tr><td class="paramname">ierror</td><td>Warning code. </td></tr>
							 | 
						|
								  </table>
							 | 
						|
								  </dd>
							 | 
						|
								</dl>
							 | 
						|
								<dl class="retval"><dt>Return values</dt><dd>
							 | 
						|
								  <table class="retval">
							 | 
						|
								    <tr><td class="paramname">1</td><td>(SUCCESS) or 0 (FAILURE). </td></tr>
							 | 
						|
								  </table>
							 | 
						|
								  </dd>
							 | 
						|
								</dl>
							 | 
						|
								
							 | 
						|
								</div>
							 | 
						|
								</div>
							 | 
						|
								</div><!-- contents -->
							 | 
						|
								<!-- start footer part -->
							 | 
						|
								<hr class="footer"/><address class="footer"><small>
							 | 
						|
								Generated by  <a href="http://www.doxygen.org/index.html">
							 | 
						|
								<img class="footer" src="doxygen.png" alt="doxygen"/>
							 | 
						|
								</a> 1.8.13
							 | 
						|
								</small></address>
							 | 
						|
								</body>
							 | 
						|
								</html>
							 | 
						|
								
							 |