<!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>mbed TLS v2.6.0: platform.h Source File</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="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">mbed TLS v2.6.0
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',false,false,'search.php','Search');
});
</script>
<div id="main-nav"></div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_d44c64559bbebec7f509842c48db8b23.html">include</a></li><li class="navelem"><a class="el" href="dir_b4d146e9a6d8dd56ed4afb2480a97fd3.html">mbedtls</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">platform.h</div> </div>
</div><!--header-->
<div class="contents">
<a href="platform_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> </div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="preprocessor">#ifndef MBEDTLS_PLATFORM_H</span></div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#define MBEDTLS_PLATFORM_H</span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> </div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#if !defined(MBEDTLS_CONFIG_FILE)</span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">#include "<a class="code" href="config_8h.html">config.h</a>"</span></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor">#include MBEDTLS_CONFIG_FILE</span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> </div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#if defined(MBEDTLS_HAVE_TIME)</span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include "<a class="code" href="platform__time_8h.html">mbedtls/platform_time.h</a>"</span></div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> </div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#ifdef __cplusplus</span></div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="keyword">extern</span> <span class="stringliteral">"C"</span> {</div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> </div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_NO_STD_FUNCTIONS)</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="preprocessor">#include <stdio.h></span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="preprocessor">#include <stdlib.h></span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="preprocessor">#include <time.h></span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_SNPRINTF)</span></div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="preprocessor">#if defined(_WIN32)</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_SNPRINTF mbedtls_platform_win32_snprintf </span></div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00056"></a><span class="lineno"><a class="line" href="platform_8h.html#ac128e71af8e5de1edc7a6d43f4633de9"> 56</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_SNPRINTF snprintf </span></div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_PRINTF)</span></div><div class="line"><a name="l00060"></a><span class="lineno"><a class="line" href="platform_8h.html#a7f558b4383b398ef4c9901fe8952c603"> 60</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_PRINTF printf </span></div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_FPRINTF)</span></div><div class="line"><a name="l00063"></a><span class="lineno"><a class="line" href="platform_8h.html#acfb169577d838484539f5b17be8ab034"> 63</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_FPRINTF fprintf </span></div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_CALLOC)</span></div><div class="line"><a name="l00066"></a><span class="lineno"><a class="line" href="platform_8h.html#a9e7b93e4a92624d51bc7cbdc04723a05"> 66</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_CALLOC calloc </span></div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_FREE)</span></div><div class="line"><a name="l00069"></a><span class="lineno"><a class="line" href="platform_8h.html#a2abc88498566e351dc97660f5aecf46c"> 69</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_FREE free </span></div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_EXIT)</span></div><div class="line"><a name="l00072"></a><span class="lineno"><a class="line" href="platform_8h.html#a38913959323b25e00cdaf606647ef398"> 72</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_EXIT exit </span></div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_TIME)</span></div><div class="line"><a name="l00075"></a><span class="lineno"><a class="line" href="platform_8h.html#a617cd0d84bb5dd4d1fc44d4975873b6c"> 75</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_TIME time </span></div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_EXIT_SUCCESS)</span></div><div class="line"><a name="l00078"></a><span class="lineno"><a class="line" href="platform_8h.html#ad9a994f168868af54652a992937df5d0"> 78</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_EXIT_SUCCESS EXIT_SUCCESS </span></div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_EXIT_FAILURE)</span></div><div class="line"><a name="l00081"></a><span class="lineno"><a class="line" href="platform_8h.html#a04892f78f480255957e858fd6f82053a"> 81</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_EXIT_FAILURE EXIT_FAILURE </span></div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="preprocessor">#if defined(MBEDTLS_FS_IO)</span></div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_NV_SEED_READ)</span></div><div class="line"><a name="l00085"></a><span class="lineno"><a class="line" href="platform_8h.html#aa48a4c49a3bf3d0d41b7142270d752d4"> 85</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_NV_SEED_READ mbedtls_platform_std_nv_seed_read</span></div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_NV_SEED_WRITE)</span></div><div class="line"><a name="l00088"></a><span class="lineno"><a class="line" href="platform_8h.html#a53ddd1e4f60566c81a83d45026a643c8"> 88</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_NV_SEED_WRITE mbedtls_platform_std_nv_seed_write</span></div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_STD_NV_SEED_FILE)</span></div><div class="line"><a name="l00091"></a><span class="lineno"><a class="line" href="platform_8h.html#a0edd4a9b0e9ba51ea85c74780101b7cd"> 91</a></span> <span class="preprocessor">#define MBEDTLS_PLATFORM_STD_NV_SEED_FILE "seedfile"</span></div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_FS_IO */</span><span class="preprocessor"></span></div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="preprocessor">#else </span><span class="comment">/* MBEDTLS_PLATFORM_NO_STD_FUNCTIONS */</span><span class="preprocessor"></span></div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_STD_MEM_HDR)</span></div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span> <span class="preprocessor">#include MBEDTLS_PLATFORM_STD_MEM_HDR</span></div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_NO_STD_FUNCTIONS */</span><span class="preprocessor"></span></div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span> </div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span> </div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span> <span class="comment">/* \} name SECTION: Module settings */</span></div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span> </div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span> <span class="comment">/*</span></div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span> <span class="comment"> * The function pointers for calloc and free</span></div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="comment"> */</span></div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_MEMORY)</span></div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_FREE_MACRO) && \</span></div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="preprocessor"> defined(MBEDTLS_PLATFORM_CALLOC_MACRO)</span></div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <span class="preprocessor">#define mbedtls_free MBEDTLS_PLATFORM_FREE_MACRO</span></div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="preprocessor">#define mbedtls_calloc MBEDTLS_PLATFORM_CALLOC_MACRO</span></div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="comment">/* For size_t */</span></div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="preprocessor">#include <stddef.h></span></div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="keyword">extern</span> <span class="keywordtype">void</span> * (*mbedtls_calloc)( <span class="keywordtype">size_t</span> n, <span class="keywordtype">size_t</span> size );</div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="keyword">extern</span> void (*<a class="code" href="platform_8h.html#a4f80030b2d10f956f8ac00b57eebfbe8">mbedtls_free</a>)( <span class="keywordtype">void</span> *ptr );</div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span> </div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="keywordtype">int</span> mbedtls_platform_set_calloc_free( <span class="keywordtype">void</span> * (*calloc_func)( <span class="keywordtype">size_t</span>, <span class="keywordtype">size_t</span> ),</div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <span class="keywordtype">void</span> (*free_func)( <span class="keywordtype">void</span> * ) );</div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_FREE_MACRO && MBEDTLS_PLATFORM_CALLOC_MACRO */</span><span class="preprocessor"></span></div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span> <span class="preprocessor">#else </span><span class="comment">/* !MBEDTLS_PLATFORM_MEMORY */</span><span class="preprocessor"></span></div><div class="line"><a name="l00129"></a><span class="lineno"><a class="line" href="platform_8h.html#a4f80030b2d10f956f8ac00b57eebfbe8"> 129</a></span> <span class="preprocessor">#define mbedtls_free free</span></div><div class="line"><a name="l00130"></a><span class="lineno"><a class="line" href="platform_8h.html#aa7fa389b6ec8a6c33f594f8c3f5c76ef"> 130</a></span> <span class="preprocessor">#define mbedtls_calloc calloc</span></div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_MEMORY && !MBEDTLS_PLATFORM_{FREE,CALLOC}_MACRO */</span><span class="preprocessor"></span></div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span> </div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment">/*</span></div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span> <span class="comment"> * The function pointers for fprintf</span></div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="comment"> */</span></div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_FPRINTF_ALT)</span></div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="comment">/* We need FILE * */</span></div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="preprocessor">#include <stdio.h></span></div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span> <span class="keyword">extern</span> int (*<a class="code" href="platform_8h.html#a6d045f0c3699e1eac7f723054dc8b3e4">mbedtls_fprintf</a>)( FILE *stream, <span class="keyword">const</span> <span class="keywordtype">char</span> *format, ... );</div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span> </div><div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="keywordtype">int</span> mbedtls_platform_set_fprintf( <span class="keywordtype">int</span> (*fprintf_func)( FILE *stream, <span class="keyword">const</span> <span class="keywordtype">char</span> *,</div><div class="line"><a name="l00149"></a><span class="lineno"> 149</span>  ... ) );</div><div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_FPRINTF_MACRO)</span></div><div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="preprocessor">#define mbedtls_fprintf MBEDTLS_PLATFORM_FPRINTF_MACRO</span></div><div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00154"></a><span class="lineno"><a class="line" href="platform_8h.html#a6d045f0c3699e1eac7f723054dc8b3e4"> 154</a></span> <span class="preprocessor">#define mbedtls_fprintf fprintf</span></div><div class="line"><a name="l00155"></a><span class="lineno"> 155</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_FPRINTF_MACRO */</span><span class="preprocessor"></span></div><div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_FPRINTF_ALT */</span><span class="preprocessor"></span></div><div class="line"><a name="l00157"></a><span class="lineno"> 157</span> </div><div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="comment">/*</span></div><div class="line"><a name="l00159"></a><span class="lineno"> 159</span> <span class="comment"> * The function pointers for printf</span></div><div class="line"><a name="l00160"></a><span class="lineno"> 160</span> <span class="comment"> */</span></div><div class="line"><a name="l00161"></a><span class="lineno"> 161</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_PRINTF_ALT)</span></div><div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <span class="keyword">extern</span> int (*<a class="code" href="platform_8h.html#af846397815d6b78aadc6ce9bb6bc9238">mbedtls_printf</a>)( <span class="keyword">const</span> <span class="keywordtype">char</span> *format, ... );</div><div class="line"><a name="l00163"></a><span class="lineno"> 163</span> </div><div class="line"><a name="l00171"></a><span class="lineno"> 171</span> <span class="keywordtype">int</span> mbedtls_platform_set_printf( <span class="keywordtype">int</span> (*printf_func)( <span class="keyword">const</span> <span class="keywordtype">char</span> *, ... ) );</div><div class="line"><a name="l00172"></a><span class="lineno"> 172</span> <span class="preprocessor">#else </span><span class="comment">/* !MBEDTLS_PLATFORM_PRINTF_ALT */</span><span class="preprocessor"></span></div><div class="line"><a name="l00173"></a><span class="lineno"> 173</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_PRINTF_MACRO)</span></div><div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <span class="preprocessor">#define mbedtls_printf MBEDTLS_PLATFORM_PRINTF_MACRO</span></div><div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00176"></a><span class="lineno"><a class="line" href="platform_8h.html#af846397815d6b78aadc6ce9bb6bc9238"> 176</a></span> <span class="preprocessor">#define mbedtls_printf printf</span></div><div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_PRINTF_MACRO */</span><span class="preprocessor"></span></div><div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_PRINTF_ALT */</span><span class="preprocessor"></span></div><div class="line"><a name="l00179"></a><span class="lineno"> 179</span> </div><div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="comment">/*</span></div><div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="comment"> * The function pointers for snprintf</span></div><div class="line"><a name="l00182"></a><span class="lineno"> 182</span> <span class="comment"> *</span></div><div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="comment"> * The snprintf implementation should conform to C99:</span></div><div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="comment"> * - it *must* always correctly zero-terminate the buffer</span></div><div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="comment"> * (except when n == 0, then it must leave the buffer untouched)</span></div><div class="line"><a name="l00186"></a><span class="lineno"> 186</span> <span class="comment"> * - however it is acceptable to return -1 instead of the required length when</span></div><div class="line"><a name="l00187"></a><span class="lineno"> 187</span> <span class="comment"> * the destination buffer is too short.</span></div><div class="line"><a name="l00188"></a><span class="lineno"> 188</span> <span class="comment"> */</span></div><div class="line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="preprocessor">#if defined(_WIN32)</span></div><div class="line"><a name="l00190"></a><span class="lineno"> 190</span> <span class="comment">/* For Windows (inc. MSYS2), we provide our own fixed implementation */</span></div><div class="line"><a name="l00191"></a><span class="lineno"> 191</span> <span class="keywordtype">int</span> mbedtls_platform_win32_snprintf( <span class="keywordtype">char</span> *s, <span class="keywordtype">size_t</span> n, <span class="keyword">const</span> <span class="keywordtype">char</span> *fmt, ... );</div><div class="line"><a name="l00192"></a><span class="lineno"> 192</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00193"></a><span class="lineno"> 193</span> </div><div class="line"><a name="l00194"></a><span class="lineno"> 194</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_SNPRINTF_ALT)</span></div><div class="line"><a name="l00195"></a><span class="lineno"> 195</span> <span class="keyword">extern</span> int (*<a class="code" href="platform_8h.html#a57d4faa7aee8300f544af63b9f6eed63">mbedtls_snprintf</a>)( <span class="keywordtype">char</span> * s, <span class="keywordtype">size_t</span> n, <span class="keyword">const</span> <span class="keywordtype">char</span> * format, ... );</div><div class="line"><a name="l00196"></a><span class="lineno"> 196</span> </div><div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="keywordtype">int</span> mbedtls_platform_set_snprintf( <span class="keywordtype">int</span> (*snprintf_func)( <span class="keywordtype">char</span> * s, <span class="keywordtype">size_t</span> n,</div><div class="line"><a name="l00205"></a><span class="lineno"> 205</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> * format, ... ) );</div><div class="line"><a name="l00206"></a><span class="lineno"> 206</span> <span class="preprocessor">#else </span><span class="comment">/* MBEDTLS_PLATFORM_SNPRINTF_ALT */</span><span class="preprocessor"></span></div><div class="line"><a name="l00207"></a><span class="lineno"> 207</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_SNPRINTF_MACRO)</span></div><div class="line"><a name="l00208"></a><span class="lineno"> 208</span> <span class="preprocessor">#define mbedtls_snprintf MBEDTLS_PLATFORM_SNPRINTF_MACRO</span></div><div class="line"><a name="l00209"></a><span class="lineno"> 209</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00210"></a><span class="lineno"><a class="line" href="platform_8h.html#a57d4faa7aee8300f544af63b9f6eed63"> 210</a></span> <span class="preprocessor">#define mbedtls_snprintf snprintf</span></div><div class="line"><a name="l00211"></a><span class="lineno"> 211</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_SNPRINTF_MACRO */</span><span class="preprocessor"></span></div><div class="line"><a name="l00212"></a><span class="lineno"> 212</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_SNPRINTF_ALT */</span><span class="preprocessor"></span></div><div class="line"><a name="l00213"></a><span class="lineno"> 213</span> </div><div class="line"><a name="l00214"></a><span class="lineno"> 214</span> <span class="comment">/*</span></div><div class="line"><a name="l00215"></a><span class="lineno"> 215</span> <span class="comment"> * The function pointers for exit</span></div><div class="line"><a name="l00216"></a><span class="lineno"> 216</span> <span class="comment"> */</span></div><div class="line"><a name="l00217"></a><span class="lineno"> 217</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_EXIT_ALT)</span></div><div class="line"><a name="l00218"></a><span class="lineno"> 218</span> <span class="keyword">extern</span> void (*<a class="code" href="platform_8h.html#ac30e03304a664d7b69a23fb0ac79a426">mbedtls_exit</a>)( <span class="keywordtype">int</span> status );</div><div class="line"><a name="l00219"></a><span class="lineno"> 219</span> </div><div class="line"><a name="l00227"></a><span class="lineno"> 227</span> <span class="keywordtype">int</span> mbedtls_platform_set_exit( <span class="keywordtype">void</span> (*exit_func)( <span class="keywordtype">int</span> status ) );</div><div class="line"><a name="l00228"></a><span class="lineno"> 228</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00229"></a><span class="lineno"> 229</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_EXIT_MACRO)</span></div><div class="line"><a name="l00230"></a><span class="lineno"> 230</span> <span class="preprocessor">#define mbedtls_exit MBEDTLS_PLATFORM_EXIT_MACRO</span></div><div class="line"><a name="l00231"></a><span class="lineno"> 231</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00232"></a><span class="lineno"><a class="line" href="platform_8h.html#ac30e03304a664d7b69a23fb0ac79a426"> 232</a></span> <span class="preprocessor">#define mbedtls_exit exit</span></div><div class="line"><a name="l00233"></a><span class="lineno"> 233</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_EXIT_MACRO */</span><span class="preprocessor"></span></div><div class="line"><a name="l00234"></a><span class="lineno"> 234</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_EXIT_ALT */</span><span class="preprocessor"></span></div><div class="line"><a name="l00235"></a><span class="lineno"> 235</span> </div><div class="line"><a name="l00236"></a><span class="lineno"> 236</span> <span class="comment">/*</span></div><div class="line"><a name="l00237"></a><span class="lineno"> 237</span> <span class="comment"> * The default exit values</span></div><div class="line"><a name="l00238"></a><span class="lineno"> 238</span> <span class="comment"> */</span></div><div class="line"><a name="l00239"></a><span class="lineno"> 239</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_STD_EXIT_SUCCESS)</span></div><div class="line"><a name="l00240"></a><span class="lineno"><a class="line" href="platform_8h.html#ae0beaef88e29bfd432cb2543ac79f109"> 240</a></span> <span class="preprocessor">#define MBEDTLS_EXIT_SUCCESS MBEDTLS_PLATFORM_STD_EXIT_SUCCESS</span></div><div class="line"><a name="l00241"></a><span class="lineno"> 241</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00242"></a><span class="lineno"> 242</span> <span class="preprocessor">#define MBEDTLS_EXIT_SUCCESS 0</span></div><div class="line"><a name="l00243"></a><span class="lineno"> 243</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00244"></a><span class="lineno"> 244</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_STD_EXIT_FAILURE)</span></div><div class="line"><a name="l00245"></a><span class="lineno"><a class="line" href="platform_8h.html#a416732ec24ebb55fb12969e849ba27c0"> 245</a></span> <span class="preprocessor">#define MBEDTLS_EXIT_FAILURE MBEDTLS_PLATFORM_STD_EXIT_FAILURE</span></div><div class="line"><a name="l00246"></a><span class="lineno"> 246</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00247"></a><span class="lineno"> 247</span> <span class="preprocessor">#define MBEDTLS_EXIT_FAILURE 1</span></div><div class="line"><a name="l00248"></a><span class="lineno"> 248</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00249"></a><span class="lineno"> 249</span> </div><div class="line"><a name="l00250"></a><span class="lineno"> 250</span> <span class="comment">/*</span></div><div class="line"><a name="l00251"></a><span class="lineno"> 251</span> <span class="comment"> * The function pointers for reading from and writing a seed file to</span></div><div class="line"><a name="l00252"></a><span class="lineno"> 252</span> <span class="comment"> * Non-Volatile storage (NV) in a platform-independent way</span></div><div class="line"><a name="l00253"></a><span class="lineno"> 253</span> <span class="comment"> *</span></div><div class="line"><a name="l00254"></a><span class="lineno"> 254</span> <span class="comment"> * Only enabled when the NV seed entropy source is enabled</span></div><div class="line"><a name="l00255"></a><span class="lineno"> 255</span> <span class="comment"> */</span></div><div class="line"><a name="l00256"></a><span class="lineno"> 256</span> <span class="preprocessor">#if defined(MBEDTLS_ENTROPY_NV_SEED)</span></div><div class="line"><a name="l00257"></a><span class="lineno"> 257</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_NO_STD_FUNCTIONS) && defined(MBEDTLS_FS_IO)</span></div><div class="line"><a name="l00258"></a><span class="lineno"> 258</span> <span class="comment">/* Internal standard platform definitions */</span></div><div class="line"><a name="l00259"></a><span class="lineno"> 259</span> <span class="keywordtype">int</span> mbedtls_platform_std_nv_seed_read( <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> buf_len );</div><div class="line"><a name="l00260"></a><span class="lineno"> 260</span> <span class="keywordtype">int</span> mbedtls_platform_std_nv_seed_write( <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> buf_len );</div><div class="line"><a name="l00261"></a><span class="lineno"> 261</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00262"></a><span class="lineno"> 262</span> </div><div class="line"><a name="l00263"></a><span class="lineno"> 263</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_NV_SEED_ALT)</span></div><div class="line"><a name="l00264"></a><span class="lineno"> 264</span> <span class="keyword">extern</span> int (*mbedtls_nv_seed_read)( <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> buf_len );</div><div class="line"><a name="l00265"></a><span class="lineno"> 265</span> <span class="keyword">extern</span> int (*mbedtls_nv_seed_write)( <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> buf_len );</div><div class="line"><a name="l00266"></a><span class="lineno"> 266</span> </div><div class="line"><a name="l00275"></a><span class="lineno"> 275</span> <span class="keywordtype">int</span> mbedtls_platform_set_nv_seed(</div><div class="line"><a name="l00276"></a><span class="lineno"> 276</span>  <span class="keywordtype">int</span> (*nv_seed_read_func)( <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> buf_len ),</div><div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  <span class="keywordtype">int</span> (*nv_seed_write_func)( <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buf, <span class="keywordtype">size_t</span> buf_len )</div><div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  );</div><div class="line"><a name="l00279"></a><span class="lineno"> 279</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00280"></a><span class="lineno"> 280</span> <span class="preprocessor">#if defined(MBEDTLS_PLATFORM_NV_SEED_READ_MACRO) && \</span></div><div class="line"><a name="l00281"></a><span class="lineno"> 281</span> <span class="preprocessor"> defined(MBEDTLS_PLATFORM_NV_SEED_WRITE_MACRO)</span></div><div class="line"><a name="l00282"></a><span class="lineno"> 282</span> <span class="preprocessor">#define mbedtls_nv_seed_read MBEDTLS_PLATFORM_NV_SEED_READ_MACRO</span></div><div class="line"><a name="l00283"></a><span class="lineno"> 283</span> <span class="preprocessor">#define mbedtls_nv_seed_write MBEDTLS_PLATFORM_NV_SEED_WRITE_MACRO</span></div><div class="line"><a name="l00284"></a><span class="lineno"> 284</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00285"></a><span class="lineno"> 285</span> <span class="preprocessor">#define mbedtls_nv_seed_read mbedtls_platform_std_nv_seed_read</span></div><div class="line"><a name="l00286"></a><span class="lineno"> 286</span> <span class="preprocessor">#define mbedtls_nv_seed_write mbedtls_platform_std_nv_seed_write</span></div><div class="line"><a name="l00287"></a><span class="lineno"> 287</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00288"></a><span class="lineno"> 288</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_PLATFORM_NV_SEED_ALT */</span><span class="preprocessor"></span></div><div class="line"><a name="l00289"></a><span class="lineno"> 289</span> <span class="preprocessor">#endif </span><span class="comment">/* MBEDTLS_ENTROPY_NV_SEED */</span><span class="preprocessor"></span></div><div class="line"><a name="l00290"></a><span class="lineno"> 290</span> </div><div class="line"><a name="l00291"></a><span class="lineno"> 291</span> <span class="preprocessor">#if !defined(MBEDTLS_PLATFORM_SETUP_TEARDOWN_ALT)</span></div><div class="line"><a name="l00292"></a><span class="lineno"> 292</span> </div><div class="line"><a name="l00299"></a><span class="lineno"><a class="line" href="structmbedtls__platform__context.html"> 299</a></span> <span class="keyword">typedef</span> <span class="keyword">struct </span>{</div><div class="line"><a name="l00300"></a><span class="lineno"><a class="line" href="structmbedtls__platform__context.html#a05da2e0cbce17ebfc21036d523caff7d"> 300</a></span>  <span class="keywordtype">char</span> <a class="code" href="structmbedtls__platform__context.html#a05da2e0cbce17ebfc21036d523caff7d">dummy</a>; </div><div class="line"><a name="l00301"></a><span class="lineno"> 301</span> }</div><div class="line"><a name="l00302"></a><span class="lineno"> 302</span> <a class="code" href="structmbedtls__platform__context.html">mbedtls_platform_context</a>;</div><div class="line"><a name="l00303"></a><span class="lineno"> 303</span> </div><div class="line"><a name="l00304"></a><span class="lineno"> 304</span> <span class="preprocessor">#else</span></div><div class="line"><a name="l00305"></a><span class="lineno"> 305</span> <span class="preprocessor">#include "platform_alt.h"</span></div><div class="line"><a name="l00306"></a><span class="lineno"> 306</span> <span class="preprocessor">#endif </span><span class="comment">/* !MBEDTLS_PLATFORM_SETUP_TEARDOWN_ALT */</span><span class="preprocessor"></span></div><div class="line"><a name="l00307"></a><span class="lineno"> 307</span> </div><div class="line"><a name="l00323"></a><span class="lineno"> 323</span> <span class="keywordtype">int</span> <a class="code" href="platform_8h.html#af0f37c11be234650bec95ce37e9a4a6b">mbedtls_platform_setup</a>( <a class="code" href="structmbedtls__platform__context.html">mbedtls_platform_context</a> *ctx );</div><div class="line"><a name="l00337"></a><span class="lineno"> 337</span> <span class="keywordtype">void</span> <a class="code" href="platform_8h.html#a264d5dd442e32a262d331f8889a0997c">mbedtls_platform_teardown</a>( <a class="code" href="structmbedtls__platform__context.html">mbedtls_platform_context</a> *ctx );</div><div class="line"><a name="l00338"></a><span class="lineno"> 338</span> </div><div class="line"><a name="l00339"></a><span class="lineno"> 339</span> <span class="preprocessor">#ifdef __cplusplus</span></div><div class="line"><a name="l00340"></a><span class="lineno"> 340</span> }</div><div class="line"><a name="l00341"></a><span class="lineno"> 341</span> <span class="preprocessor">#endif</span></div><div class="line"><a name="l00342"></a><span class="lineno"> 342</span> </div><div class="line"><a name="l00343"></a><span class="lineno"> 343</span> <span class="preprocessor">#endif </span><span class="comment">/* platform.h */</span><span class="preprocessor"></span></div><div class="ttc" id="structmbedtls__platform__context_html_a05da2e0cbce17ebfc21036d523caff7d"><div class="ttname"><a href="structmbedtls__platform__context.html#a05da2e0cbce17ebfc21036d523caff7d">mbedtls_platform_context::dummy</a></div><div class="ttdeci">char dummy</div><div class="ttdoc">Placeholder member as empty structs are not portable. </div><div class="ttdef"><b>Definition:</b> <a href="platform_8h_source.html#l00300">platform.h:300</a></div></div>
<div class="ttc" id="platform_8h_html_a264d5dd442e32a262d331f8889a0997c"><div class="ttname"><a href="platform_8h.html#a264d5dd442e32a262d331f8889a0997c">mbedtls_platform_teardown</a></div><div class="ttdeci">void mbedtls_platform_teardown(mbedtls_platform_context *ctx)</div><div class="ttdoc">Perform any platform teardown operations. </div></div>
<div class="ttc" id="platform_8h_html_a4f80030b2d10f956f8ac00b57eebfbe8"><div class="ttname"><a href="platform_8h.html#a4f80030b2d10f956f8ac00b57eebfbe8">mbedtls_free</a></div><div class="ttdeci">#define mbedtls_free</div><div class="ttdef"><b>Definition:</b> <a href="platform_8h_source.html#l00129">platform.h:129</a></div></div>
<div class="ttc" id="config_8h_html"><div class="ttname"><a href="config_8h.html">config.h</a></div><div class="ttdoc">Configuration options (set of defines) </div></div>
<div class="ttc" id="platform_8h_html_a6d045f0c3699e1eac7f723054dc8b3e4"><div class="ttname"><a href="platform_8h.html#a6d045f0c3699e1eac7f723054dc8b3e4">mbedtls_fprintf</a></div><div class="ttdeci">#define mbedtls_fprintf</div><div class="ttdef"><b>Definition:</b> <a href="platform_8h_source.html#l00154">platform.h:154</a></div></div>
<div class="ttc" id="structmbedtls__platform__context_html"><div class="ttname"><a href="structmbedtls__platform__context.html">mbedtls_platform_context</a></div><div class="ttdoc">Platform context structure. </div><div class="ttdef"><b>Definition:</b> <a href="platform_8h_source.html#l00299">platform.h:299</a></div></div>
<div class="ttc" id="platform_8h_html_ac30e03304a664d7b69a23fb0ac79a426"><div class="ttname"><a href="platform_8h.html#ac30e03304a664d7b69a23fb0ac79a426">mbedtls_exit</a></div><div class="ttdeci">#define mbedtls_exit</div><div class="ttdef"><b>Definition:</b> <a href="platform_8h_source.html#l00232">platform.h:232</a></div></div>
<div class="ttc" id="platform_8h_html_a57d4faa7aee8300f544af63b9f6eed63"><div class="ttname"><a href="platform_8h.html#a57d4faa7aee8300f544af63b9f6eed63">mbedtls_snprintf</a></div><div class="ttdeci">#define mbedtls_snprintf</div><div class="ttdef"><b>Definition:</b> <a href="platform_8h_source.html#l00210">platform.h:210</a></div></div>
<div class="ttc" id="platform_8h_html_af846397815d6b78aadc6ce9bb6bc9238"><div class="ttname"><a href="platform_8h.html#af846397815d6b78aadc6ce9bb6bc9238">mbedtls_printf</a></div><div class="ttdeci">#define mbedtls_printf</div><div class="ttdef"><b>Definition:</b> <a href="platform_8h_source.html#l00176">platform.h:176</a></div></div>
<div class="ttc" id="platform_8h_html_af0f37c11be234650bec95ce37e9a4a6b"><div class="ttname"><a href="platform_8h.html#af0f37c11be234650bec95ce37e9a4a6b">mbedtls_platform_setup</a></div><div class="ttdeci">int mbedtls_platform_setup(mbedtls_platform_context *ctx)</div><div class="ttdoc">Perform any platform initialisation operations. </div></div>
<div class="ttc" id="platform__time_8h_html"><div class="ttname"><a href="platform__time_8h.html">platform_time.h</a></div><div class="ttdoc">mbed TLS Platform time abstraction </div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Thu Dec 28 2017 18:33:29 for mbed TLS v2.6.0 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>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-updates
>
by-pkgid
>
e405d5f6b10a3a92bd2c28c4aa026c70
>
files
>
491
