| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| |
| <html lang="en"> |
| |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <title>LCOV - skiboot.info - libfdt/libfdt.h</title> |
| <link rel="stylesheet" type="text/css" href="../gcov.css"> |
| </head> |
| |
| <body> |
| |
| <table width="100%" border=0 cellspacing=0 cellpadding=0> |
| <tr><td class="title">LCOV - code coverage report</td></tr> |
| <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr> |
| |
| <tr> |
| <td width="100%"> |
| <table cellpadding=1 border=0 width="100%"> |
| <tr> |
| <td width="10%" class="headerItem">Current view:</td> |
| <td width="10%" class="headerValue"><a href="../index.html">top level</a> - <a href="index.html">libfdt</a> - libfdt.h<span style="font-size: 80%;"> (source / <a href="libfdt.h.func-c.html">functions</a>)</span></td> |
| <td width="5%"></td> |
| <td width="5%"></td> |
| <td width="5%" class="headerCovTableHead">Coverage</td> |
| <td width="5%" class="headerCovTableHead" title="Covered + Uncovered code">Total</td> |
| <td width="5%" class="headerCovTableHead" title="Exercised code only">Hit</td> |
| </tr> |
| <tr> |
| <td class="headerItem">Test:</td> |
| <td class="headerValue">skiboot.info</td> |
| <td></td> |
| <td class="headerItem">Lines:</td> |
| <td class="headerCovTableEntryHi">100.0 %</td> |
| <td class="headerCovTableEntry">20</td> |
| <td class="headerCovTableEntry">20</td> |
| </tr> |
| <tr> |
| <td class="headerItem">Test Date:</td> |
| <td class="headerValue">2025-06-27 16:54:26</td> |
| <td></td> |
| <td class="headerItem">Functions:</td> |
| <td class="headerCovTableEntryHi">100.0 %</td> |
| <td class="headerCovTableEntry">12</td> |
| <td class="headerCovTableEntry">12</td> |
| </tr> |
| <tr> |
| <td></td> |
| <td></td> |
| <td></td> |
| <td class="headerItem">Branches:</td> |
| <td class="headerCovTableEntryHi">-</td> |
| <td class="headerCovTableEntry">0</td> |
| <td class="headerCovTableEntry">0</td> |
| </tr> |
| <tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr> |
| </table> |
| </td> |
| </tr> |
| |
| <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr> |
| </table> |
| |
| <table cellpadding=0 cellspacing=0 border=0> |
| <tr> |
| <td><br></td> |
| </tr> |
| <tr> |
| <td> |
| <pre class="sourceHeading"> Branch data Line data Source code</pre> |
| <pre class="source"> |
| <span id="L1"><span class="lineNum"> 1</span> : : /* SPDX-License-Identifier: (GPL-2.0-or-later OR BSD-2-Clause) */</span> |
| <span id="L2"><span class="lineNum"> 2</span> : : #ifndef LIBFDT_H</span> |
| <span id="L3"><span class="lineNum"> 3</span> : : #define LIBFDT_H</span> |
| <span id="L4"><span class="lineNum"> 4</span> : : /*</span> |
| <span id="L5"><span class="lineNum"> 5</span> : : * libfdt - Flat Device Tree manipulation</span> |
| <span id="L6"><span class="lineNum"> 6</span> : : * Copyright (C) 2006 David Gibson, IBM Corporation.</span> |
| <span id="L7"><span class="lineNum"> 7</span> : : */</span> |
| <span id="L8"><span class="lineNum"> 8</span> : : </span> |
| <span id="L9"><span class="lineNum"> 9</span> : : #include <libfdt_env.h></span> |
| <span id="L10"><span class="lineNum"> 10</span> : : #include <fdt.h></span> |
| <span id="L11"><span class="lineNum"> 11</span> : : </span> |
| <span id="L12"><span class="lineNum"> 12</span> : : #ifdef __cplusplus</span> |
| <span id="L13"><span class="lineNum"> 13</span> : : extern "C" {</span> |
| <span id="L14"><span class="lineNum"> 14</span> : : #endif</span> |
| <span id="L15"><span class="lineNum"> 15</span> : : </span> |
| <span id="L16"><span class="lineNum"> 16</span> : : #define FDT_FIRST_SUPPORTED_VERSION 0x02</span> |
| <span id="L17"><span class="lineNum"> 17</span> : : #define FDT_LAST_COMPATIBLE_VERSION 0x10</span> |
| <span id="L18"><span class="lineNum"> 18</span> : : #define FDT_LAST_SUPPORTED_VERSION 0x11</span> |
| <span id="L19"><span class="lineNum"> 19</span> : : </span> |
| <span id="L20"><span class="lineNum"> 20</span> : : /* Error codes: informative error codes */</span> |
| <span id="L21"><span class="lineNum"> 21</span> : : #define FDT_ERR_NOTFOUND 1</span> |
| <span id="L22"><span class="lineNum"> 22</span> : : /* FDT_ERR_NOTFOUND: The requested node or property does not exist */</span> |
| <span id="L23"><span class="lineNum"> 23</span> : : #define FDT_ERR_EXISTS 2</span> |
| <span id="L24"><span class="lineNum"> 24</span> : : /* FDT_ERR_EXISTS: Attempted to create a node or property which</span> |
| <span id="L25"><span class="lineNum"> 25</span> : : * already exists */</span> |
| <span id="L26"><span class="lineNum"> 26</span> : : #define FDT_ERR_NOSPACE 3</span> |
| <span id="L27"><span class="lineNum"> 27</span> : : /* FDT_ERR_NOSPACE: Operation needed to expand the device</span> |
| <span id="L28"><span class="lineNum"> 28</span> : : * tree, but its buffer did not have sufficient space to</span> |
| <span id="L29"><span class="lineNum"> 29</span> : : * contain the expanded tree. Use fdt_open_into() to move the</span> |
| <span id="L30"><span class="lineNum"> 30</span> : : * device tree to a buffer with more space. */</span> |
| <span id="L31"><span class="lineNum"> 31</span> : : </span> |
| <span id="L32"><span class="lineNum"> 32</span> : : /* Error codes: codes for bad parameters */</span> |
| <span id="L33"><span class="lineNum"> 33</span> : : #define FDT_ERR_BADOFFSET 4</span> |
| <span id="L34"><span class="lineNum"> 34</span> : : /* FDT_ERR_BADOFFSET: Function was passed a structure block</span> |
| <span id="L35"><span class="lineNum"> 35</span> : : * offset which is out-of-bounds, or which points to an</span> |
| <span id="L36"><span class="lineNum"> 36</span> : : * unsuitable part of the structure for the operation. */</span> |
| <span id="L37"><span class="lineNum"> 37</span> : : #define FDT_ERR_BADPATH 5</span> |
| <span id="L38"><span class="lineNum"> 38</span> : : /* FDT_ERR_BADPATH: Function was passed a badly formatted path</span> |
| <span id="L39"><span class="lineNum"> 39</span> : : * (e.g. missing a leading / for a function which requires an</span> |
| <span id="L40"><span class="lineNum"> 40</span> : : * absolute path) */</span> |
| <span id="L41"><span class="lineNum"> 41</span> : : #define FDT_ERR_BADPHANDLE 6</span> |
| <span id="L42"><span class="lineNum"> 42</span> : : /* FDT_ERR_BADPHANDLE: Function was passed an invalid phandle.</span> |
| <span id="L43"><span class="lineNum"> 43</span> : : * This can be caused either by an invalid phandle property</span> |
| <span id="L44"><span class="lineNum"> 44</span> : : * length, or the phandle value was either 0 or -1, which are</span> |
| <span id="L45"><span class="lineNum"> 45</span> : : * not permitted. */</span> |
| <span id="L46"><span class="lineNum"> 46</span> : : #define FDT_ERR_BADSTATE 7</span> |
| <span id="L47"><span class="lineNum"> 47</span> : : /* FDT_ERR_BADSTATE: Function was passed an incomplete device</span> |
| <span id="L48"><span class="lineNum"> 48</span> : : * tree created by the sequential-write functions, which is</span> |
| <span id="L49"><span class="lineNum"> 49</span> : : * not sufficiently complete for the requested operation. */</span> |
| <span id="L50"><span class="lineNum"> 50</span> : : </span> |
| <span id="L51"><span class="lineNum"> 51</span> : : /* Error codes: codes for bad device tree blobs */</span> |
| <span id="L52"><span class="lineNum"> 52</span> : : #define FDT_ERR_TRUNCATED 8</span> |
| <span id="L53"><span class="lineNum"> 53</span> : : /* FDT_ERR_TRUNCATED: FDT or a sub-block is improperly</span> |
| <span id="L54"><span class="lineNum"> 54</span> : : * terminated (overflows, goes outside allowed bounds, or</span> |
| <span id="L55"><span class="lineNum"> 55</span> : : * isn't properly terminated). */</span> |
| <span id="L56"><span class="lineNum"> 56</span> : : #define FDT_ERR_BADMAGIC 9</span> |
| <span id="L57"><span class="lineNum"> 57</span> : : /* FDT_ERR_BADMAGIC: Given "device tree" appears not to be a</span> |
| <span id="L58"><span class="lineNum"> 58</span> : : * device tree at all - it is missing the flattened device</span> |
| <span id="L59"><span class="lineNum"> 59</span> : : * tree magic number. */</span> |
| <span id="L60"><span class="lineNum"> 60</span> : : #define FDT_ERR_BADVERSION 10</span> |
| <span id="L61"><span class="lineNum"> 61</span> : : /* FDT_ERR_BADVERSION: Given device tree has a version which</span> |
| <span id="L62"><span class="lineNum"> 62</span> : : * can't be handled by the requested operation. For</span> |
| <span id="L63"><span class="lineNum"> 63</span> : : * read-write functions, this may mean that fdt_open_into() is</span> |
| <span id="L64"><span class="lineNum"> 64</span> : : * required to convert the tree to the expected version. */</span> |
| <span id="L65"><span class="lineNum"> 65</span> : : #define FDT_ERR_BADSTRUCTURE 11</span> |
| <span id="L66"><span class="lineNum"> 66</span> : : /* FDT_ERR_BADSTRUCTURE: Given device tree has a corrupt</span> |
| <span id="L67"><span class="lineNum"> 67</span> : : * structure block or other serious error (e.g. misnested</span> |
| <span id="L68"><span class="lineNum"> 68</span> : : * nodes, or subnodes preceding properties). */</span> |
| <span id="L69"><span class="lineNum"> 69</span> : : #define FDT_ERR_BADLAYOUT 12</span> |
| <span id="L70"><span class="lineNum"> 70</span> : : /* FDT_ERR_BADLAYOUT: For read-write functions, the given</span> |
| <span id="L71"><span class="lineNum"> 71</span> : : * device tree has it's sub-blocks in an order that the</span> |
| <span id="L72"><span class="lineNum"> 72</span> : : * function can't handle (memory reserve map, then structure,</span> |
| <span id="L73"><span class="lineNum"> 73</span> : : * then strings). Use fdt_open_into() to reorganize the tree</span> |
| <span id="L74"><span class="lineNum"> 74</span> : : * into a form suitable for the read-write operations. */</span> |
| <span id="L75"><span class="lineNum"> 75</span> : : </span> |
| <span id="L76"><span class="lineNum"> 76</span> : : /* "Can't happen" error indicating a bug in libfdt */</span> |
| <span id="L77"><span class="lineNum"> 77</span> : : #define FDT_ERR_INTERNAL 13</span> |
| <span id="L78"><span class="lineNum"> 78</span> : : /* FDT_ERR_INTERNAL: libfdt has failed an internal assertion.</span> |
| <span id="L79"><span class="lineNum"> 79</span> : : * Should never be returned, if it is, it indicates a bug in</span> |
| <span id="L80"><span class="lineNum"> 80</span> : : * libfdt itself. */</span> |
| <span id="L81"><span class="lineNum"> 81</span> : : </span> |
| <span id="L82"><span class="lineNum"> 82</span> : : /* Errors in device tree content */</span> |
| <span id="L83"><span class="lineNum"> 83</span> : : #define FDT_ERR_BADNCELLS 14</span> |
| <span id="L84"><span class="lineNum"> 84</span> : : /* FDT_ERR_BADNCELLS: Device tree has a #address-cells, #size-cells</span> |
| <span id="L85"><span class="lineNum"> 85</span> : : * or similar property with a bad format or value */</span> |
| <span id="L86"><span class="lineNum"> 86</span> : : </span> |
| <span id="L87"><span class="lineNum"> 87</span> : : #define FDT_ERR_BADVALUE 15</span> |
| <span id="L88"><span class="lineNum"> 88</span> : : /* FDT_ERR_BADVALUE: Device tree has a property with an unexpected</span> |
| <span id="L89"><span class="lineNum"> 89</span> : : * value. For example: a property expected to contain a string list</span> |
| <span id="L90"><span class="lineNum"> 90</span> : : * is not NUL-terminated within the length of its value. */</span> |
| <span id="L91"><span class="lineNum"> 91</span> : : </span> |
| <span id="L92"><span class="lineNum"> 92</span> : : #define FDT_ERR_BADOVERLAY 16</span> |
| <span id="L93"><span class="lineNum"> 93</span> : : /* FDT_ERR_BADOVERLAY: The device tree overlay, while</span> |
| <span id="L94"><span class="lineNum"> 94</span> : : * correctly structured, cannot be applied due to some</span> |
| <span id="L95"><span class="lineNum"> 95</span> : : * unexpected or missing value, property or node. */</span> |
| <span id="L96"><span class="lineNum"> 96</span> : : </span> |
| <span id="L97"><span class="lineNum"> 97</span> : : #define FDT_ERR_NOPHANDLES 17</span> |
| <span id="L98"><span class="lineNum"> 98</span> : : /* FDT_ERR_NOPHANDLES: The device tree doesn't have any</span> |
| <span id="L99"><span class="lineNum"> 99</span> : : * phandle available anymore without causing an overflow */</span> |
| <span id="L100"><span class="lineNum"> 100</span> : : </span> |
| <span id="L101"><span class="lineNum"> 101</span> : : #define FDT_ERR_BADFLAGS 18</span> |
| <span id="L102"><span class="lineNum"> 102</span> : : /* FDT_ERR_BADFLAGS: The function was passed a flags field that</span> |
| <span id="L103"><span class="lineNum"> 103</span> : : * contains invalid flags or an invalid combination of flags. */</span> |
| <span id="L104"><span class="lineNum"> 104</span> : : </span> |
| <span id="L105"><span class="lineNum"> 105</span> : : #define FDT_ERR_ALIGNMENT 19</span> |
| <span id="L106"><span class="lineNum"> 106</span> : : /* FDT_ERR_ALIGNMENT: The device tree base address is not 8-byte</span> |
| <span id="L107"><span class="lineNum"> 107</span> : : * aligned. */</span> |
| <span id="L108"><span class="lineNum"> 108</span> : : </span> |
| <span id="L109"><span class="lineNum"> 109</span> : : #define FDT_ERR_MAX 19</span> |
| <span id="L110"><span class="lineNum"> 110</span> : : </span> |
| <span id="L111"><span class="lineNum"> 111</span> : : /* constants */</span> |
| <span id="L112"><span class="lineNum"> 112</span> : : #define FDT_MAX_PHANDLE 0xfffffffe</span> |
| <span id="L113"><span class="lineNum"> 113</span> : : /* Valid values for phandles range from 1 to 2^32-2. */</span> |
| <span id="L114"><span class="lineNum"> 114</span> : : </span> |
| <span id="L115"><span class="lineNum"> 115</span> : : /**********************************************************************/</span> |
| <span id="L116"><span class="lineNum"> 116</span> : : /* Low-level functions (you probably don't need these) */</span> |
| <span id="L117"><span class="lineNum"> 117</span> : : /**********************************************************************/</span> |
| <span id="L118"><span class="lineNum"> 118</span> : : </span> |
| <span id="L119"><span class="lineNum"> 119</span> : : #ifndef SWIG /* This function is not useful in Python */</span> |
| <span id="L120"><span class="lineNum"> 120</span> : : const void *fdt_offset_ptr(const void *fdt, int offset, unsigned int checklen);</span> |
| <span id="L121"><span class="lineNum"> 121</span> : : #endif</span> |
| <span id="L122"><span class="lineNum"> 122</span> : : static inline void *fdt_offset_ptr_w(void *fdt, int offset, int checklen)</span> |
| <span id="L123"><span class="lineNum"> 123</span> : : {</span> |
| <span id="L124"><span class="lineNum"> 124</span> : : return (void *)(uintptr_t)fdt_offset_ptr(fdt, offset, checklen);</span> |
| <span id="L125"><span class="lineNum"> 125</span> : : }</span> |
| <span id="L126"><span class="lineNum"> 126</span> : : </span> |
| <span id="L127"><span class="lineNum"> 127</span> : : uint32_t fdt_next_tag(const void *fdt, int offset, int *nextoffset);</span> |
| <span id="L128"><span class="lineNum"> 128</span> : : </span> |
| <span id="L129"><span class="lineNum"> 129</span> : : /*</span> |
| <span id="L130"><span class="lineNum"> 130</span> : : * External helpers to access words from a device tree blob. They're built</span> |
| <span id="L131"><span class="lineNum"> 131</span> : : * to work even with unaligned pointers on platforms (such as ARMv5) that don't</span> |
| <span id="L132"><span class="lineNum"> 132</span> : : * like unaligned loads and stores.</span> |
| <span id="L133"><span class="lineNum"> 133</span> : : */</span> |
| <span id="L134"><span class="lineNum"> 134</span> : : static inline uint16_t fdt16_ld(const fdt16_t *p)</span> |
| <span id="L135"><span class="lineNum"> 135</span> : : {</span> |
| <span id="L136"><span class="lineNum"> 136</span> : : const uint8_t *bp = (const uint8_t *)p;</span> |
| <span id="L137"><span class="lineNum"> 137</span> : : </span> |
| <span id="L138"><span class="lineNum"> 138</span> : : return ((uint16_t)bp[0] << 8) | bp[1];</span> |
| <span id="L139"><span class="lineNum"> 139</span> : : }</span> |
| <span id="L140"><span class="lineNum"> 140</span> : : </span> |
| <span id="L141"><span class="lineNum"> 141</span> :<span class="tlaGNC tlaBgGNC"> 39510 : static inline uint32_t fdt32_ld(const fdt32_t *p)</span></span> |
| <span id="L142"><span class="lineNum"> 142</span> : : {</span> |
| <span id="L143"><span class="lineNum"> 143</span> :<span class="tlaGNC"> 39510 : const uint8_t *bp = (const uint8_t *)p;</span></span> |
| <span id="L144"><span class="lineNum"> 144</span> : : </span> |
| <span id="L145"><span class="lineNum"> 145</span> :<span class="tlaGNC"> 39510 : return ((uint32_t)bp[0] << 24)</span></span> |
| <span id="L146"><span class="lineNum"> 146</span> :<span class="tlaGNC"> 39510 : | ((uint32_t)bp[1] << 16)</span></span> |
| <span id="L147"><span class="lineNum"> 147</span> :<span class="tlaGNC"> 39510 : | ((uint32_t)bp[2] << 8)</span></span> |
| <span id="L148"><span class="lineNum"> 148</span> :<span class="tlaGNC"> 39510 : | bp[3];</span></span> |
| <span id="L149"><span class="lineNum"> 149</span> : : }</span> |
| <span id="L150"><span class="lineNum"> 150</span> : : </span> |
| <span id="L151"><span class="lineNum"> 151</span> : : static inline void fdt32_st(void *property, uint32_t value)</span> |
| <span id="L152"><span class="lineNum"> 152</span> : : {</span> |
| <span id="L153"><span class="lineNum"> 153</span> : : uint8_t *bp = (uint8_t *)property;</span> |
| <span id="L154"><span class="lineNum"> 154</span> : : </span> |
| <span id="L155"><span class="lineNum"> 155</span> : : bp[0] = value >> 24;</span> |
| <span id="L156"><span class="lineNum"> 156</span> : : bp[1] = (value >> 16) & 0xff;</span> |
| <span id="L157"><span class="lineNum"> 157</span> : : bp[2] = (value >> 8) & 0xff;</span> |
| <span id="L158"><span class="lineNum"> 158</span> : : bp[3] = value & 0xff;</span> |
| <span id="L159"><span class="lineNum"> 159</span> : : }</span> |
| <span id="L160"><span class="lineNum"> 160</span> : : </span> |
| <span id="L161"><span class="lineNum"> 161</span> : : static inline uint64_t fdt64_ld(const fdt64_t *p)</span> |
| <span id="L162"><span class="lineNum"> 162</span> : : {</span> |
| <span id="L163"><span class="lineNum"> 163</span> : : const uint8_t *bp = (const uint8_t *)p;</span> |
| <span id="L164"><span class="lineNum"> 164</span> : : </span> |
| <span id="L165"><span class="lineNum"> 165</span> : : return ((uint64_t)bp[0] << 56)</span> |
| <span id="L166"><span class="lineNum"> 166</span> : : | ((uint64_t)bp[1] << 48)</span> |
| <span id="L167"><span class="lineNum"> 167</span> : : | ((uint64_t)bp[2] << 40)</span> |
| <span id="L168"><span class="lineNum"> 168</span> : : | ((uint64_t)bp[3] << 32)</span> |
| <span id="L169"><span class="lineNum"> 169</span> : : | ((uint64_t)bp[4] << 24)</span> |
| <span id="L170"><span class="lineNum"> 170</span> : : | ((uint64_t)bp[5] << 16)</span> |
| <span id="L171"><span class="lineNum"> 171</span> : : | ((uint64_t)bp[6] << 8)</span> |
| <span id="L172"><span class="lineNum"> 172</span> : : | bp[7];</span> |
| <span id="L173"><span class="lineNum"> 173</span> : : }</span> |
| <span id="L174"><span class="lineNum"> 174</span> : : </span> |
| <span id="L175"><span class="lineNum"> 175</span> : : static inline void fdt64_st(void *property, uint64_t value)</span> |
| <span id="L176"><span class="lineNum"> 176</span> : : {</span> |
| <span id="L177"><span class="lineNum"> 177</span> : : uint8_t *bp = (uint8_t *)property;</span> |
| <span id="L178"><span class="lineNum"> 178</span> : : </span> |
| <span id="L179"><span class="lineNum"> 179</span> : : bp[0] = value >> 56;</span> |
| <span id="L180"><span class="lineNum"> 180</span> : : bp[1] = (value >> 48) & 0xff;</span> |
| <span id="L181"><span class="lineNum"> 181</span> : : bp[2] = (value >> 40) & 0xff;</span> |
| <span id="L182"><span class="lineNum"> 182</span> : : bp[3] = (value >> 32) & 0xff;</span> |
| <span id="L183"><span class="lineNum"> 183</span> : : bp[4] = (value >> 24) & 0xff;</span> |
| <span id="L184"><span class="lineNum"> 184</span> : : bp[5] = (value >> 16) & 0xff;</span> |
| <span id="L185"><span class="lineNum"> 185</span> : : bp[6] = (value >> 8) & 0xff;</span> |
| <span id="L186"><span class="lineNum"> 186</span> : : bp[7] = value & 0xff;</span> |
| <span id="L187"><span class="lineNum"> 187</span> : : }</span> |
| <span id="L188"><span class="lineNum"> 188</span> : : </span> |
| <span id="L189"><span class="lineNum"> 189</span> : : /**********************************************************************/</span> |
| <span id="L190"><span class="lineNum"> 190</span> : : /* Traversal functions */</span> |
| <span id="L191"><span class="lineNum"> 191</span> : : /**********************************************************************/</span> |
| <span id="L192"><span class="lineNum"> 192</span> : : </span> |
| <span id="L193"><span class="lineNum"> 193</span> : : int fdt_next_node(const void *fdt, int offset, int *depth);</span> |
| <span id="L194"><span class="lineNum"> 194</span> : : </span> |
| <span id="L195"><span class="lineNum"> 195</span> : : /**</span> |
| <span id="L196"><span class="lineNum"> 196</span> : : * fdt_first_subnode() - get offset of first direct subnode</span> |
| <span id="L197"><span class="lineNum"> 197</span> : : * @fdt: FDT blob</span> |
| <span id="L198"><span class="lineNum"> 198</span> : : * @offset: Offset of node to check</span> |
| <span id="L199"><span class="lineNum"> 199</span> : : *</span> |
| <span id="L200"><span class="lineNum"> 200</span> : : * Return: offset of first subnode, or -FDT_ERR_NOTFOUND if there is none</span> |
| <span id="L201"><span class="lineNum"> 201</span> : : */</span> |
| <span id="L202"><span class="lineNum"> 202</span> : : int fdt_first_subnode(const void *fdt, int offset);</span> |
| <span id="L203"><span class="lineNum"> 203</span> : : </span> |
| <span id="L204"><span class="lineNum"> 204</span> : : /**</span> |
| <span id="L205"><span class="lineNum"> 205</span> : : * fdt_next_subnode() - get offset of next direct subnode</span> |
| <span id="L206"><span class="lineNum"> 206</span> : : * @fdt: FDT blob</span> |
| <span id="L207"><span class="lineNum"> 207</span> : : * @offset: Offset of previous subnode</span> |
| <span id="L208"><span class="lineNum"> 208</span> : : *</span> |
| <span id="L209"><span class="lineNum"> 209</span> : : * After first calling fdt_first_subnode(), call this function repeatedly to</span> |
| <span id="L210"><span class="lineNum"> 210</span> : : * get direct subnodes of a parent node.</span> |
| <span id="L211"><span class="lineNum"> 211</span> : : *</span> |
| <span id="L212"><span class="lineNum"> 212</span> : : * Return: offset of next subnode, or -FDT_ERR_NOTFOUND if there are no more</span> |
| <span id="L213"><span class="lineNum"> 213</span> : : * subnodes</span> |
| <span id="L214"><span class="lineNum"> 214</span> : : */</span> |
| <span id="L215"><span class="lineNum"> 215</span> : : int fdt_next_subnode(const void *fdt, int offset);</span> |
| <span id="L216"><span class="lineNum"> 216</span> : : </span> |
| <span id="L217"><span class="lineNum"> 217</span> : : /**</span> |
| <span id="L218"><span class="lineNum"> 218</span> : : * fdt_for_each_subnode - iterate over all subnodes of a parent</span> |
| <span id="L219"><span class="lineNum"> 219</span> : : *</span> |
| <span id="L220"><span class="lineNum"> 220</span> : : * @node: child node (int, lvalue)</span> |
| <span id="L221"><span class="lineNum"> 221</span> : : * @fdt: FDT blob (const void *)</span> |
| <span id="L222"><span class="lineNum"> 222</span> : : * @parent: parent node (int)</span> |
| <span id="L223"><span class="lineNum"> 223</span> : : *</span> |
| <span id="L224"><span class="lineNum"> 224</span> : : * This is actually a wrapper around a for loop and would be used like so:</span> |
| <span id="L225"><span class="lineNum"> 225</span> : : *</span> |
| <span id="L226"><span class="lineNum"> 226</span> : : * fdt_for_each_subnode(node, fdt, parent) {</span> |
| <span id="L227"><span class="lineNum"> 227</span> : : * Use node</span> |
| <span id="L228"><span class="lineNum"> 228</span> : : * ...</span> |
| <span id="L229"><span class="lineNum"> 229</span> : : * }</span> |
| <span id="L230"><span class="lineNum"> 230</span> : : *</span> |
| <span id="L231"><span class="lineNum"> 231</span> : : * if ((node < 0) && (node != -FDT_ERR_NOTFOUND)) {</span> |
| <span id="L232"><span class="lineNum"> 232</span> : : * Error handling</span> |
| <span id="L233"><span class="lineNum"> 233</span> : : * }</span> |
| <span id="L234"><span class="lineNum"> 234</span> : : *</span> |
| <span id="L235"><span class="lineNum"> 235</span> : : * Note that this is implemented as a macro and @node is used as</span> |
| <span id="L236"><span class="lineNum"> 236</span> : : * iterator in the loop. The parent variable be constant or even a</span> |
| <span id="L237"><span class="lineNum"> 237</span> : : * literal.</span> |
| <span id="L238"><span class="lineNum"> 238</span> : : */</span> |
| <span id="L239"><span class="lineNum"> 239</span> : : #define fdt_for_each_subnode(node, fdt, parent) \</span> |
| <span id="L240"><span class="lineNum"> 240</span> : : for (node = fdt_first_subnode(fdt, parent); \</span> |
| <span id="L241"><span class="lineNum"> 241</span> : : node >= 0; \</span> |
| <span id="L242"><span class="lineNum"> 242</span> : : node = fdt_next_subnode(fdt, node))</span> |
| <span id="L243"><span class="lineNum"> 243</span> : : </span> |
| <span id="L244"><span class="lineNum"> 244</span> : : /**********************************************************************/</span> |
| <span id="L245"><span class="lineNum"> 245</span> : : /* General functions */</span> |
| <span id="L246"><span class="lineNum"> 246</span> : : /**********************************************************************/</span> |
| <span id="L247"><span class="lineNum"> 247</span> : : #define fdt_get_header(fdt, field) \</span> |
| <span id="L248"><span class="lineNum"> 248</span> : : (fdt32_ld(&((const struct fdt_header *)(fdt))->field))</span> |
| <span id="L249"><span class="lineNum"> 249</span> : : #define fdt_magic(fdt) (fdt_get_header(fdt, magic))</span> |
| <span id="L250"><span class="lineNum"> 250</span> : : #define fdt_totalsize(fdt) (fdt_get_header(fdt, totalsize))</span> |
| <span id="L251"><span class="lineNum"> 251</span> : : #define fdt_off_dt_struct(fdt) (fdt_get_header(fdt, off_dt_struct))</span> |
| <span id="L252"><span class="lineNum"> 252</span> : : #define fdt_off_dt_strings(fdt) (fdt_get_header(fdt, off_dt_strings))</span> |
| <span id="L253"><span class="lineNum"> 253</span> : : #define fdt_off_mem_rsvmap(fdt) (fdt_get_header(fdt, off_mem_rsvmap))</span> |
| <span id="L254"><span class="lineNum"> 254</span> : : #define fdt_version(fdt) (fdt_get_header(fdt, version))</span> |
| <span id="L255"><span class="lineNum"> 255</span> : : #define fdt_last_comp_version(fdt) (fdt_get_header(fdt, last_comp_version))</span> |
| <span id="L256"><span class="lineNum"> 256</span> : : #define fdt_boot_cpuid_phys(fdt) (fdt_get_header(fdt, boot_cpuid_phys))</span> |
| <span id="L257"><span class="lineNum"> 257</span> : : #define fdt_size_dt_strings(fdt) (fdt_get_header(fdt, size_dt_strings))</span> |
| <span id="L258"><span class="lineNum"> 258</span> : : #define fdt_size_dt_struct(fdt) (fdt_get_header(fdt, size_dt_struct))</span> |
| <span id="L259"><span class="lineNum"> 259</span> : : </span> |
| <span id="L260"><span class="lineNum"> 260</span> : : #define fdt_set_hdr_(name) \</span> |
| <span id="L261"><span class="lineNum"> 261</span> : : static inline void fdt_set_##name(void *fdt, uint32_t val) \</span> |
| <span id="L262"><span class="lineNum"> 262</span> : : { \</span> |
| <span id="L263"><span class="lineNum"> 263</span> : : struct fdt_header *fdth = (struct fdt_header *)fdt; \</span> |
| <span id="L264"><span class="lineNum"> 264</span> : : fdth->name = cpu_to_fdt32(val); \</span> |
| <span id="L265"><span class="lineNum"> 265</span> : : }</span> |
| <span id="L266"><span class="lineNum"> 266</span> :<span class="tlaGNC"> 2 : fdt_set_hdr_(magic);</span></span> |
| <span id="L267"><span class="lineNum"> 267</span> :<span class="tlaGNC"> 2 : fdt_set_hdr_(totalsize);</span></span> |
| <span id="L268"><span class="lineNum"> 268</span> :<span class="tlaGNC"> 5 : fdt_set_hdr_(off_dt_struct);</span></span> |
| <span id="L269"><span class="lineNum"> 269</span> :<span class="tlaGNC"> 3 : fdt_set_hdr_(off_dt_strings);</span></span> |
| <span id="L270"><span class="lineNum"> 270</span> :<span class="tlaGNC"> 1 : fdt_set_hdr_(off_mem_rsvmap);</span></span> |
| <span id="L271"><span class="lineNum"> 271</span> :<span class="tlaGNC"> 1 : fdt_set_hdr_(version);</span></span> |
| <span id="L272"><span class="lineNum"> 272</span> :<span class="tlaGNC"> 2 : fdt_set_hdr_(last_comp_version);</span></span> |
| <span id="L273"><span class="lineNum"> 273</span> : : fdt_set_hdr_(boot_cpuid_phys);</span> |
| <span id="L274"><span class="lineNum"> 274</span> :<span class="tlaGNC"> 99 : fdt_set_hdr_(size_dt_strings);</span></span> |
| <span id="L275"><span class="lineNum"> 275</span> :<span class="tlaGNC"> 1007 : fdt_set_hdr_(size_dt_struct);</span></span> |
| <span id="L276"><span class="lineNum"> 276</span> : : #undef fdt_set_hdr_</span> |
| <span id="L277"><span class="lineNum"> 277</span> : : </span> |
| <span id="L278"><span class="lineNum"> 278</span> : : /**</span> |
| <span id="L279"><span class="lineNum"> 279</span> : : * fdt_header_size - return the size of the tree's header</span> |
| <span id="L280"><span class="lineNum"> 280</span> : : * @fdt: pointer to a flattened device tree</span> |
| <span id="L281"><span class="lineNum"> 281</span> : : *</span> |
| <span id="L282"><span class="lineNum"> 282</span> : : * Return: size of DTB header in bytes</span> |
| <span id="L283"><span class="lineNum"> 283</span> : : */</span> |
| <span id="L284"><span class="lineNum"> 284</span> : : size_t fdt_header_size(const void *fdt);</span> |
| <span id="L285"><span class="lineNum"> 285</span> : : </span> |
| <span id="L286"><span class="lineNum"> 286</span> : : /**</span> |
| <span id="L287"><span class="lineNum"> 287</span> : : * fdt_header_size_ - internal function to get header size from a version number</span> |
| <span id="L288"><span class="lineNum"> 288</span> : : * @version: devicetree version number</span> |
| <span id="L289"><span class="lineNum"> 289</span> : : *</span> |
| <span id="L290"><span class="lineNum"> 290</span> : : * Return: size of DTB header in bytes</span> |
| <span id="L291"><span class="lineNum"> 291</span> : : */</span> |
| <span id="L292"><span class="lineNum"> 292</span> : : size_t fdt_header_size_(uint32_t version);</span> |
| <span id="L293"><span class="lineNum"> 293</span> : : </span> |
| <span id="L294"><span class="lineNum"> 294</span> : : /**</span> |
| <span id="L295"><span class="lineNum"> 295</span> : : * fdt_check_header - sanity check a device tree header</span> |
| <span id="L296"><span class="lineNum"> 296</span> : : * @fdt: pointer to data which might be a flattened device tree</span> |
| <span id="L297"><span class="lineNum"> 297</span> : : *</span> |
| <span id="L298"><span class="lineNum"> 298</span> : : * fdt_check_header() checks that the given buffer contains what</span> |
| <span id="L299"><span class="lineNum"> 299</span> : : * appears to be a flattened device tree, and that the header contains</span> |
| <span id="L300"><span class="lineNum"> 300</span> : : * valid information (to the extent that can be determined from the</span> |
| <span id="L301"><span class="lineNum"> 301</span> : : * header alone).</span> |
| <span id="L302"><span class="lineNum"> 302</span> : : *</span> |
| <span id="L303"><span class="lineNum"> 303</span> : : * returns:</span> |
| <span id="L304"><span class="lineNum"> 304</span> : : * 0, if the buffer appears to contain a valid device tree</span> |
| <span id="L305"><span class="lineNum"> 305</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L306"><span class="lineNum"> 306</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L307"><span class="lineNum"> 307</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L308"><span class="lineNum"> 308</span> : : * -FDT_ERR_TRUNCATED, standard meanings, as above</span> |
| <span id="L309"><span class="lineNum"> 309</span> : : */</span> |
| <span id="L310"><span class="lineNum"> 310</span> : : int fdt_check_header(const void *fdt);</span> |
| <span id="L311"><span class="lineNum"> 311</span> : : </span> |
| <span id="L312"><span class="lineNum"> 312</span> : : /**</span> |
| <span id="L313"><span class="lineNum"> 313</span> : : * fdt_move - move a device tree around in memory</span> |
| <span id="L314"><span class="lineNum"> 314</span> : : * @fdt: pointer to the device tree to move</span> |
| <span id="L315"><span class="lineNum"> 315</span> : : * @buf: pointer to memory where the device is to be moved</span> |
| <span id="L316"><span class="lineNum"> 316</span> : : * @bufsize: size of the memory space at buf</span> |
| <span id="L317"><span class="lineNum"> 317</span> : : *</span> |
| <span id="L318"><span class="lineNum"> 318</span> : : * fdt_move() relocates, if possible, the device tree blob located at</span> |
| <span id="L319"><span class="lineNum"> 319</span> : : * fdt to the buffer at buf of size bufsize. The buffer may overlap</span> |
| <span id="L320"><span class="lineNum"> 320</span> : : * with the existing device tree blob at fdt. Therefore,</span> |
| <span id="L321"><span class="lineNum"> 321</span> : : * fdt_move(fdt, fdt, fdt_totalsize(fdt))</span> |
| <span id="L322"><span class="lineNum"> 322</span> : : * should always succeed.</span> |
| <span id="L323"><span class="lineNum"> 323</span> : : *</span> |
| <span id="L324"><span class="lineNum"> 324</span> : : * returns:</span> |
| <span id="L325"><span class="lineNum"> 325</span> : : * 0, on success</span> |
| <span id="L326"><span class="lineNum"> 326</span> : : * -FDT_ERR_NOSPACE, bufsize is insufficient to contain the device tree</span> |
| <span id="L327"><span class="lineNum"> 327</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L328"><span class="lineNum"> 328</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L329"><span class="lineNum"> 329</span> : : * -FDT_ERR_BADSTATE, standard meanings</span> |
| <span id="L330"><span class="lineNum"> 330</span> : : */</span> |
| <span id="L331"><span class="lineNum"> 331</span> : : int fdt_move(const void *fdt, void *buf, int bufsize);</span> |
| <span id="L332"><span class="lineNum"> 332</span> : : </span> |
| <span id="L333"><span class="lineNum"> 333</span> : : /**********************************************************************/</span> |
| <span id="L334"><span class="lineNum"> 334</span> : : /* Read-only functions */</span> |
| <span id="L335"><span class="lineNum"> 335</span> : : /**********************************************************************/</span> |
| <span id="L336"><span class="lineNum"> 336</span> : : </span> |
| <span id="L337"><span class="lineNum"> 337</span> : : int fdt_check_full(const void *fdt, size_t bufsize);</span> |
| <span id="L338"><span class="lineNum"> 338</span> : : </span> |
| <span id="L339"><span class="lineNum"> 339</span> : : /**</span> |
| <span id="L340"><span class="lineNum"> 340</span> : : * fdt_get_string - retrieve a string from the strings block of a device tree</span> |
| <span id="L341"><span class="lineNum"> 341</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L342"><span class="lineNum"> 342</span> : : * @stroffset: offset of the string within the strings block (native endian)</span> |
| <span id="L343"><span class="lineNum"> 343</span> : : * @lenp: optional pointer to return the string's length</span> |
| <span id="L344"><span class="lineNum"> 344</span> : : *</span> |
| <span id="L345"><span class="lineNum"> 345</span> : : * fdt_get_string() retrieves a pointer to a single string from the</span> |
| <span id="L346"><span class="lineNum"> 346</span> : : * strings block of the device tree blob at fdt, and optionally also</span> |
| <span id="L347"><span class="lineNum"> 347</span> : : * returns the string's length in *lenp.</span> |
| <span id="L348"><span class="lineNum"> 348</span> : : *</span> |
| <span id="L349"><span class="lineNum"> 349</span> : : * returns:</span> |
| <span id="L350"><span class="lineNum"> 350</span> : : * a pointer to the string, on success</span> |
| <span id="L351"><span class="lineNum"> 351</span> : : * NULL, if stroffset is out of bounds, or doesn't point to a valid string</span> |
| <span id="L352"><span class="lineNum"> 352</span> : : */</span> |
| <span id="L353"><span class="lineNum"> 353</span> : : const char *fdt_get_string(const void *fdt, int stroffset, int *lenp);</span> |
| <span id="L354"><span class="lineNum"> 354</span> : : </span> |
| <span id="L355"><span class="lineNum"> 355</span> : : /**</span> |
| <span id="L356"><span class="lineNum"> 356</span> : : * fdt_string - retrieve a string from the strings block of a device tree</span> |
| <span id="L357"><span class="lineNum"> 357</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L358"><span class="lineNum"> 358</span> : : * @stroffset: offset of the string within the strings block (native endian)</span> |
| <span id="L359"><span class="lineNum"> 359</span> : : *</span> |
| <span id="L360"><span class="lineNum"> 360</span> : : * fdt_string() retrieves a pointer to a single string from the</span> |
| <span id="L361"><span class="lineNum"> 361</span> : : * strings block of the device tree blob at fdt.</span> |
| <span id="L362"><span class="lineNum"> 362</span> : : *</span> |
| <span id="L363"><span class="lineNum"> 363</span> : : * returns:</span> |
| <span id="L364"><span class="lineNum"> 364</span> : : * a pointer to the string, on success</span> |
| <span id="L365"><span class="lineNum"> 365</span> : : * NULL, if stroffset is out of bounds, or doesn't point to a valid string</span> |
| <span id="L366"><span class="lineNum"> 366</span> : : */</span> |
| <span id="L367"><span class="lineNum"> 367</span> : : const char *fdt_string(const void *fdt, int stroffset);</span> |
| <span id="L368"><span class="lineNum"> 368</span> : : </span> |
| <span id="L369"><span class="lineNum"> 369</span> : : /**</span> |
| <span id="L370"><span class="lineNum"> 370</span> : : * fdt_find_max_phandle - find and return the highest phandle in a tree</span> |
| <span id="L371"><span class="lineNum"> 371</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L372"><span class="lineNum"> 372</span> : : * @phandle: return location for the highest phandle value found in the tree</span> |
| <span id="L373"><span class="lineNum"> 373</span> : : *</span> |
| <span id="L374"><span class="lineNum"> 374</span> : : * fdt_find_max_phandle() finds the highest phandle value in the given device</span> |
| <span id="L375"><span class="lineNum"> 375</span> : : * tree. The value returned in @phandle is only valid if the function returns</span> |
| <span id="L376"><span class="lineNum"> 376</span> : : * success.</span> |
| <span id="L377"><span class="lineNum"> 377</span> : : *</span> |
| <span id="L378"><span class="lineNum"> 378</span> : : * returns:</span> |
| <span id="L379"><span class="lineNum"> 379</span> : : * 0 on success or a negative error code on failure</span> |
| <span id="L380"><span class="lineNum"> 380</span> : : */</span> |
| <span id="L381"><span class="lineNum"> 381</span> : : int fdt_find_max_phandle(const void *fdt, uint32_t *phandle);</span> |
| <span id="L382"><span class="lineNum"> 382</span> : : </span> |
| <span id="L383"><span class="lineNum"> 383</span> : : /**</span> |
| <span id="L384"><span class="lineNum"> 384</span> : : * fdt_get_max_phandle - retrieves the highest phandle in a tree</span> |
| <span id="L385"><span class="lineNum"> 385</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L386"><span class="lineNum"> 386</span> : : *</span> |
| <span id="L387"><span class="lineNum"> 387</span> : : * fdt_get_max_phandle retrieves the highest phandle in the given</span> |
| <span id="L388"><span class="lineNum"> 388</span> : : * device tree. This will ignore badly formatted phandles, or phandles</span> |
| <span id="L389"><span class="lineNum"> 389</span> : : * with a value of 0 or -1.</span> |
| <span id="L390"><span class="lineNum"> 390</span> : : *</span> |
| <span id="L391"><span class="lineNum"> 391</span> : : * This function is deprecated in favour of fdt_find_max_phandle().</span> |
| <span id="L392"><span class="lineNum"> 392</span> : : *</span> |
| <span id="L393"><span class="lineNum"> 393</span> : : * returns:</span> |
| <span id="L394"><span class="lineNum"> 394</span> : : * the highest phandle on success</span> |
| <span id="L395"><span class="lineNum"> 395</span> : : * 0, if no phandle was found in the device tree</span> |
| <span id="L396"><span class="lineNum"> 396</span> : : * -1, if an error occurred</span> |
| <span id="L397"><span class="lineNum"> 397</span> : : */</span> |
| <span id="L398"><span class="lineNum"> 398</span> : : static inline uint32_t fdt_get_max_phandle(const void *fdt)</span> |
| <span id="L399"><span class="lineNum"> 399</span> : : {</span> |
| <span id="L400"><span class="lineNum"> 400</span> : : uint32_t phandle;</span> |
| <span id="L401"><span class="lineNum"> 401</span> : : int err;</span> |
| <span id="L402"><span class="lineNum"> 402</span> : : </span> |
| <span id="L403"><span class="lineNum"> 403</span> : : err = fdt_find_max_phandle(fdt, &phandle);</span> |
| <span id="L404"><span class="lineNum"> 404</span> : : if (err < 0)</span> |
| <span id="L405"><span class="lineNum"> 405</span> : : return (uint32_t)-1;</span> |
| <span id="L406"><span class="lineNum"> 406</span> : : </span> |
| <span id="L407"><span class="lineNum"> 407</span> : : return phandle;</span> |
| <span id="L408"><span class="lineNum"> 408</span> : : }</span> |
| <span id="L409"><span class="lineNum"> 409</span> : : </span> |
| <span id="L410"><span class="lineNum"> 410</span> : : /**</span> |
| <span id="L411"><span class="lineNum"> 411</span> : : * fdt_generate_phandle - return a new, unused phandle for a device tree blob</span> |
| <span id="L412"><span class="lineNum"> 412</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L413"><span class="lineNum"> 413</span> : : * @phandle: return location for the new phandle</span> |
| <span id="L414"><span class="lineNum"> 414</span> : : *</span> |
| <span id="L415"><span class="lineNum"> 415</span> : : * Walks the device tree blob and looks for the highest phandle value. On</span> |
| <span id="L416"><span class="lineNum"> 416</span> : : * success, the new, unused phandle value (one higher than the previously</span> |
| <span id="L417"><span class="lineNum"> 417</span> : : * highest phandle value in the device tree blob) will be returned in the</span> |
| <span id="L418"><span class="lineNum"> 418</span> : : * @phandle parameter.</span> |
| <span id="L419"><span class="lineNum"> 419</span> : : *</span> |
| <span id="L420"><span class="lineNum"> 420</span> : : * Return: 0 on success or a negative error-code on failure</span> |
| <span id="L421"><span class="lineNum"> 421</span> : : */</span> |
| <span id="L422"><span class="lineNum"> 422</span> : : int fdt_generate_phandle(const void *fdt, uint32_t *phandle);</span> |
| <span id="L423"><span class="lineNum"> 423</span> : : </span> |
| <span id="L424"><span class="lineNum"> 424</span> : : /**</span> |
| <span id="L425"><span class="lineNum"> 425</span> : : * fdt_num_mem_rsv - retrieve the number of memory reserve map entries</span> |
| <span id="L426"><span class="lineNum"> 426</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L427"><span class="lineNum"> 427</span> : : *</span> |
| <span id="L428"><span class="lineNum"> 428</span> : : * Returns the number of entries in the device tree blob's memory</span> |
| <span id="L429"><span class="lineNum"> 429</span> : : * reservation map. This does not include the terminating 0,0 entry</span> |
| <span id="L430"><span class="lineNum"> 430</span> : : * or any other (0,0) entries reserved for expansion.</span> |
| <span id="L431"><span class="lineNum"> 431</span> : : *</span> |
| <span id="L432"><span class="lineNum"> 432</span> : : * returns:</span> |
| <span id="L433"><span class="lineNum"> 433</span> : : * the number of entries</span> |
| <span id="L434"><span class="lineNum"> 434</span> : : */</span> |
| <span id="L435"><span class="lineNum"> 435</span> : : int fdt_num_mem_rsv(const void *fdt);</span> |
| <span id="L436"><span class="lineNum"> 436</span> : : </span> |
| <span id="L437"><span class="lineNum"> 437</span> : : /**</span> |
| <span id="L438"><span class="lineNum"> 438</span> : : * fdt_get_mem_rsv - retrieve one memory reserve map entry</span> |
| <span id="L439"><span class="lineNum"> 439</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L440"><span class="lineNum"> 440</span> : : * @n: index of reserve map entry</span> |
| <span id="L441"><span class="lineNum"> 441</span> : : * @address: pointer to 64-bit variable to hold the start address</span> |
| <span id="L442"><span class="lineNum"> 442</span> : : * @size: pointer to 64-bit variable to hold the size of the entry</span> |
| <span id="L443"><span class="lineNum"> 443</span> : : *</span> |
| <span id="L444"><span class="lineNum"> 444</span> : : * On success, @address and @size will contain the address and size of</span> |
| <span id="L445"><span class="lineNum"> 445</span> : : * the n-th reserve map entry from the device tree blob, in</span> |
| <span id="L446"><span class="lineNum"> 446</span> : : * native-endian format.</span> |
| <span id="L447"><span class="lineNum"> 447</span> : : *</span> |
| <span id="L448"><span class="lineNum"> 448</span> : : * returns:</span> |
| <span id="L449"><span class="lineNum"> 449</span> : : * 0, on success</span> |
| <span id="L450"><span class="lineNum"> 450</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L451"><span class="lineNum"> 451</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L452"><span class="lineNum"> 452</span> : : * -FDT_ERR_BADSTATE, standard meanings</span> |
| <span id="L453"><span class="lineNum"> 453</span> : : */</span> |
| <span id="L454"><span class="lineNum"> 454</span> : : int fdt_get_mem_rsv(const void *fdt, int n, uint64_t *address, uint64_t *size);</span> |
| <span id="L455"><span class="lineNum"> 455</span> : : </span> |
| <span id="L456"><span class="lineNum"> 456</span> : : /**</span> |
| <span id="L457"><span class="lineNum"> 457</span> : : * fdt_subnode_offset_namelen - find a subnode based on substring</span> |
| <span id="L458"><span class="lineNum"> 458</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L459"><span class="lineNum"> 459</span> : : * @parentoffset: structure block offset of a node</span> |
| <span id="L460"><span class="lineNum"> 460</span> : : * @name: name of the subnode to locate</span> |
| <span id="L461"><span class="lineNum"> 461</span> : : * @namelen: number of characters of name to consider</span> |
| <span id="L462"><span class="lineNum"> 462</span> : : *</span> |
| <span id="L463"><span class="lineNum"> 463</span> : : * Identical to fdt_subnode_offset(), but only examine the first</span> |
| <span id="L464"><span class="lineNum"> 464</span> : : * namelen characters of name for matching the subnode name. This is</span> |
| <span id="L465"><span class="lineNum"> 465</span> : : * useful for finding subnodes based on a portion of a larger string,</span> |
| <span id="L466"><span class="lineNum"> 466</span> : : * such as a full path.</span> |
| <span id="L467"><span class="lineNum"> 467</span> : : *</span> |
| <span id="L468"><span class="lineNum"> 468</span> : : * Return: offset of the subnode or -FDT_ERR_NOTFOUND if name not found.</span> |
| <span id="L469"><span class="lineNum"> 469</span> : : */</span> |
| <span id="L470"><span class="lineNum"> 470</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L471"><span class="lineNum"> 471</span> : : int fdt_subnode_offset_namelen(const void *fdt, int parentoffset,</span> |
| <span id="L472"><span class="lineNum"> 472</span> : : const char *name, int namelen);</span> |
| <span id="L473"><span class="lineNum"> 473</span> : : #endif</span> |
| <span id="L474"><span class="lineNum"> 474</span> : : /**</span> |
| <span id="L475"><span class="lineNum"> 475</span> : : * fdt_subnode_offset - find a subnode of a given node</span> |
| <span id="L476"><span class="lineNum"> 476</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L477"><span class="lineNum"> 477</span> : : * @parentoffset: structure block offset of a node</span> |
| <span id="L478"><span class="lineNum"> 478</span> : : * @name: name of the subnode to locate</span> |
| <span id="L479"><span class="lineNum"> 479</span> : : *</span> |
| <span id="L480"><span class="lineNum"> 480</span> : : * fdt_subnode_offset() finds a subnode of the node at structure block</span> |
| <span id="L481"><span class="lineNum"> 481</span> : : * offset parentoffset with the given name. name may include a unit</span> |
| <span id="L482"><span class="lineNum"> 482</span> : : * address, in which case fdt_subnode_offset() will find the subnode</span> |
| <span id="L483"><span class="lineNum"> 483</span> : : * with that unit address, or the unit address may be omitted, in</span> |
| <span id="L484"><span class="lineNum"> 484</span> : : * which case fdt_subnode_offset() will find an arbitrary subnode</span> |
| <span id="L485"><span class="lineNum"> 485</span> : : * whose name excluding unit address matches the given name.</span> |
| <span id="L486"><span class="lineNum"> 486</span> : : *</span> |
| <span id="L487"><span class="lineNum"> 487</span> : : * returns:</span> |
| <span id="L488"><span class="lineNum"> 488</span> : : * structure block offset of the requested subnode (>=0), on success</span> |
| <span id="L489"><span class="lineNum"> 489</span> : : * -FDT_ERR_NOTFOUND, if the requested subnode does not exist</span> |
| <span id="L490"><span class="lineNum"> 490</span> : : * -FDT_ERR_BADOFFSET, if parentoffset did not point to an FDT_BEGIN_NODE</span> |
| <span id="L491"><span class="lineNum"> 491</span> : : * tag</span> |
| <span id="L492"><span class="lineNum"> 492</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L493"><span class="lineNum"> 493</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L494"><span class="lineNum"> 494</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L495"><span class="lineNum"> 495</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L496"><span class="lineNum"> 496</span> : : * -FDT_ERR_TRUNCATED, standard meanings.</span> |
| <span id="L497"><span class="lineNum"> 497</span> : : */</span> |
| <span id="L498"><span class="lineNum"> 498</span> : : int fdt_subnode_offset(const void *fdt, int parentoffset, const char *name);</span> |
| <span id="L499"><span class="lineNum"> 499</span> : : </span> |
| <span id="L500"><span class="lineNum"> 500</span> : : /**</span> |
| <span id="L501"><span class="lineNum"> 501</span> : : * fdt_path_offset_namelen - find a tree node by its full path</span> |
| <span id="L502"><span class="lineNum"> 502</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L503"><span class="lineNum"> 503</span> : : * @path: full path of the node to locate</span> |
| <span id="L504"><span class="lineNum"> 504</span> : : * @namelen: number of characters of path to consider</span> |
| <span id="L505"><span class="lineNum"> 505</span> : : *</span> |
| <span id="L506"><span class="lineNum"> 506</span> : : * Identical to fdt_path_offset(), but only consider the first namelen</span> |
| <span id="L507"><span class="lineNum"> 507</span> : : * characters of path as the path name.</span> |
| <span id="L508"><span class="lineNum"> 508</span> : : *</span> |
| <span id="L509"><span class="lineNum"> 509</span> : : * Return: offset of the node or negative libfdt error value otherwise</span> |
| <span id="L510"><span class="lineNum"> 510</span> : : */</span> |
| <span id="L511"><span class="lineNum"> 511</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L512"><span class="lineNum"> 512</span> : : int fdt_path_offset_namelen(const void *fdt, const char *path, int namelen);</span> |
| <span id="L513"><span class="lineNum"> 513</span> : : #endif</span> |
| <span id="L514"><span class="lineNum"> 514</span> : : </span> |
| <span id="L515"><span class="lineNum"> 515</span> : : /**</span> |
| <span id="L516"><span class="lineNum"> 516</span> : : * fdt_path_offset - find a tree node by its full path</span> |
| <span id="L517"><span class="lineNum"> 517</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L518"><span class="lineNum"> 518</span> : : * @path: full path of the node to locate</span> |
| <span id="L519"><span class="lineNum"> 519</span> : : *</span> |
| <span id="L520"><span class="lineNum"> 520</span> : : * fdt_path_offset() finds a node of a given path in the device tree.</span> |
| <span id="L521"><span class="lineNum"> 521</span> : : * Each path component may omit the unit address portion, but the</span> |
| <span id="L522"><span class="lineNum"> 522</span> : : * results of this are undefined if any such path component is</span> |
| <span id="L523"><span class="lineNum"> 523</span> : : * ambiguous (that is if there are multiple nodes at the relevant</span> |
| <span id="L524"><span class="lineNum"> 524</span> : : * level matching the given component, differentiated only by unit</span> |
| <span id="L525"><span class="lineNum"> 525</span> : : * address).</span> |
| <span id="L526"><span class="lineNum"> 526</span> : : *</span> |
| <span id="L527"><span class="lineNum"> 527</span> : : * returns:</span> |
| <span id="L528"><span class="lineNum"> 528</span> : : * structure block offset of the node with the requested path (>=0), on</span> |
| <span id="L529"><span class="lineNum"> 529</span> : : * success</span> |
| <span id="L530"><span class="lineNum"> 530</span> : : * -FDT_ERR_BADPATH, given path does not begin with '/' or is invalid</span> |
| <span id="L531"><span class="lineNum"> 531</span> : : * -FDT_ERR_NOTFOUND, if the requested node does not exist</span> |
| <span id="L532"><span class="lineNum"> 532</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L533"><span class="lineNum"> 533</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L534"><span class="lineNum"> 534</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L535"><span class="lineNum"> 535</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L536"><span class="lineNum"> 536</span> : : * -FDT_ERR_TRUNCATED, standard meanings.</span> |
| <span id="L537"><span class="lineNum"> 537</span> : : */</span> |
| <span id="L538"><span class="lineNum"> 538</span> : : int fdt_path_offset(const void *fdt, const char *path);</span> |
| <span id="L539"><span class="lineNum"> 539</span> : : </span> |
| <span id="L540"><span class="lineNum"> 540</span> : : /**</span> |
| <span id="L541"><span class="lineNum"> 541</span> : : * fdt_get_name - retrieve the name of a given node</span> |
| <span id="L542"><span class="lineNum"> 542</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L543"><span class="lineNum"> 543</span> : : * @nodeoffset: structure block offset of the starting node</span> |
| <span id="L544"><span class="lineNum"> 544</span> : : * @lenp: pointer to an integer variable (will be overwritten) or NULL</span> |
| <span id="L545"><span class="lineNum"> 545</span> : : *</span> |
| <span id="L546"><span class="lineNum"> 546</span> : : * fdt_get_name() retrieves the name (including unit address) of the</span> |
| <span id="L547"><span class="lineNum"> 547</span> : : * device tree node at structure block offset nodeoffset. If lenp is</span> |
| <span id="L548"><span class="lineNum"> 548</span> : : * non-NULL, the length of this name is also returned, in the integer</span> |
| <span id="L549"><span class="lineNum"> 549</span> : : * pointed to by lenp.</span> |
| <span id="L550"><span class="lineNum"> 550</span> : : *</span> |
| <span id="L551"><span class="lineNum"> 551</span> : : * returns:</span> |
| <span id="L552"><span class="lineNum"> 552</span> : : * pointer to the node's name, on success</span> |
| <span id="L553"><span class="lineNum"> 553</span> : : * If lenp is non-NULL, *lenp contains the length of that name</span> |
| <span id="L554"><span class="lineNum"> 554</span> : : * (>=0)</span> |
| <span id="L555"><span class="lineNum"> 555</span> : : * NULL, on error</span> |
| <span id="L556"><span class="lineNum"> 556</span> : : * if lenp is non-NULL *lenp contains an error code (<0):</span> |
| <span id="L557"><span class="lineNum"> 557</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE</span> |
| <span id="L558"><span class="lineNum"> 558</span> : : * tag</span> |
| <span id="L559"><span class="lineNum"> 559</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L560"><span class="lineNum"> 560</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L561"><span class="lineNum"> 561</span> : : * -FDT_ERR_BADSTATE, standard meanings</span> |
| <span id="L562"><span class="lineNum"> 562</span> : : */</span> |
| <span id="L563"><span class="lineNum"> 563</span> : : const char *fdt_get_name(const void *fdt, int nodeoffset, int *lenp);</span> |
| <span id="L564"><span class="lineNum"> 564</span> : : </span> |
| <span id="L565"><span class="lineNum"> 565</span> : : /**</span> |
| <span id="L566"><span class="lineNum"> 566</span> : : * fdt_first_property_offset - find the offset of a node's first property</span> |
| <span id="L567"><span class="lineNum"> 567</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L568"><span class="lineNum"> 568</span> : : * @nodeoffset: structure block offset of a node</span> |
| <span id="L569"><span class="lineNum"> 569</span> : : *</span> |
| <span id="L570"><span class="lineNum"> 570</span> : : * fdt_first_property_offset() finds the first property of the node at</span> |
| <span id="L571"><span class="lineNum"> 571</span> : : * the given structure block offset.</span> |
| <span id="L572"><span class="lineNum"> 572</span> : : *</span> |
| <span id="L573"><span class="lineNum"> 573</span> : : * returns:</span> |
| <span id="L574"><span class="lineNum"> 574</span> : : * structure block offset of the property (>=0), on success</span> |
| <span id="L575"><span class="lineNum"> 575</span> : : * -FDT_ERR_NOTFOUND, if the requested node has no properties</span> |
| <span id="L576"><span class="lineNum"> 576</span> : : * -FDT_ERR_BADOFFSET, if nodeoffset did not point to an FDT_BEGIN_NODE tag</span> |
| <span id="L577"><span class="lineNum"> 577</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L578"><span class="lineNum"> 578</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L579"><span class="lineNum"> 579</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L580"><span class="lineNum"> 580</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L581"><span class="lineNum"> 581</span> : : * -FDT_ERR_TRUNCATED, standard meanings.</span> |
| <span id="L582"><span class="lineNum"> 582</span> : : */</span> |
| <span id="L583"><span class="lineNum"> 583</span> : : int fdt_first_property_offset(const void *fdt, int nodeoffset);</span> |
| <span id="L584"><span class="lineNum"> 584</span> : : </span> |
| <span id="L585"><span class="lineNum"> 585</span> : : /**</span> |
| <span id="L586"><span class="lineNum"> 586</span> : : * fdt_next_property_offset - step through a node's properties</span> |
| <span id="L587"><span class="lineNum"> 587</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L588"><span class="lineNum"> 588</span> : : * @offset: structure block offset of a property</span> |
| <span id="L589"><span class="lineNum"> 589</span> : : *</span> |
| <span id="L590"><span class="lineNum"> 590</span> : : * fdt_next_property_offset() finds the property immediately after the</span> |
| <span id="L591"><span class="lineNum"> 591</span> : : * one at the given structure block offset. This will be a property</span> |
| <span id="L592"><span class="lineNum"> 592</span> : : * of the same node as the given property.</span> |
| <span id="L593"><span class="lineNum"> 593</span> : : *</span> |
| <span id="L594"><span class="lineNum"> 594</span> : : * returns:</span> |
| <span id="L595"><span class="lineNum"> 595</span> : : * structure block offset of the next property (>=0), on success</span> |
| <span id="L596"><span class="lineNum"> 596</span> : : * -FDT_ERR_NOTFOUND, if the given property is the last in its node</span> |
| <span id="L597"><span class="lineNum"> 597</span> : : * -FDT_ERR_BADOFFSET, if nodeoffset did not point to an FDT_PROP tag</span> |
| <span id="L598"><span class="lineNum"> 598</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L599"><span class="lineNum"> 599</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L600"><span class="lineNum"> 600</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L601"><span class="lineNum"> 601</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L602"><span class="lineNum"> 602</span> : : * -FDT_ERR_TRUNCATED, standard meanings.</span> |
| <span id="L603"><span class="lineNum"> 603</span> : : */</span> |
| <span id="L604"><span class="lineNum"> 604</span> : : int fdt_next_property_offset(const void *fdt, int offset);</span> |
| <span id="L605"><span class="lineNum"> 605</span> : : </span> |
| <span id="L606"><span class="lineNum"> 606</span> : : /**</span> |
| <span id="L607"><span class="lineNum"> 607</span> : : * fdt_for_each_property_offset - iterate over all properties of a node</span> |
| <span id="L608"><span class="lineNum"> 608</span> : : *</span> |
| <span id="L609"><span class="lineNum"> 609</span> : : * @property: property offset (int, lvalue)</span> |
| <span id="L610"><span class="lineNum"> 610</span> : : * @fdt: FDT blob (const void *)</span> |
| <span id="L611"><span class="lineNum"> 611</span> : : * @node: node offset (int)</span> |
| <span id="L612"><span class="lineNum"> 612</span> : : *</span> |
| <span id="L613"><span class="lineNum"> 613</span> : : * This is actually a wrapper around a for loop and would be used like so:</span> |
| <span id="L614"><span class="lineNum"> 614</span> : : *</span> |
| <span id="L615"><span class="lineNum"> 615</span> : : * fdt_for_each_property_offset(property, fdt, node) {</span> |
| <span id="L616"><span class="lineNum"> 616</span> : : * Use property</span> |
| <span id="L617"><span class="lineNum"> 617</span> : : * ...</span> |
| <span id="L618"><span class="lineNum"> 618</span> : : * }</span> |
| <span id="L619"><span class="lineNum"> 619</span> : : *</span> |
| <span id="L620"><span class="lineNum"> 620</span> : : * if ((property < 0) && (property != -FDT_ERR_NOTFOUND)) {</span> |
| <span id="L621"><span class="lineNum"> 621</span> : : * Error handling</span> |
| <span id="L622"><span class="lineNum"> 622</span> : : * }</span> |
| <span id="L623"><span class="lineNum"> 623</span> : : *</span> |
| <span id="L624"><span class="lineNum"> 624</span> : : * Note that this is implemented as a macro and property is used as</span> |
| <span id="L625"><span class="lineNum"> 625</span> : : * iterator in the loop. The node variable can be constant or even a</span> |
| <span id="L626"><span class="lineNum"> 626</span> : : * literal.</span> |
| <span id="L627"><span class="lineNum"> 627</span> : : */</span> |
| <span id="L628"><span class="lineNum"> 628</span> : : #define fdt_for_each_property_offset(property, fdt, node) \</span> |
| <span id="L629"><span class="lineNum"> 629</span> : : for (property = fdt_first_property_offset(fdt, node); \</span> |
| <span id="L630"><span class="lineNum"> 630</span> : : property >= 0; \</span> |
| <span id="L631"><span class="lineNum"> 631</span> : : property = fdt_next_property_offset(fdt, property))</span> |
| <span id="L632"><span class="lineNum"> 632</span> : : </span> |
| <span id="L633"><span class="lineNum"> 633</span> : : /**</span> |
| <span id="L634"><span class="lineNum"> 634</span> : : * fdt_get_property_by_offset - retrieve the property at a given offset</span> |
| <span id="L635"><span class="lineNum"> 635</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L636"><span class="lineNum"> 636</span> : : * @offset: offset of the property to retrieve</span> |
| <span id="L637"><span class="lineNum"> 637</span> : : * @lenp: pointer to an integer variable (will be overwritten) or NULL</span> |
| <span id="L638"><span class="lineNum"> 638</span> : : *</span> |
| <span id="L639"><span class="lineNum"> 639</span> : : * fdt_get_property_by_offset() retrieves a pointer to the</span> |
| <span id="L640"><span class="lineNum"> 640</span> : : * fdt_property structure within the device tree blob at the given</span> |
| <span id="L641"><span class="lineNum"> 641</span> : : * offset. If lenp is non-NULL, the length of the property value is</span> |
| <span id="L642"><span class="lineNum"> 642</span> : : * also returned, in the integer pointed to by lenp.</span> |
| <span id="L643"><span class="lineNum"> 643</span> : : *</span> |
| <span id="L644"><span class="lineNum"> 644</span> : : * Note that this code only works on device tree versions >= 16. fdt_getprop()</span> |
| <span id="L645"><span class="lineNum"> 645</span> : : * works on all versions.</span> |
| <span id="L646"><span class="lineNum"> 646</span> : : *</span> |
| <span id="L647"><span class="lineNum"> 647</span> : : * returns:</span> |
| <span id="L648"><span class="lineNum"> 648</span> : : * pointer to the structure representing the property</span> |
| <span id="L649"><span class="lineNum"> 649</span> : : * if lenp is non-NULL, *lenp contains the length of the property</span> |
| <span id="L650"><span class="lineNum"> 650</span> : : * value (>=0)</span> |
| <span id="L651"><span class="lineNum"> 651</span> : : * NULL, on error</span> |
| <span id="L652"><span class="lineNum"> 652</span> : : * if lenp is non-NULL, *lenp contains an error code (<0):</span> |
| <span id="L653"><span class="lineNum"> 653</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_PROP tag</span> |
| <span id="L654"><span class="lineNum"> 654</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L655"><span class="lineNum"> 655</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L656"><span class="lineNum"> 656</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L657"><span class="lineNum"> 657</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L658"><span class="lineNum"> 658</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L659"><span class="lineNum"> 659</span> : : */</span> |
| <span id="L660"><span class="lineNum"> 660</span> : : const struct fdt_property *fdt_get_property_by_offset(const void *fdt,</span> |
| <span id="L661"><span class="lineNum"> 661</span> : : int offset,</span> |
| <span id="L662"><span class="lineNum"> 662</span> : : int *lenp);</span> |
| <span id="L663"><span class="lineNum"> 663</span> : : </span> |
| <span id="L664"><span class="lineNum"> 664</span> : : /**</span> |
| <span id="L665"><span class="lineNum"> 665</span> : : * fdt_get_property_namelen - find a property based on substring</span> |
| <span id="L666"><span class="lineNum"> 666</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L667"><span class="lineNum"> 667</span> : : * @nodeoffset: offset of the node whose property to find</span> |
| <span id="L668"><span class="lineNum"> 668</span> : : * @name: name of the property to find</span> |
| <span id="L669"><span class="lineNum"> 669</span> : : * @namelen: number of characters of name to consider</span> |
| <span id="L670"><span class="lineNum"> 670</span> : : * @lenp: pointer to an integer variable (will be overwritten) or NULL</span> |
| <span id="L671"><span class="lineNum"> 671</span> : : *</span> |
| <span id="L672"><span class="lineNum"> 672</span> : : * Identical to fdt_get_property(), but only examine the first namelen</span> |
| <span id="L673"><span class="lineNum"> 673</span> : : * characters of name for matching the property name.</span> |
| <span id="L674"><span class="lineNum"> 674</span> : : *</span> |
| <span id="L675"><span class="lineNum"> 675</span> : : * Return: pointer to the structure representing the property, or NULL</span> |
| <span id="L676"><span class="lineNum"> 676</span> : : * if not found</span> |
| <span id="L677"><span class="lineNum"> 677</span> : : */</span> |
| <span id="L678"><span class="lineNum"> 678</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L679"><span class="lineNum"> 679</span> : : const struct fdt_property *fdt_get_property_namelen(const void *fdt,</span> |
| <span id="L680"><span class="lineNum"> 680</span> : : int nodeoffset,</span> |
| <span id="L681"><span class="lineNum"> 681</span> : : const char *name,</span> |
| <span id="L682"><span class="lineNum"> 682</span> : : int namelen, int *lenp);</span> |
| <span id="L683"><span class="lineNum"> 683</span> : : #endif</span> |
| <span id="L684"><span class="lineNum"> 684</span> : : </span> |
| <span id="L685"><span class="lineNum"> 685</span> : : /**</span> |
| <span id="L686"><span class="lineNum"> 686</span> : : * fdt_get_property - find a given property in a given node</span> |
| <span id="L687"><span class="lineNum"> 687</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L688"><span class="lineNum"> 688</span> : : * @nodeoffset: offset of the node whose property to find</span> |
| <span id="L689"><span class="lineNum"> 689</span> : : * @name: name of the property to find</span> |
| <span id="L690"><span class="lineNum"> 690</span> : : * @lenp: pointer to an integer variable (will be overwritten) or NULL</span> |
| <span id="L691"><span class="lineNum"> 691</span> : : *</span> |
| <span id="L692"><span class="lineNum"> 692</span> : : * fdt_get_property() retrieves a pointer to the fdt_property</span> |
| <span id="L693"><span class="lineNum"> 693</span> : : * structure within the device tree blob corresponding to the property</span> |
| <span id="L694"><span class="lineNum"> 694</span> : : * named 'name' of the node at offset nodeoffset. If lenp is</span> |
| <span id="L695"><span class="lineNum"> 695</span> : : * non-NULL, the length of the property value is also returned, in the</span> |
| <span id="L696"><span class="lineNum"> 696</span> : : * integer pointed to by lenp.</span> |
| <span id="L697"><span class="lineNum"> 697</span> : : *</span> |
| <span id="L698"><span class="lineNum"> 698</span> : : * returns:</span> |
| <span id="L699"><span class="lineNum"> 699</span> : : * pointer to the structure representing the property</span> |
| <span id="L700"><span class="lineNum"> 700</span> : : * if lenp is non-NULL, *lenp contains the length of the property</span> |
| <span id="L701"><span class="lineNum"> 701</span> : : * value (>=0)</span> |
| <span id="L702"><span class="lineNum"> 702</span> : : * NULL, on error</span> |
| <span id="L703"><span class="lineNum"> 703</span> : : * if lenp is non-NULL, *lenp contains an error code (<0):</span> |
| <span id="L704"><span class="lineNum"> 704</span> : : * -FDT_ERR_NOTFOUND, node does not have named property</span> |
| <span id="L705"><span class="lineNum"> 705</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE</span> |
| <span id="L706"><span class="lineNum"> 706</span> : : * tag</span> |
| <span id="L707"><span class="lineNum"> 707</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L708"><span class="lineNum"> 708</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L709"><span class="lineNum"> 709</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L710"><span class="lineNum"> 710</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L711"><span class="lineNum"> 711</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L712"><span class="lineNum"> 712</span> : : */</span> |
| <span id="L713"><span class="lineNum"> 713</span> : : const struct fdt_property *fdt_get_property(const void *fdt, int nodeoffset,</span> |
| <span id="L714"><span class="lineNum"> 714</span> : : const char *name, int *lenp);</span> |
| <span id="L715"><span class="lineNum"> 715</span> : : static inline struct fdt_property *fdt_get_property_w(void *fdt, int nodeoffset,</span> |
| <span id="L716"><span class="lineNum"> 716</span> : : const char *name,</span> |
| <span id="L717"><span class="lineNum"> 717</span> : : int *lenp)</span> |
| <span id="L718"><span class="lineNum"> 718</span> : : {</span> |
| <span id="L719"><span class="lineNum"> 719</span> : : return (struct fdt_property *)(uintptr_t)</span> |
| <span id="L720"><span class="lineNum"> 720</span> : : fdt_get_property(fdt, nodeoffset, name, lenp);</span> |
| <span id="L721"><span class="lineNum"> 721</span> : : }</span> |
| <span id="L722"><span class="lineNum"> 722</span> : : </span> |
| <span id="L723"><span class="lineNum"> 723</span> : : /**</span> |
| <span id="L724"><span class="lineNum"> 724</span> : : * fdt_getprop_by_offset - retrieve the value of a property at a given offset</span> |
| <span id="L725"><span class="lineNum"> 725</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L726"><span class="lineNum"> 726</span> : : * @offset: offset of the property to read</span> |
| <span id="L727"><span class="lineNum"> 727</span> : : * @namep: pointer to a string variable (will be overwritten) or NULL</span> |
| <span id="L728"><span class="lineNum"> 728</span> : : * @lenp: pointer to an integer variable (will be overwritten) or NULL</span> |
| <span id="L729"><span class="lineNum"> 729</span> : : *</span> |
| <span id="L730"><span class="lineNum"> 730</span> : : * fdt_getprop_by_offset() retrieves a pointer to the value of the</span> |
| <span id="L731"><span class="lineNum"> 731</span> : : * property at structure block offset 'offset' (this will be a pointer</span> |
| <span id="L732"><span class="lineNum"> 732</span> : : * to within the device blob itself, not a copy of the value). If</span> |
| <span id="L733"><span class="lineNum"> 733</span> : : * lenp is non-NULL, the length of the property value is also</span> |
| <span id="L734"><span class="lineNum"> 734</span> : : * returned, in the integer pointed to by lenp. If namep is non-NULL,</span> |
| <span id="L735"><span class="lineNum"> 735</span> : : * the property's namne will also be returned in the char * pointed to</span> |
| <span id="L736"><span class="lineNum"> 736</span> : : * by namep (this will be a pointer to within the device tree's string</span> |
| <span id="L737"><span class="lineNum"> 737</span> : : * block, not a new copy of the name).</span> |
| <span id="L738"><span class="lineNum"> 738</span> : : *</span> |
| <span id="L739"><span class="lineNum"> 739</span> : : * returns:</span> |
| <span id="L740"><span class="lineNum"> 740</span> : : * pointer to the property's value</span> |
| <span id="L741"><span class="lineNum"> 741</span> : : * if lenp is non-NULL, *lenp contains the length of the property</span> |
| <span id="L742"><span class="lineNum"> 742</span> : : * value (>=0)</span> |
| <span id="L743"><span class="lineNum"> 743</span> : : * if namep is non-NULL *namep contiains a pointer to the property</span> |
| <span id="L744"><span class="lineNum"> 744</span> : : * name.</span> |
| <span id="L745"><span class="lineNum"> 745</span> : : * NULL, on error</span> |
| <span id="L746"><span class="lineNum"> 746</span> : : * if lenp is non-NULL, *lenp contains an error code (<0):</span> |
| <span id="L747"><span class="lineNum"> 747</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_PROP tag</span> |
| <span id="L748"><span class="lineNum"> 748</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L749"><span class="lineNum"> 749</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L750"><span class="lineNum"> 750</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L751"><span class="lineNum"> 751</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L752"><span class="lineNum"> 752</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L753"><span class="lineNum"> 753</span> : : */</span> |
| <span id="L754"><span class="lineNum"> 754</span> : : #ifndef SWIG /* This function is not useful in Python */</span> |
| <span id="L755"><span class="lineNum"> 755</span> : : const void *fdt_getprop_by_offset(const void *fdt, int offset,</span> |
| <span id="L756"><span class="lineNum"> 756</span> : : const char **namep, int *lenp);</span> |
| <span id="L757"><span class="lineNum"> 757</span> : : #endif</span> |
| <span id="L758"><span class="lineNum"> 758</span> : : </span> |
| <span id="L759"><span class="lineNum"> 759</span> : : /**</span> |
| <span id="L760"><span class="lineNum"> 760</span> : : * fdt_getprop_namelen - get property value based on substring</span> |
| <span id="L761"><span class="lineNum"> 761</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L762"><span class="lineNum"> 762</span> : : * @nodeoffset: offset of the node whose property to find</span> |
| <span id="L763"><span class="lineNum"> 763</span> : : * @name: name of the property to find</span> |
| <span id="L764"><span class="lineNum"> 764</span> : : * @namelen: number of characters of name to consider</span> |
| <span id="L765"><span class="lineNum"> 765</span> : : * @lenp: pointer to an integer variable (will be overwritten) or NULL</span> |
| <span id="L766"><span class="lineNum"> 766</span> : : *</span> |
| <span id="L767"><span class="lineNum"> 767</span> : : * Identical to fdt_getprop(), but only examine the first namelen</span> |
| <span id="L768"><span class="lineNum"> 768</span> : : * characters of name for matching the property name.</span> |
| <span id="L769"><span class="lineNum"> 769</span> : : *</span> |
| <span id="L770"><span class="lineNum"> 770</span> : : * Return: pointer to the property's value or NULL on error</span> |
| <span id="L771"><span class="lineNum"> 771</span> : : */</span> |
| <span id="L772"><span class="lineNum"> 772</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L773"><span class="lineNum"> 773</span> : : const void *fdt_getprop_namelen(const void *fdt, int nodeoffset,</span> |
| <span id="L774"><span class="lineNum"> 774</span> : : const char *name, int namelen, int *lenp);</span> |
| <span id="L775"><span class="lineNum"> 775</span> : : static inline void *fdt_getprop_namelen_w(void *fdt, int nodeoffset,</span> |
| <span id="L776"><span class="lineNum"> 776</span> : : const char *name, int namelen,</span> |
| <span id="L777"><span class="lineNum"> 777</span> : : int *lenp)</span> |
| <span id="L778"><span class="lineNum"> 778</span> : : {</span> |
| <span id="L779"><span class="lineNum"> 779</span> : : return (void *)(uintptr_t)fdt_getprop_namelen(fdt, nodeoffset, name,</span> |
| <span id="L780"><span class="lineNum"> 780</span> : : namelen, lenp);</span> |
| <span id="L781"><span class="lineNum"> 781</span> : : }</span> |
| <span id="L782"><span class="lineNum"> 782</span> : : #endif</span> |
| <span id="L783"><span class="lineNum"> 783</span> : : </span> |
| <span id="L784"><span class="lineNum"> 784</span> : : /**</span> |
| <span id="L785"><span class="lineNum"> 785</span> : : * fdt_getprop - retrieve the value of a given property</span> |
| <span id="L786"><span class="lineNum"> 786</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L787"><span class="lineNum"> 787</span> : : * @nodeoffset: offset of the node whose property to find</span> |
| <span id="L788"><span class="lineNum"> 788</span> : : * @name: name of the property to find</span> |
| <span id="L789"><span class="lineNum"> 789</span> : : * @lenp: pointer to an integer variable (will be overwritten) or NULL</span> |
| <span id="L790"><span class="lineNum"> 790</span> : : *</span> |
| <span id="L791"><span class="lineNum"> 791</span> : : * fdt_getprop() retrieves a pointer to the value of the property</span> |
| <span id="L792"><span class="lineNum"> 792</span> : : * named @name of the node at offset @nodeoffset (this will be a</span> |
| <span id="L793"><span class="lineNum"> 793</span> : : * pointer to within the device blob itself, not a copy of the value).</span> |
| <span id="L794"><span class="lineNum"> 794</span> : : * If @lenp is non-NULL, the length of the property value is also</span> |
| <span id="L795"><span class="lineNum"> 795</span> : : * returned, in the integer pointed to by @lenp.</span> |
| <span id="L796"><span class="lineNum"> 796</span> : : *</span> |
| <span id="L797"><span class="lineNum"> 797</span> : : * returns:</span> |
| <span id="L798"><span class="lineNum"> 798</span> : : * pointer to the property's value</span> |
| <span id="L799"><span class="lineNum"> 799</span> : : * if lenp is non-NULL, *lenp contains the length of the property</span> |
| <span id="L800"><span class="lineNum"> 800</span> : : * value (>=0)</span> |
| <span id="L801"><span class="lineNum"> 801</span> : : * NULL, on error</span> |
| <span id="L802"><span class="lineNum"> 802</span> : : * if lenp is non-NULL, *lenp contains an error code (<0):</span> |
| <span id="L803"><span class="lineNum"> 803</span> : : * -FDT_ERR_NOTFOUND, node does not have named property</span> |
| <span id="L804"><span class="lineNum"> 804</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE</span> |
| <span id="L805"><span class="lineNum"> 805</span> : : * tag</span> |
| <span id="L806"><span class="lineNum"> 806</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L807"><span class="lineNum"> 807</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L808"><span class="lineNum"> 808</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L809"><span class="lineNum"> 809</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L810"><span class="lineNum"> 810</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L811"><span class="lineNum"> 811</span> : : */</span> |
| <span id="L812"><span class="lineNum"> 812</span> : : const void *fdt_getprop(const void *fdt, int nodeoffset,</span> |
| <span id="L813"><span class="lineNum"> 813</span> : : const char *name, int *lenp);</span> |
| <span id="L814"><span class="lineNum"> 814</span> : : static inline void *fdt_getprop_w(void *fdt, int nodeoffset,</span> |
| <span id="L815"><span class="lineNum"> 815</span> : : const char *name, int *lenp)</span> |
| <span id="L816"><span class="lineNum"> 816</span> : : {</span> |
| <span id="L817"><span class="lineNum"> 817</span> : : return (void *)(uintptr_t)fdt_getprop(fdt, nodeoffset, name, lenp);</span> |
| <span id="L818"><span class="lineNum"> 818</span> : : }</span> |
| <span id="L819"><span class="lineNum"> 819</span> : : </span> |
| <span id="L820"><span class="lineNum"> 820</span> : : /**</span> |
| <span id="L821"><span class="lineNum"> 821</span> : : * fdt_get_phandle - retrieve the phandle of a given node</span> |
| <span id="L822"><span class="lineNum"> 822</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L823"><span class="lineNum"> 823</span> : : * @nodeoffset: structure block offset of the node</span> |
| <span id="L824"><span class="lineNum"> 824</span> : : *</span> |
| <span id="L825"><span class="lineNum"> 825</span> : : * fdt_get_phandle() retrieves the phandle of the device tree node at</span> |
| <span id="L826"><span class="lineNum"> 826</span> : : * structure block offset nodeoffset.</span> |
| <span id="L827"><span class="lineNum"> 827</span> : : *</span> |
| <span id="L828"><span class="lineNum"> 828</span> : : * returns:</span> |
| <span id="L829"><span class="lineNum"> 829</span> : : * the phandle of the node at nodeoffset, on success (!= 0, != -1)</span> |
| <span id="L830"><span class="lineNum"> 830</span> : : * 0, if the node has no phandle, or another error occurs</span> |
| <span id="L831"><span class="lineNum"> 831</span> : : */</span> |
| <span id="L832"><span class="lineNum"> 832</span> : : uint32_t fdt_get_phandle(const void *fdt, int nodeoffset);</span> |
| <span id="L833"><span class="lineNum"> 833</span> : : </span> |
| <span id="L834"><span class="lineNum"> 834</span> : : /**</span> |
| <span id="L835"><span class="lineNum"> 835</span> : : * fdt_get_alias_namelen - get alias based on substring</span> |
| <span id="L836"><span class="lineNum"> 836</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L837"><span class="lineNum"> 837</span> : : * @name: name of the alias th look up</span> |
| <span id="L838"><span class="lineNum"> 838</span> : : * @namelen: number of characters of name to consider</span> |
| <span id="L839"><span class="lineNum"> 839</span> : : *</span> |
| <span id="L840"><span class="lineNum"> 840</span> : : * Identical to fdt_get_alias(), but only examine the first @namelen</span> |
| <span id="L841"><span class="lineNum"> 841</span> : : * characters of @name for matching the alias name.</span> |
| <span id="L842"><span class="lineNum"> 842</span> : : *</span> |
| <span id="L843"><span class="lineNum"> 843</span> : : * Return: a pointer to the expansion of the alias named @name, if it exists,</span> |
| <span id="L844"><span class="lineNum"> 844</span> : : * NULL otherwise</span> |
| <span id="L845"><span class="lineNum"> 845</span> : : */</span> |
| <span id="L846"><span class="lineNum"> 846</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L847"><span class="lineNum"> 847</span> : : const char *fdt_get_alias_namelen(const void *fdt,</span> |
| <span id="L848"><span class="lineNum"> 848</span> : : const char *name, int namelen);</span> |
| <span id="L849"><span class="lineNum"> 849</span> : : #endif</span> |
| <span id="L850"><span class="lineNum"> 850</span> : : </span> |
| <span id="L851"><span class="lineNum"> 851</span> : : /**</span> |
| <span id="L852"><span class="lineNum"> 852</span> : : * fdt_get_alias - retrieve the path referenced by a given alias</span> |
| <span id="L853"><span class="lineNum"> 853</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L854"><span class="lineNum"> 854</span> : : * @name: name of the alias th look up</span> |
| <span id="L855"><span class="lineNum"> 855</span> : : *</span> |
| <span id="L856"><span class="lineNum"> 856</span> : : * fdt_get_alias() retrieves the value of a given alias. That is, the</span> |
| <span id="L857"><span class="lineNum"> 857</span> : : * value of the property named @name in the node /aliases.</span> |
| <span id="L858"><span class="lineNum"> 858</span> : : *</span> |
| <span id="L859"><span class="lineNum"> 859</span> : : * returns:</span> |
| <span id="L860"><span class="lineNum"> 860</span> : : * a pointer to the expansion of the alias named 'name', if it exists</span> |
| <span id="L861"><span class="lineNum"> 861</span> : : * NULL, if the given alias or the /aliases node does not exist</span> |
| <span id="L862"><span class="lineNum"> 862</span> : : */</span> |
| <span id="L863"><span class="lineNum"> 863</span> : : const char *fdt_get_alias(const void *fdt, const char *name);</span> |
| <span id="L864"><span class="lineNum"> 864</span> : : </span> |
| <span id="L865"><span class="lineNum"> 865</span> : : /**</span> |
| <span id="L866"><span class="lineNum"> 866</span> : : * fdt_get_path - determine the full path of a node</span> |
| <span id="L867"><span class="lineNum"> 867</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L868"><span class="lineNum"> 868</span> : : * @nodeoffset: offset of the node whose path to find</span> |
| <span id="L869"><span class="lineNum"> 869</span> : : * @buf: character buffer to contain the returned path (will be overwritten)</span> |
| <span id="L870"><span class="lineNum"> 870</span> : : * @buflen: size of the character buffer at buf</span> |
| <span id="L871"><span class="lineNum"> 871</span> : : *</span> |
| <span id="L872"><span class="lineNum"> 872</span> : : * fdt_get_path() computes the full path of the node at offset</span> |
| <span id="L873"><span class="lineNum"> 873</span> : : * nodeoffset, and records that path in the buffer at buf.</span> |
| <span id="L874"><span class="lineNum"> 874</span> : : *</span> |
| <span id="L875"><span class="lineNum"> 875</span> : : * NOTE: This function is expensive, as it must scan the device tree</span> |
| <span id="L876"><span class="lineNum"> 876</span> : : * structure from the start to nodeoffset.</span> |
| <span id="L877"><span class="lineNum"> 877</span> : : *</span> |
| <span id="L878"><span class="lineNum"> 878</span> : : * returns:</span> |
| <span id="L879"><span class="lineNum"> 879</span> : : * 0, on success</span> |
| <span id="L880"><span class="lineNum"> 880</span> : : * buf contains the absolute path of the node at</span> |
| <span id="L881"><span class="lineNum"> 881</span> : : * nodeoffset, as a NUL-terminated string.</span> |
| <span id="L882"><span class="lineNum"> 882</span> : : * -FDT_ERR_BADOFFSET, nodeoffset does not refer to a BEGIN_NODE tag</span> |
| <span id="L883"><span class="lineNum"> 883</span> : : * -FDT_ERR_NOSPACE, the path of the given node is longer than (bufsize-1)</span> |
| <span id="L884"><span class="lineNum"> 884</span> : : * characters and will not fit in the given buffer.</span> |
| <span id="L885"><span class="lineNum"> 885</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L886"><span class="lineNum"> 886</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L887"><span class="lineNum"> 887</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L888"><span class="lineNum"> 888</span> : : * -FDT_ERR_BADSTRUCTURE, standard meanings</span> |
| <span id="L889"><span class="lineNum"> 889</span> : : */</span> |
| <span id="L890"><span class="lineNum"> 890</span> : : int fdt_get_path(const void *fdt, int nodeoffset, char *buf, int buflen);</span> |
| <span id="L891"><span class="lineNum"> 891</span> : : </span> |
| <span id="L892"><span class="lineNum"> 892</span> : : /**</span> |
| <span id="L893"><span class="lineNum"> 893</span> : : * fdt_supernode_atdepth_offset - find a specific ancestor of a node</span> |
| <span id="L894"><span class="lineNum"> 894</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L895"><span class="lineNum"> 895</span> : : * @nodeoffset: offset of the node whose parent to find</span> |
| <span id="L896"><span class="lineNum"> 896</span> : : * @supernodedepth: depth of the ancestor to find</span> |
| <span id="L897"><span class="lineNum"> 897</span> : : * @nodedepth: pointer to an integer variable (will be overwritten) or NULL</span> |
| <span id="L898"><span class="lineNum"> 898</span> : : *</span> |
| <span id="L899"><span class="lineNum"> 899</span> : : * fdt_supernode_atdepth_offset() finds an ancestor of the given node</span> |
| <span id="L900"><span class="lineNum"> 900</span> : : * at a specific depth from the root (where the root itself has depth</span> |
| <span id="L901"><span class="lineNum"> 901</span> : : * 0, its immediate subnodes depth 1 and so forth). So</span> |
| <span id="L902"><span class="lineNum"> 902</span> : : * fdt_supernode_atdepth_offset(fdt, nodeoffset, 0, NULL);</span> |
| <span id="L903"><span class="lineNum"> 903</span> : : * will always return 0, the offset of the root node. If the node at</span> |
| <span id="L904"><span class="lineNum"> 904</span> : : * nodeoffset has depth D, then:</span> |
| <span id="L905"><span class="lineNum"> 905</span> : : * fdt_supernode_atdepth_offset(fdt, nodeoffset, D, NULL);</span> |
| <span id="L906"><span class="lineNum"> 906</span> : : * will return nodeoffset itself.</span> |
| <span id="L907"><span class="lineNum"> 907</span> : : *</span> |
| <span id="L908"><span class="lineNum"> 908</span> : : * NOTE: This function is expensive, as it must scan the device tree</span> |
| <span id="L909"><span class="lineNum"> 909</span> : : * structure from the start to nodeoffset.</span> |
| <span id="L910"><span class="lineNum"> 910</span> : : *</span> |
| <span id="L911"><span class="lineNum"> 911</span> : : * returns:</span> |
| <span id="L912"><span class="lineNum"> 912</span> : : * structure block offset of the node at node offset's ancestor</span> |
| <span id="L913"><span class="lineNum"> 913</span> : : * of depth supernodedepth (>=0), on success</span> |
| <span id="L914"><span class="lineNum"> 914</span> : : * -FDT_ERR_BADOFFSET, nodeoffset does not refer to a BEGIN_NODE tag</span> |
| <span id="L915"><span class="lineNum"> 915</span> : : * -FDT_ERR_NOTFOUND, supernodedepth was greater than the depth of</span> |
| <span id="L916"><span class="lineNum"> 916</span> : : * nodeoffset</span> |
| <span id="L917"><span class="lineNum"> 917</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L918"><span class="lineNum"> 918</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L919"><span class="lineNum"> 919</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L920"><span class="lineNum"> 920</span> : : * -FDT_ERR_BADSTRUCTURE, standard meanings</span> |
| <span id="L921"><span class="lineNum"> 921</span> : : */</span> |
| <span id="L922"><span class="lineNum"> 922</span> : : int fdt_supernode_atdepth_offset(const void *fdt, int nodeoffset,</span> |
| <span id="L923"><span class="lineNum"> 923</span> : : int supernodedepth, int *nodedepth);</span> |
| <span id="L924"><span class="lineNum"> 924</span> : : </span> |
| <span id="L925"><span class="lineNum"> 925</span> : : /**</span> |
| <span id="L926"><span class="lineNum"> 926</span> : : * fdt_node_depth - find the depth of a given node</span> |
| <span id="L927"><span class="lineNum"> 927</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L928"><span class="lineNum"> 928</span> : : * @nodeoffset: offset of the node whose parent to find</span> |
| <span id="L929"><span class="lineNum"> 929</span> : : *</span> |
| <span id="L930"><span class="lineNum"> 930</span> : : * fdt_node_depth() finds the depth of a given node. The root node</span> |
| <span id="L931"><span class="lineNum"> 931</span> : : * has depth 0, its immediate subnodes depth 1 and so forth.</span> |
| <span id="L932"><span class="lineNum"> 932</span> : : *</span> |
| <span id="L933"><span class="lineNum"> 933</span> : : * NOTE: This function is expensive, as it must scan the device tree</span> |
| <span id="L934"><span class="lineNum"> 934</span> : : * structure from the start to nodeoffset.</span> |
| <span id="L935"><span class="lineNum"> 935</span> : : *</span> |
| <span id="L936"><span class="lineNum"> 936</span> : : * returns:</span> |
| <span id="L937"><span class="lineNum"> 937</span> : : * depth of the node at nodeoffset (>=0), on success</span> |
| <span id="L938"><span class="lineNum"> 938</span> : : * -FDT_ERR_BADOFFSET, nodeoffset does not refer to a BEGIN_NODE tag</span> |
| <span id="L939"><span class="lineNum"> 939</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L940"><span class="lineNum"> 940</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L941"><span class="lineNum"> 941</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L942"><span class="lineNum"> 942</span> : : * -FDT_ERR_BADSTRUCTURE, standard meanings</span> |
| <span id="L943"><span class="lineNum"> 943</span> : : */</span> |
| <span id="L944"><span class="lineNum"> 944</span> : : int fdt_node_depth(const void *fdt, int nodeoffset);</span> |
| <span id="L945"><span class="lineNum"> 945</span> : : </span> |
| <span id="L946"><span class="lineNum"> 946</span> : : /**</span> |
| <span id="L947"><span class="lineNum"> 947</span> : : * fdt_parent_offset - find the parent of a given node</span> |
| <span id="L948"><span class="lineNum"> 948</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L949"><span class="lineNum"> 949</span> : : * @nodeoffset: offset of the node whose parent to find</span> |
| <span id="L950"><span class="lineNum"> 950</span> : : *</span> |
| <span id="L951"><span class="lineNum"> 951</span> : : * fdt_parent_offset() locates the parent node of a given node (that</span> |
| <span id="L952"><span class="lineNum"> 952</span> : : * is, it finds the offset of the node which contains the node at</span> |
| <span id="L953"><span class="lineNum"> 953</span> : : * nodeoffset as a subnode).</span> |
| <span id="L954"><span class="lineNum"> 954</span> : : *</span> |
| <span id="L955"><span class="lineNum"> 955</span> : : * NOTE: This function is expensive, as it must scan the device tree</span> |
| <span id="L956"><span class="lineNum"> 956</span> : : * structure from the start to nodeoffset, *twice*.</span> |
| <span id="L957"><span class="lineNum"> 957</span> : : *</span> |
| <span id="L958"><span class="lineNum"> 958</span> : : * returns:</span> |
| <span id="L959"><span class="lineNum"> 959</span> : : * structure block offset of the parent of the node at nodeoffset</span> |
| <span id="L960"><span class="lineNum"> 960</span> : : * (>=0), on success</span> |
| <span id="L961"><span class="lineNum"> 961</span> : : * -FDT_ERR_BADOFFSET, nodeoffset does not refer to a BEGIN_NODE tag</span> |
| <span id="L962"><span class="lineNum"> 962</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L963"><span class="lineNum"> 963</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L964"><span class="lineNum"> 964</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L965"><span class="lineNum"> 965</span> : : * -FDT_ERR_BADSTRUCTURE, standard meanings</span> |
| <span id="L966"><span class="lineNum"> 966</span> : : */</span> |
| <span id="L967"><span class="lineNum"> 967</span> : : int fdt_parent_offset(const void *fdt, int nodeoffset);</span> |
| <span id="L968"><span class="lineNum"> 968</span> : : </span> |
| <span id="L969"><span class="lineNum"> 969</span> : : /**</span> |
| <span id="L970"><span class="lineNum"> 970</span> : : * fdt_node_offset_by_prop_value - find nodes with a given property value</span> |
| <span id="L971"><span class="lineNum"> 971</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L972"><span class="lineNum"> 972</span> : : * @startoffset: only find nodes after this offset</span> |
| <span id="L973"><span class="lineNum"> 973</span> : : * @propname: property name to check</span> |
| <span id="L974"><span class="lineNum"> 974</span> : : * @propval: property value to search for</span> |
| <span id="L975"><span class="lineNum"> 975</span> : : * @proplen: length of the value in propval</span> |
| <span id="L976"><span class="lineNum"> 976</span> : : *</span> |
| <span id="L977"><span class="lineNum"> 977</span> : : * fdt_node_offset_by_prop_value() returns the offset of the first</span> |
| <span id="L978"><span class="lineNum"> 978</span> : : * node after startoffset, which has a property named propname whose</span> |
| <span id="L979"><span class="lineNum"> 979</span> : : * value is of length proplen and has value equal to propval; or if</span> |
| <span id="L980"><span class="lineNum"> 980</span> : : * startoffset is -1, the very first such node in the tree.</span> |
| <span id="L981"><span class="lineNum"> 981</span> : : *</span> |
| <span id="L982"><span class="lineNum"> 982</span> : : * To iterate through all nodes matching the criterion, the following</span> |
| <span id="L983"><span class="lineNum"> 983</span> : : * idiom can be used:</span> |
| <span id="L984"><span class="lineNum"> 984</span> : : * offset = fdt_node_offset_by_prop_value(fdt, -1, propname,</span> |
| <span id="L985"><span class="lineNum"> 985</span> : : * propval, proplen);</span> |
| <span id="L986"><span class="lineNum"> 986</span> : : * while (offset != -FDT_ERR_NOTFOUND) {</span> |
| <span id="L987"><span class="lineNum"> 987</span> : : * // other code here</span> |
| <span id="L988"><span class="lineNum"> 988</span> : : * offset = fdt_node_offset_by_prop_value(fdt, offset, propname,</span> |
| <span id="L989"><span class="lineNum"> 989</span> : : * propval, proplen);</span> |
| <span id="L990"><span class="lineNum"> 990</span> : : * }</span> |
| <span id="L991"><span class="lineNum"> 991</span> : : *</span> |
| <span id="L992"><span class="lineNum"> 992</span> : : * Note the -1 in the first call to the function, if 0 is used here</span> |
| <span id="L993"><span class="lineNum"> 993</span> : : * instead, the function will never locate the root node, even if it</span> |
| <span id="L994"><span class="lineNum"> 994</span> : : * matches the criterion.</span> |
| <span id="L995"><span class="lineNum"> 995</span> : : *</span> |
| <span id="L996"><span class="lineNum"> 996</span> : : * returns:</span> |
| <span id="L997"><span class="lineNum"> 997</span> : : * structure block offset of the located node (>= 0, >startoffset),</span> |
| <span id="L998"><span class="lineNum"> 998</span> : : * on success</span> |
| <span id="L999"><span class="lineNum"> 999</span> : : * -FDT_ERR_NOTFOUND, no node matching the criterion exists in the</span> |
| <span id="L1000"><span class="lineNum"> 1000</span> : : * tree after startoffset</span> |
| <span id="L1001"><span class="lineNum"> 1001</span> : : * -FDT_ERR_BADOFFSET, nodeoffset does not refer to a BEGIN_NODE tag</span> |
| <span id="L1002"><span class="lineNum"> 1002</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1003"><span class="lineNum"> 1003</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1004"><span class="lineNum"> 1004</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1005"><span class="lineNum"> 1005</span> : : * -FDT_ERR_BADSTRUCTURE, standard meanings</span> |
| <span id="L1006"><span class="lineNum"> 1006</span> : : */</span> |
| <span id="L1007"><span class="lineNum"> 1007</span> : : int fdt_node_offset_by_prop_value(const void *fdt, int startoffset,</span> |
| <span id="L1008"><span class="lineNum"> 1008</span> : : const char *propname,</span> |
| <span id="L1009"><span class="lineNum"> 1009</span> : : const void *propval, int proplen);</span> |
| <span id="L1010"><span class="lineNum"> 1010</span> : : </span> |
| <span id="L1011"><span class="lineNum"> 1011</span> : : /**</span> |
| <span id="L1012"><span class="lineNum"> 1012</span> : : * fdt_node_offset_by_phandle - find the node with a given phandle</span> |
| <span id="L1013"><span class="lineNum"> 1013</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1014"><span class="lineNum"> 1014</span> : : * @phandle: phandle value</span> |
| <span id="L1015"><span class="lineNum"> 1015</span> : : *</span> |
| <span id="L1016"><span class="lineNum"> 1016</span> : : * fdt_node_offset_by_phandle() returns the offset of the node</span> |
| <span id="L1017"><span class="lineNum"> 1017</span> : : * which has the given phandle value. If there is more than one node</span> |
| <span id="L1018"><span class="lineNum"> 1018</span> : : * in the tree with the given phandle (an invalid tree), results are</span> |
| <span id="L1019"><span class="lineNum"> 1019</span> : : * undefined.</span> |
| <span id="L1020"><span class="lineNum"> 1020</span> : : *</span> |
| <span id="L1021"><span class="lineNum"> 1021</span> : : * returns:</span> |
| <span id="L1022"><span class="lineNum"> 1022</span> : : * structure block offset of the located node (>= 0), on success</span> |
| <span id="L1023"><span class="lineNum"> 1023</span> : : * -FDT_ERR_NOTFOUND, no node with that phandle exists</span> |
| <span id="L1024"><span class="lineNum"> 1024</span> : : * -FDT_ERR_BADPHANDLE, given phandle value was invalid (0 or -1)</span> |
| <span id="L1025"><span class="lineNum"> 1025</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1026"><span class="lineNum"> 1026</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1027"><span class="lineNum"> 1027</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1028"><span class="lineNum"> 1028</span> : : * -FDT_ERR_BADSTRUCTURE, standard meanings</span> |
| <span id="L1029"><span class="lineNum"> 1029</span> : : */</span> |
| <span id="L1030"><span class="lineNum"> 1030</span> : : int fdt_node_offset_by_phandle(const void *fdt, uint32_t phandle);</span> |
| <span id="L1031"><span class="lineNum"> 1031</span> : : </span> |
| <span id="L1032"><span class="lineNum"> 1032</span> : : /**</span> |
| <span id="L1033"><span class="lineNum"> 1033</span> : : * fdt_node_check_compatible - check a node's compatible property</span> |
| <span id="L1034"><span class="lineNum"> 1034</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1035"><span class="lineNum"> 1035</span> : : * @nodeoffset: offset of a tree node</span> |
| <span id="L1036"><span class="lineNum"> 1036</span> : : * @compatible: string to match against</span> |
| <span id="L1037"><span class="lineNum"> 1037</span> : : *</span> |
| <span id="L1038"><span class="lineNum"> 1038</span> : : * fdt_node_check_compatible() returns 0 if the given node contains a</span> |
| <span id="L1039"><span class="lineNum"> 1039</span> : : * @compatible property with the given string as one of its elements,</span> |
| <span id="L1040"><span class="lineNum"> 1040</span> : : * it returns non-zero otherwise, or on error.</span> |
| <span id="L1041"><span class="lineNum"> 1041</span> : : *</span> |
| <span id="L1042"><span class="lineNum"> 1042</span> : : * returns:</span> |
| <span id="L1043"><span class="lineNum"> 1043</span> : : * 0, if the node has a 'compatible' property listing the given string</span> |
| <span id="L1044"><span class="lineNum"> 1044</span> : : * 1, if the node has a 'compatible' property, but it does not list</span> |
| <span id="L1045"><span class="lineNum"> 1045</span> : : * the given string</span> |
| <span id="L1046"><span class="lineNum"> 1046</span> : : * -FDT_ERR_NOTFOUND, if the given node has no 'compatible' property</span> |
| <span id="L1047"><span class="lineNum"> 1047</span> : : * -FDT_ERR_BADOFFSET, if nodeoffset does not refer to a BEGIN_NODE tag</span> |
| <span id="L1048"><span class="lineNum"> 1048</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1049"><span class="lineNum"> 1049</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1050"><span class="lineNum"> 1050</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1051"><span class="lineNum"> 1051</span> : : * -FDT_ERR_BADSTRUCTURE, standard meanings</span> |
| <span id="L1052"><span class="lineNum"> 1052</span> : : */</span> |
| <span id="L1053"><span class="lineNum"> 1053</span> : : int fdt_node_check_compatible(const void *fdt, int nodeoffset,</span> |
| <span id="L1054"><span class="lineNum"> 1054</span> : : const char *compatible);</span> |
| <span id="L1055"><span class="lineNum"> 1055</span> : : </span> |
| <span id="L1056"><span class="lineNum"> 1056</span> : : /**</span> |
| <span id="L1057"><span class="lineNum"> 1057</span> : : * fdt_node_offset_by_compatible - find nodes with a given 'compatible' value</span> |
| <span id="L1058"><span class="lineNum"> 1058</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1059"><span class="lineNum"> 1059</span> : : * @startoffset: only find nodes after this offset</span> |
| <span id="L1060"><span class="lineNum"> 1060</span> : : * @compatible: 'compatible' string to match against</span> |
| <span id="L1061"><span class="lineNum"> 1061</span> : : *</span> |
| <span id="L1062"><span class="lineNum"> 1062</span> : : * fdt_node_offset_by_compatible() returns the offset of the first</span> |
| <span id="L1063"><span class="lineNum"> 1063</span> : : * node after startoffset, which has a 'compatible' property which</span> |
| <span id="L1064"><span class="lineNum"> 1064</span> : : * lists the given compatible string; or if startoffset is -1, the</span> |
| <span id="L1065"><span class="lineNum"> 1065</span> : : * very first such node in the tree.</span> |
| <span id="L1066"><span class="lineNum"> 1066</span> : : *</span> |
| <span id="L1067"><span class="lineNum"> 1067</span> : : * To iterate through all nodes matching the criterion, the following</span> |
| <span id="L1068"><span class="lineNum"> 1068</span> : : * idiom can be used:</span> |
| <span id="L1069"><span class="lineNum"> 1069</span> : : * offset = fdt_node_offset_by_compatible(fdt, -1, compatible);</span> |
| <span id="L1070"><span class="lineNum"> 1070</span> : : * while (offset != -FDT_ERR_NOTFOUND) {</span> |
| <span id="L1071"><span class="lineNum"> 1071</span> : : * // other code here</span> |
| <span id="L1072"><span class="lineNum"> 1072</span> : : * offset = fdt_node_offset_by_compatible(fdt, offset, compatible);</span> |
| <span id="L1073"><span class="lineNum"> 1073</span> : : * }</span> |
| <span id="L1074"><span class="lineNum"> 1074</span> : : *</span> |
| <span id="L1075"><span class="lineNum"> 1075</span> : : * Note the -1 in the first call to the function, if 0 is used here</span> |
| <span id="L1076"><span class="lineNum"> 1076</span> : : * instead, the function will never locate the root node, even if it</span> |
| <span id="L1077"><span class="lineNum"> 1077</span> : : * matches the criterion.</span> |
| <span id="L1078"><span class="lineNum"> 1078</span> : : *</span> |
| <span id="L1079"><span class="lineNum"> 1079</span> : : * returns:</span> |
| <span id="L1080"><span class="lineNum"> 1080</span> : : * structure block offset of the located node (>= 0, >startoffset),</span> |
| <span id="L1081"><span class="lineNum"> 1081</span> : : * on success</span> |
| <span id="L1082"><span class="lineNum"> 1082</span> : : * -FDT_ERR_NOTFOUND, no node matching the criterion exists in the</span> |
| <span id="L1083"><span class="lineNum"> 1083</span> : : * tree after startoffset</span> |
| <span id="L1084"><span class="lineNum"> 1084</span> : : * -FDT_ERR_BADOFFSET, nodeoffset does not refer to a BEGIN_NODE tag</span> |
| <span id="L1085"><span class="lineNum"> 1085</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1086"><span class="lineNum"> 1086</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1087"><span class="lineNum"> 1087</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1088"><span class="lineNum"> 1088</span> : : * -FDT_ERR_BADSTRUCTURE, standard meanings</span> |
| <span id="L1089"><span class="lineNum"> 1089</span> : : */</span> |
| <span id="L1090"><span class="lineNum"> 1090</span> : : int fdt_node_offset_by_compatible(const void *fdt, int startoffset,</span> |
| <span id="L1091"><span class="lineNum"> 1091</span> : : const char *compatible);</span> |
| <span id="L1092"><span class="lineNum"> 1092</span> : : </span> |
| <span id="L1093"><span class="lineNum"> 1093</span> : : /**</span> |
| <span id="L1094"><span class="lineNum"> 1094</span> : : * fdt_stringlist_contains - check a string list property for a string</span> |
| <span id="L1095"><span class="lineNum"> 1095</span> : : * @strlist: Property containing a list of strings to check</span> |
| <span id="L1096"><span class="lineNum"> 1096</span> : : * @listlen: Length of property</span> |
| <span id="L1097"><span class="lineNum"> 1097</span> : : * @str: String to search for</span> |
| <span id="L1098"><span class="lineNum"> 1098</span> : : *</span> |
| <span id="L1099"><span class="lineNum"> 1099</span> : : * This is a utility function provided for convenience. The list contains</span> |
| <span id="L1100"><span class="lineNum"> 1100</span> : : * one or more strings, each terminated by \0, as is found in a device tree</span> |
| <span id="L1101"><span class="lineNum"> 1101</span> : : * "compatible" property.</span> |
| <span id="L1102"><span class="lineNum"> 1102</span> : : *</span> |
| <span id="L1103"><span class="lineNum"> 1103</span> : : * Return: 1 if the string is found in the list, 0 not found, or invalid list</span> |
| <span id="L1104"><span class="lineNum"> 1104</span> : : */</span> |
| <span id="L1105"><span class="lineNum"> 1105</span> : : int fdt_stringlist_contains(const char *strlist, int listlen, const char *str);</span> |
| <span id="L1106"><span class="lineNum"> 1106</span> : : </span> |
| <span id="L1107"><span class="lineNum"> 1107</span> : : /**</span> |
| <span id="L1108"><span class="lineNum"> 1108</span> : : * fdt_stringlist_count - count the number of strings in a string list</span> |
| <span id="L1109"><span class="lineNum"> 1109</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1110"><span class="lineNum"> 1110</span> : : * @nodeoffset: offset of a tree node</span> |
| <span id="L1111"><span class="lineNum"> 1111</span> : : * @property: name of the property containing the string list</span> |
| <span id="L1112"><span class="lineNum"> 1112</span> : : *</span> |
| <span id="L1113"><span class="lineNum"> 1113</span> : : * Return:</span> |
| <span id="L1114"><span class="lineNum"> 1114</span> : : * the number of strings in the given property</span> |
| <span id="L1115"><span class="lineNum"> 1115</span> : : * -FDT_ERR_BADVALUE if the property value is not NUL-terminated</span> |
| <span id="L1116"><span class="lineNum"> 1116</span> : : * -FDT_ERR_NOTFOUND if the property does not exist</span> |
| <span id="L1117"><span class="lineNum"> 1117</span> : : */</span> |
| <span id="L1118"><span class="lineNum"> 1118</span> : : int fdt_stringlist_count(const void *fdt, int nodeoffset, const char *property);</span> |
| <span id="L1119"><span class="lineNum"> 1119</span> : : </span> |
| <span id="L1120"><span class="lineNum"> 1120</span> : : /**</span> |
| <span id="L1121"><span class="lineNum"> 1121</span> : : * fdt_stringlist_search - find a string in a string list and return its index</span> |
| <span id="L1122"><span class="lineNum"> 1122</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1123"><span class="lineNum"> 1123</span> : : * @nodeoffset: offset of a tree node</span> |
| <span id="L1124"><span class="lineNum"> 1124</span> : : * @property: name of the property containing the string list</span> |
| <span id="L1125"><span class="lineNum"> 1125</span> : : * @string: string to look up in the string list</span> |
| <span id="L1126"><span class="lineNum"> 1126</span> : : *</span> |
| <span id="L1127"><span class="lineNum"> 1127</span> : : * Note that it is possible for this function to succeed on property values</span> |
| <span id="L1128"><span class="lineNum"> 1128</span> : : * that are not NUL-terminated. That's because the function will stop after</span> |
| <span id="L1129"><span class="lineNum"> 1129</span> : : * finding the first occurrence of @string. This can for example happen with</span> |
| <span id="L1130"><span class="lineNum"> 1130</span> : : * small-valued cell properties, such as #address-cells, when searching for</span> |
| <span id="L1131"><span class="lineNum"> 1131</span> : : * the empty string.</span> |
| <span id="L1132"><span class="lineNum"> 1132</span> : : *</span> |
| <span id="L1133"><span class="lineNum"> 1133</span> : : * return:</span> |
| <span id="L1134"><span class="lineNum"> 1134</span> : : * the index of the string in the list of strings</span> |
| <span id="L1135"><span class="lineNum"> 1135</span> : : * -FDT_ERR_BADVALUE if the property value is not NUL-terminated</span> |
| <span id="L1136"><span class="lineNum"> 1136</span> : : * -FDT_ERR_NOTFOUND if the property does not exist or does not contain</span> |
| <span id="L1137"><span class="lineNum"> 1137</span> : : * the given string</span> |
| <span id="L1138"><span class="lineNum"> 1138</span> : : */</span> |
| <span id="L1139"><span class="lineNum"> 1139</span> : : int fdt_stringlist_search(const void *fdt, int nodeoffset, const char *property,</span> |
| <span id="L1140"><span class="lineNum"> 1140</span> : : const char *string);</span> |
| <span id="L1141"><span class="lineNum"> 1141</span> : : </span> |
| <span id="L1142"><span class="lineNum"> 1142</span> : : /**</span> |
| <span id="L1143"><span class="lineNum"> 1143</span> : : * fdt_stringlist_get() - obtain the string at a given index in a string list</span> |
| <span id="L1144"><span class="lineNum"> 1144</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1145"><span class="lineNum"> 1145</span> : : * @nodeoffset: offset of a tree node</span> |
| <span id="L1146"><span class="lineNum"> 1146</span> : : * @property: name of the property containing the string list</span> |
| <span id="L1147"><span class="lineNum"> 1147</span> : : * @index: index of the string to return</span> |
| <span id="L1148"><span class="lineNum"> 1148</span> : : * @lenp: return location for the string length or an error code on failure</span> |
| <span id="L1149"><span class="lineNum"> 1149</span> : : *</span> |
| <span id="L1150"><span class="lineNum"> 1150</span> : : * Note that this will successfully extract strings from properties with</span> |
| <span id="L1151"><span class="lineNum"> 1151</span> : : * non-NUL-terminated values. For example on small-valued cell properties</span> |
| <span id="L1152"><span class="lineNum"> 1152</span> : : * this function will return the empty string.</span> |
| <span id="L1153"><span class="lineNum"> 1153</span> : : *</span> |
| <span id="L1154"><span class="lineNum"> 1154</span> : : * If non-NULL, the length of the string (on success) or a negative error-code</span> |
| <span id="L1155"><span class="lineNum"> 1155</span> : : * (on failure) will be stored in the integer pointer to by lenp.</span> |
| <span id="L1156"><span class="lineNum"> 1156</span> : : *</span> |
| <span id="L1157"><span class="lineNum"> 1157</span> : : * Return:</span> |
| <span id="L1158"><span class="lineNum"> 1158</span> : : * A pointer to the string at the given index in the string list or NULL on</span> |
| <span id="L1159"><span class="lineNum"> 1159</span> : : * failure. On success the length of the string will be stored in the memory</span> |
| <span id="L1160"><span class="lineNum"> 1160</span> : : * location pointed to by the lenp parameter, if non-NULL. On failure one of</span> |
| <span id="L1161"><span class="lineNum"> 1161</span> : : * the following negative error codes will be returned in the lenp parameter</span> |
| <span id="L1162"><span class="lineNum"> 1162</span> : : * (if non-NULL):</span> |
| <span id="L1163"><span class="lineNum"> 1163</span> : : * -FDT_ERR_BADVALUE if the property value is not NUL-terminated</span> |
| <span id="L1164"><span class="lineNum"> 1164</span> : : * -FDT_ERR_NOTFOUND if the property does not exist</span> |
| <span id="L1165"><span class="lineNum"> 1165</span> : : */</span> |
| <span id="L1166"><span class="lineNum"> 1166</span> : : const char *fdt_stringlist_get(const void *fdt, int nodeoffset,</span> |
| <span id="L1167"><span class="lineNum"> 1167</span> : : const char *property, int index,</span> |
| <span id="L1168"><span class="lineNum"> 1168</span> : : int *lenp);</span> |
| <span id="L1169"><span class="lineNum"> 1169</span> : : </span> |
| <span id="L1170"><span class="lineNum"> 1170</span> : : /**********************************************************************/</span> |
| <span id="L1171"><span class="lineNum"> 1171</span> : : /* Read-only functions (addressing related) */</span> |
| <span id="L1172"><span class="lineNum"> 1172</span> : : /**********************************************************************/</span> |
| <span id="L1173"><span class="lineNum"> 1173</span> : : </span> |
| <span id="L1174"><span class="lineNum"> 1174</span> : : /**</span> |
| <span id="L1175"><span class="lineNum"> 1175</span> : : * FDT_MAX_NCELLS - maximum value for #address-cells and #size-cells</span> |
| <span id="L1176"><span class="lineNum"> 1176</span> : : *</span> |
| <span id="L1177"><span class="lineNum"> 1177</span> : : * This is the maximum value for #address-cells, #size-cells and</span> |
| <span id="L1178"><span class="lineNum"> 1178</span> : : * similar properties that will be processed by libfdt. IEE1275</span> |
| <span id="L1179"><span class="lineNum"> 1179</span> : : * requires that OF implementations handle values up to 4.</span> |
| <span id="L1180"><span class="lineNum"> 1180</span> : : * Implementations may support larger values, but in practice higher</span> |
| <span id="L1181"><span class="lineNum"> 1181</span> : : * values aren't used.</span> |
| <span id="L1182"><span class="lineNum"> 1182</span> : : */</span> |
| <span id="L1183"><span class="lineNum"> 1183</span> : : #define FDT_MAX_NCELLS 4</span> |
| <span id="L1184"><span class="lineNum"> 1184</span> : : </span> |
| <span id="L1185"><span class="lineNum"> 1185</span> : : /**</span> |
| <span id="L1186"><span class="lineNum"> 1186</span> : : * fdt_address_cells - retrieve address size for a bus represented in the tree</span> |
| <span id="L1187"><span class="lineNum"> 1187</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1188"><span class="lineNum"> 1188</span> : : * @nodeoffset: offset of the node to find the address size for</span> |
| <span id="L1189"><span class="lineNum"> 1189</span> : : *</span> |
| <span id="L1190"><span class="lineNum"> 1190</span> : : * When the node has a valid #address-cells property, returns its value.</span> |
| <span id="L1191"><span class="lineNum"> 1191</span> : : *</span> |
| <span id="L1192"><span class="lineNum"> 1192</span> : : * returns:</span> |
| <span id="L1193"><span class="lineNum"> 1193</span> : : * 0 <= n < FDT_MAX_NCELLS, on success</span> |
| <span id="L1194"><span class="lineNum"> 1194</span> : : * 2, if the node has no #address-cells property</span> |
| <span id="L1195"><span class="lineNum"> 1195</span> : : * -FDT_ERR_BADNCELLS, if the node has a badly formatted or invalid</span> |
| <span id="L1196"><span class="lineNum"> 1196</span> : : * #address-cells property</span> |
| <span id="L1197"><span class="lineNum"> 1197</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1198"><span class="lineNum"> 1198</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1199"><span class="lineNum"> 1199</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1200"><span class="lineNum"> 1200</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1201"><span class="lineNum"> 1201</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1202"><span class="lineNum"> 1202</span> : : */</span> |
| <span id="L1203"><span class="lineNum"> 1203</span> : : int fdt_address_cells(const void *fdt, int nodeoffset);</span> |
| <span id="L1204"><span class="lineNum"> 1204</span> : : </span> |
| <span id="L1205"><span class="lineNum"> 1205</span> : : /**</span> |
| <span id="L1206"><span class="lineNum"> 1206</span> : : * fdt_size_cells - retrieve address range size for a bus represented in the</span> |
| <span id="L1207"><span class="lineNum"> 1207</span> : : * tree</span> |
| <span id="L1208"><span class="lineNum"> 1208</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1209"><span class="lineNum"> 1209</span> : : * @nodeoffset: offset of the node to find the address range size for</span> |
| <span id="L1210"><span class="lineNum"> 1210</span> : : *</span> |
| <span id="L1211"><span class="lineNum"> 1211</span> : : * When the node has a valid #size-cells property, returns its value.</span> |
| <span id="L1212"><span class="lineNum"> 1212</span> : : *</span> |
| <span id="L1213"><span class="lineNum"> 1213</span> : : * returns:</span> |
| <span id="L1214"><span class="lineNum"> 1214</span> : : * 0 <= n < FDT_MAX_NCELLS, on success</span> |
| <span id="L1215"><span class="lineNum"> 1215</span> : : * 1, if the node has no #size-cells property</span> |
| <span id="L1216"><span class="lineNum"> 1216</span> : : * -FDT_ERR_BADNCELLS, if the node has a badly formatted or invalid</span> |
| <span id="L1217"><span class="lineNum"> 1217</span> : : * #size-cells property</span> |
| <span id="L1218"><span class="lineNum"> 1218</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1219"><span class="lineNum"> 1219</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1220"><span class="lineNum"> 1220</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1221"><span class="lineNum"> 1221</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1222"><span class="lineNum"> 1222</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1223"><span class="lineNum"> 1223</span> : : */</span> |
| <span id="L1224"><span class="lineNum"> 1224</span> : : int fdt_size_cells(const void *fdt, int nodeoffset);</span> |
| <span id="L1225"><span class="lineNum"> 1225</span> : : </span> |
| <span id="L1226"><span class="lineNum"> 1226</span> : : </span> |
| <span id="L1227"><span class="lineNum"> 1227</span> : : /**********************************************************************/</span> |
| <span id="L1228"><span class="lineNum"> 1228</span> : : /* Write-in-place functions */</span> |
| <span id="L1229"><span class="lineNum"> 1229</span> : : /**********************************************************************/</span> |
| <span id="L1230"><span class="lineNum"> 1230</span> : : </span> |
| <span id="L1231"><span class="lineNum"> 1231</span> : : /**</span> |
| <span id="L1232"><span class="lineNum"> 1232</span> : : * fdt_setprop_inplace_namelen_partial - change a property's value,</span> |
| <span id="L1233"><span class="lineNum"> 1233</span> : : * but not its size</span> |
| <span id="L1234"><span class="lineNum"> 1234</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1235"><span class="lineNum"> 1235</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1236"><span class="lineNum"> 1236</span> : : * @name: name of the property to change</span> |
| <span id="L1237"><span class="lineNum"> 1237</span> : : * @namelen: number of characters of name to consider</span> |
| <span id="L1238"><span class="lineNum"> 1238</span> : : * @idx: index of the property to change in the array</span> |
| <span id="L1239"><span class="lineNum"> 1239</span> : : * @val: pointer to data to replace the property value with</span> |
| <span id="L1240"><span class="lineNum"> 1240</span> : : * @len: length of the property value</span> |
| <span id="L1241"><span class="lineNum"> 1241</span> : : *</span> |
| <span id="L1242"><span class="lineNum"> 1242</span> : : * Identical to fdt_setprop_inplace(), but modifies the given property</span> |
| <span id="L1243"><span class="lineNum"> 1243</span> : : * starting from the given index, and using only the first characters</span> |
| <span id="L1244"><span class="lineNum"> 1244</span> : : * of the name. It is useful when you want to manipulate only one value of</span> |
| <span id="L1245"><span class="lineNum"> 1245</span> : : * an array and you have a string that doesn't end with \0.</span> |
| <span id="L1246"><span class="lineNum"> 1246</span> : : *</span> |
| <span id="L1247"><span class="lineNum"> 1247</span> : : * Return: 0 on success, negative libfdt error value otherwise</span> |
| <span id="L1248"><span class="lineNum"> 1248</span> : : */</span> |
| <span id="L1249"><span class="lineNum"> 1249</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L1250"><span class="lineNum"> 1250</span> : : int fdt_setprop_inplace_namelen_partial(void *fdt, int nodeoffset,</span> |
| <span id="L1251"><span class="lineNum"> 1251</span> : : const char *name, int namelen,</span> |
| <span id="L1252"><span class="lineNum"> 1252</span> : : uint32_t idx, const void *val,</span> |
| <span id="L1253"><span class="lineNum"> 1253</span> : : int len);</span> |
| <span id="L1254"><span class="lineNum"> 1254</span> : : #endif</span> |
| <span id="L1255"><span class="lineNum"> 1255</span> : : </span> |
| <span id="L1256"><span class="lineNum"> 1256</span> : : /**</span> |
| <span id="L1257"><span class="lineNum"> 1257</span> : : * fdt_setprop_inplace - change a property's value, but not its size</span> |
| <span id="L1258"><span class="lineNum"> 1258</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1259"><span class="lineNum"> 1259</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1260"><span class="lineNum"> 1260</span> : : * @name: name of the property to change</span> |
| <span id="L1261"><span class="lineNum"> 1261</span> : : * @val: pointer to data to replace the property value with</span> |
| <span id="L1262"><span class="lineNum"> 1262</span> : : * @len: length of the property value</span> |
| <span id="L1263"><span class="lineNum"> 1263</span> : : *</span> |
| <span id="L1264"><span class="lineNum"> 1264</span> : : * fdt_setprop_inplace() replaces the value of a given property with</span> |
| <span id="L1265"><span class="lineNum"> 1265</span> : : * the data in val, of length len. This function cannot change the</span> |
| <span id="L1266"><span class="lineNum"> 1266</span> : : * size of a property, and so will only work if len is equal to the</span> |
| <span id="L1267"><span class="lineNum"> 1267</span> : : * current length of the property.</span> |
| <span id="L1268"><span class="lineNum"> 1268</span> : : *</span> |
| <span id="L1269"><span class="lineNum"> 1269</span> : : * This function will alter only the bytes in the blob which contain</span> |
| <span id="L1270"><span class="lineNum"> 1270</span> : : * the given property value, and will not alter or move any other part</span> |
| <span id="L1271"><span class="lineNum"> 1271</span> : : * of the tree.</span> |
| <span id="L1272"><span class="lineNum"> 1272</span> : : *</span> |
| <span id="L1273"><span class="lineNum"> 1273</span> : : * returns:</span> |
| <span id="L1274"><span class="lineNum"> 1274</span> : : * 0, on success</span> |
| <span id="L1275"><span class="lineNum"> 1275</span> : : * -FDT_ERR_NOSPACE, if len is not equal to the property's current length</span> |
| <span id="L1276"><span class="lineNum"> 1276</span> : : * -FDT_ERR_NOTFOUND, node does not have the named property</span> |
| <span id="L1277"><span class="lineNum"> 1277</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1278"><span class="lineNum"> 1278</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1279"><span class="lineNum"> 1279</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1280"><span class="lineNum"> 1280</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1281"><span class="lineNum"> 1281</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1282"><span class="lineNum"> 1282</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1283"><span class="lineNum"> 1283</span> : : */</span> |
| <span id="L1284"><span class="lineNum"> 1284</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L1285"><span class="lineNum"> 1285</span> : : int fdt_setprop_inplace(void *fdt, int nodeoffset, const char *name,</span> |
| <span id="L1286"><span class="lineNum"> 1286</span> : : const void *val, int len);</span> |
| <span id="L1287"><span class="lineNum"> 1287</span> : : #endif</span> |
| <span id="L1288"><span class="lineNum"> 1288</span> : : </span> |
| <span id="L1289"><span class="lineNum"> 1289</span> : : /**</span> |
| <span id="L1290"><span class="lineNum"> 1290</span> : : * fdt_setprop_inplace_u32 - change the value of a 32-bit integer property</span> |
| <span id="L1291"><span class="lineNum"> 1291</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1292"><span class="lineNum"> 1292</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1293"><span class="lineNum"> 1293</span> : : * @name: name of the property to change</span> |
| <span id="L1294"><span class="lineNum"> 1294</span> : : * @val: 32-bit integer value to replace the property with</span> |
| <span id="L1295"><span class="lineNum"> 1295</span> : : *</span> |
| <span id="L1296"><span class="lineNum"> 1296</span> : : * fdt_setprop_inplace_u32() replaces the value of a given property</span> |
| <span id="L1297"><span class="lineNum"> 1297</span> : : * with the 32-bit integer value in val, converting val to big-endian</span> |
| <span id="L1298"><span class="lineNum"> 1298</span> : : * if necessary. This function cannot change the size of a property,</span> |
| <span id="L1299"><span class="lineNum"> 1299</span> : : * and so will only work if the property already exists and has length</span> |
| <span id="L1300"><span class="lineNum"> 1300</span> : : * 4.</span> |
| <span id="L1301"><span class="lineNum"> 1301</span> : : *</span> |
| <span id="L1302"><span class="lineNum"> 1302</span> : : * This function will alter only the bytes in the blob which contain</span> |
| <span id="L1303"><span class="lineNum"> 1303</span> : : * the given property value, and will not alter or move any other part</span> |
| <span id="L1304"><span class="lineNum"> 1304</span> : : * of the tree.</span> |
| <span id="L1305"><span class="lineNum"> 1305</span> : : *</span> |
| <span id="L1306"><span class="lineNum"> 1306</span> : : * returns:</span> |
| <span id="L1307"><span class="lineNum"> 1307</span> : : * 0, on success</span> |
| <span id="L1308"><span class="lineNum"> 1308</span> : : * -FDT_ERR_NOSPACE, if the property's length is not equal to 4</span> |
| <span id="L1309"><span class="lineNum"> 1309</span> : : * -FDT_ERR_NOTFOUND, node does not have the named property</span> |
| <span id="L1310"><span class="lineNum"> 1310</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1311"><span class="lineNum"> 1311</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1312"><span class="lineNum"> 1312</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1313"><span class="lineNum"> 1313</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1314"><span class="lineNum"> 1314</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1315"><span class="lineNum"> 1315</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1316"><span class="lineNum"> 1316</span> : : */</span> |
| <span id="L1317"><span class="lineNum"> 1317</span> : : static inline int fdt_setprop_inplace_u32(void *fdt, int nodeoffset,</span> |
| <span id="L1318"><span class="lineNum"> 1318</span> : : const char *name, uint32_t val)</span> |
| <span id="L1319"><span class="lineNum"> 1319</span> : : {</span> |
| <span id="L1320"><span class="lineNum"> 1320</span> : : fdt32_t tmp = cpu_to_fdt32(val);</span> |
| <span id="L1321"><span class="lineNum"> 1321</span> : : return fdt_setprop_inplace(fdt, nodeoffset, name, &tmp, sizeof(tmp));</span> |
| <span id="L1322"><span class="lineNum"> 1322</span> : : }</span> |
| <span id="L1323"><span class="lineNum"> 1323</span> : : </span> |
| <span id="L1324"><span class="lineNum"> 1324</span> : : /**</span> |
| <span id="L1325"><span class="lineNum"> 1325</span> : : * fdt_setprop_inplace_u64 - change the value of a 64-bit integer property</span> |
| <span id="L1326"><span class="lineNum"> 1326</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1327"><span class="lineNum"> 1327</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1328"><span class="lineNum"> 1328</span> : : * @name: name of the property to change</span> |
| <span id="L1329"><span class="lineNum"> 1329</span> : : * @val: 64-bit integer value to replace the property with</span> |
| <span id="L1330"><span class="lineNum"> 1330</span> : : *</span> |
| <span id="L1331"><span class="lineNum"> 1331</span> : : * fdt_setprop_inplace_u64() replaces the value of a given property</span> |
| <span id="L1332"><span class="lineNum"> 1332</span> : : * with the 64-bit integer value in val, converting val to big-endian</span> |
| <span id="L1333"><span class="lineNum"> 1333</span> : : * if necessary. This function cannot change the size of a property,</span> |
| <span id="L1334"><span class="lineNum"> 1334</span> : : * and so will only work if the property already exists and has length</span> |
| <span id="L1335"><span class="lineNum"> 1335</span> : : * 8.</span> |
| <span id="L1336"><span class="lineNum"> 1336</span> : : *</span> |
| <span id="L1337"><span class="lineNum"> 1337</span> : : * This function will alter only the bytes in the blob which contain</span> |
| <span id="L1338"><span class="lineNum"> 1338</span> : : * the given property value, and will not alter or move any other part</span> |
| <span id="L1339"><span class="lineNum"> 1339</span> : : * of the tree.</span> |
| <span id="L1340"><span class="lineNum"> 1340</span> : : *</span> |
| <span id="L1341"><span class="lineNum"> 1341</span> : : * returns:</span> |
| <span id="L1342"><span class="lineNum"> 1342</span> : : * 0, on success</span> |
| <span id="L1343"><span class="lineNum"> 1343</span> : : * -FDT_ERR_NOSPACE, if the property's length is not equal to 8</span> |
| <span id="L1344"><span class="lineNum"> 1344</span> : : * -FDT_ERR_NOTFOUND, node does not have the named property</span> |
| <span id="L1345"><span class="lineNum"> 1345</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1346"><span class="lineNum"> 1346</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1347"><span class="lineNum"> 1347</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1348"><span class="lineNum"> 1348</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1349"><span class="lineNum"> 1349</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1350"><span class="lineNum"> 1350</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1351"><span class="lineNum"> 1351</span> : : */</span> |
| <span id="L1352"><span class="lineNum"> 1352</span> : : static inline int fdt_setprop_inplace_u64(void *fdt, int nodeoffset,</span> |
| <span id="L1353"><span class="lineNum"> 1353</span> : : const char *name, uint64_t val)</span> |
| <span id="L1354"><span class="lineNum"> 1354</span> : : {</span> |
| <span id="L1355"><span class="lineNum"> 1355</span> : : fdt64_t tmp = cpu_to_fdt64(val);</span> |
| <span id="L1356"><span class="lineNum"> 1356</span> : : return fdt_setprop_inplace(fdt, nodeoffset, name, &tmp, sizeof(tmp));</span> |
| <span id="L1357"><span class="lineNum"> 1357</span> : : }</span> |
| <span id="L1358"><span class="lineNum"> 1358</span> : : </span> |
| <span id="L1359"><span class="lineNum"> 1359</span> : : /**</span> |
| <span id="L1360"><span class="lineNum"> 1360</span> : : * fdt_setprop_inplace_cell - change the value of a single-cell property</span> |
| <span id="L1361"><span class="lineNum"> 1361</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1362"><span class="lineNum"> 1362</span> : : * @nodeoffset: offset of the node containing the property</span> |
| <span id="L1363"><span class="lineNum"> 1363</span> : : * @name: name of the property to change the value of</span> |
| <span id="L1364"><span class="lineNum"> 1364</span> : : * @val: new value of the 32-bit cell</span> |
| <span id="L1365"><span class="lineNum"> 1365</span> : : *</span> |
| <span id="L1366"><span class="lineNum"> 1366</span> : : * This is an alternative name for fdt_setprop_inplace_u32()</span> |
| <span id="L1367"><span class="lineNum"> 1367</span> : : * Return: 0 on success, negative libfdt error number otherwise.</span> |
| <span id="L1368"><span class="lineNum"> 1368</span> : : */</span> |
| <span id="L1369"><span class="lineNum"> 1369</span> : : static inline int fdt_setprop_inplace_cell(void *fdt, int nodeoffset,</span> |
| <span id="L1370"><span class="lineNum"> 1370</span> : : const char *name, uint32_t val)</span> |
| <span id="L1371"><span class="lineNum"> 1371</span> : : {</span> |
| <span id="L1372"><span class="lineNum"> 1372</span> : : return fdt_setprop_inplace_u32(fdt, nodeoffset, name, val);</span> |
| <span id="L1373"><span class="lineNum"> 1373</span> : : }</span> |
| <span id="L1374"><span class="lineNum"> 1374</span> : : </span> |
| <span id="L1375"><span class="lineNum"> 1375</span> : : /**</span> |
| <span id="L1376"><span class="lineNum"> 1376</span> : : * fdt_nop_property - replace a property with nop tags</span> |
| <span id="L1377"><span class="lineNum"> 1377</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1378"><span class="lineNum"> 1378</span> : : * @nodeoffset: offset of the node whose property to nop</span> |
| <span id="L1379"><span class="lineNum"> 1379</span> : : * @name: name of the property to nop</span> |
| <span id="L1380"><span class="lineNum"> 1380</span> : : *</span> |
| <span id="L1381"><span class="lineNum"> 1381</span> : : * fdt_nop_property() will replace a given property's representation</span> |
| <span id="L1382"><span class="lineNum"> 1382</span> : : * in the blob with FDT_NOP tags, effectively removing it from the</span> |
| <span id="L1383"><span class="lineNum"> 1383</span> : : * tree.</span> |
| <span id="L1384"><span class="lineNum"> 1384</span> : : *</span> |
| <span id="L1385"><span class="lineNum"> 1385</span> : : * This function will alter only the bytes in the blob which contain</span> |
| <span id="L1386"><span class="lineNum"> 1386</span> : : * the property, and will not alter or move any other part of the</span> |
| <span id="L1387"><span class="lineNum"> 1387</span> : : * tree.</span> |
| <span id="L1388"><span class="lineNum"> 1388</span> : : *</span> |
| <span id="L1389"><span class="lineNum"> 1389</span> : : * returns:</span> |
| <span id="L1390"><span class="lineNum"> 1390</span> : : * 0, on success</span> |
| <span id="L1391"><span class="lineNum"> 1391</span> : : * -FDT_ERR_NOTFOUND, node does not have the named property</span> |
| <span id="L1392"><span class="lineNum"> 1392</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1393"><span class="lineNum"> 1393</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1394"><span class="lineNum"> 1394</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1395"><span class="lineNum"> 1395</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1396"><span class="lineNum"> 1396</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1397"><span class="lineNum"> 1397</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1398"><span class="lineNum"> 1398</span> : : */</span> |
| <span id="L1399"><span class="lineNum"> 1399</span> : : int fdt_nop_property(void *fdt, int nodeoffset, const char *name);</span> |
| <span id="L1400"><span class="lineNum"> 1400</span> : : </span> |
| <span id="L1401"><span class="lineNum"> 1401</span> : : /**</span> |
| <span id="L1402"><span class="lineNum"> 1402</span> : : * fdt_nop_node - replace a node (subtree) with nop tags</span> |
| <span id="L1403"><span class="lineNum"> 1403</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1404"><span class="lineNum"> 1404</span> : : * @nodeoffset: offset of the node to nop</span> |
| <span id="L1405"><span class="lineNum"> 1405</span> : : *</span> |
| <span id="L1406"><span class="lineNum"> 1406</span> : : * fdt_nop_node() will replace a given node's representation in the</span> |
| <span id="L1407"><span class="lineNum"> 1407</span> : : * blob, including all its subnodes, if any, with FDT_NOP tags,</span> |
| <span id="L1408"><span class="lineNum"> 1408</span> : : * effectively removing it from the tree.</span> |
| <span id="L1409"><span class="lineNum"> 1409</span> : : *</span> |
| <span id="L1410"><span class="lineNum"> 1410</span> : : * This function will alter only the bytes in the blob which contain</span> |
| <span id="L1411"><span class="lineNum"> 1411</span> : : * the node and its properties and subnodes, and will not alter or</span> |
| <span id="L1412"><span class="lineNum"> 1412</span> : : * move any other part of the tree.</span> |
| <span id="L1413"><span class="lineNum"> 1413</span> : : *</span> |
| <span id="L1414"><span class="lineNum"> 1414</span> : : * returns:</span> |
| <span id="L1415"><span class="lineNum"> 1415</span> : : * 0, on success</span> |
| <span id="L1416"><span class="lineNum"> 1416</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1417"><span class="lineNum"> 1417</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1418"><span class="lineNum"> 1418</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1419"><span class="lineNum"> 1419</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1420"><span class="lineNum"> 1420</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1421"><span class="lineNum"> 1421</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1422"><span class="lineNum"> 1422</span> : : */</span> |
| <span id="L1423"><span class="lineNum"> 1423</span> : : int fdt_nop_node(void *fdt, int nodeoffset);</span> |
| <span id="L1424"><span class="lineNum"> 1424</span> : : </span> |
| <span id="L1425"><span class="lineNum"> 1425</span> : : /**********************************************************************/</span> |
| <span id="L1426"><span class="lineNum"> 1426</span> : : /* Sequential write functions */</span> |
| <span id="L1427"><span class="lineNum"> 1427</span> : : /**********************************************************************/</span> |
| <span id="L1428"><span class="lineNum"> 1428</span> : : </span> |
| <span id="L1429"><span class="lineNum"> 1429</span> : : /* fdt_create_with_flags flags */</span> |
| <span id="L1430"><span class="lineNum"> 1430</span> : : #define FDT_CREATE_FLAG_NO_NAME_DEDUP 0x1</span> |
| <span id="L1431"><span class="lineNum"> 1431</span> : : /* FDT_CREATE_FLAG_NO_NAME_DEDUP: Do not try to de-duplicate property</span> |
| <span id="L1432"><span class="lineNum"> 1432</span> : : * names in the fdt. This can result in faster creation times, but</span> |
| <span id="L1433"><span class="lineNum"> 1433</span> : : * a larger fdt. */</span> |
| <span id="L1434"><span class="lineNum"> 1434</span> : : </span> |
| <span id="L1435"><span class="lineNum"> 1435</span> : : #define FDT_CREATE_FLAGS_ALL (FDT_CREATE_FLAG_NO_NAME_DEDUP)</span> |
| <span id="L1436"><span class="lineNum"> 1436</span> : : </span> |
| <span id="L1437"><span class="lineNum"> 1437</span> : : /**</span> |
| <span id="L1438"><span class="lineNum"> 1438</span> : : * fdt_create_with_flags - begin creation of a new fdt</span> |
| <span id="L1439"><span class="lineNum"> 1439</span> : : * @buf: pointer to memory allocated where fdt will be created</span> |
| <span id="L1440"><span class="lineNum"> 1440</span> : : * @bufsize: size of the memory space at fdt</span> |
| <span id="L1441"><span class="lineNum"> 1441</span> : : * @flags: a valid combination of FDT_CREATE_FLAG_ flags, or 0.</span> |
| <span id="L1442"><span class="lineNum"> 1442</span> : : *</span> |
| <span id="L1443"><span class="lineNum"> 1443</span> : : * fdt_create_with_flags() begins the process of creating a new fdt with</span> |
| <span id="L1444"><span class="lineNum"> 1444</span> : : * the sequential write interface.</span> |
| <span id="L1445"><span class="lineNum"> 1445</span> : : *</span> |
| <span id="L1446"><span class="lineNum"> 1446</span> : : * fdt creation process must end with fdt_finished() to produce a valid fdt.</span> |
| <span id="L1447"><span class="lineNum"> 1447</span> : : *</span> |
| <span id="L1448"><span class="lineNum"> 1448</span> : : * returns:</span> |
| <span id="L1449"><span class="lineNum"> 1449</span> : : * 0, on success</span> |
| <span id="L1450"><span class="lineNum"> 1450</span> : : * -FDT_ERR_NOSPACE, bufsize is insufficient for a minimal fdt</span> |
| <span id="L1451"><span class="lineNum"> 1451</span> : : * -FDT_ERR_BADFLAGS, flags is not valid</span> |
| <span id="L1452"><span class="lineNum"> 1452</span> : : */</span> |
| <span id="L1453"><span class="lineNum"> 1453</span> : : int fdt_create_with_flags(void *buf, int bufsize, uint32_t flags);</span> |
| <span id="L1454"><span class="lineNum"> 1454</span> : : </span> |
| <span id="L1455"><span class="lineNum"> 1455</span> : : /**</span> |
| <span id="L1456"><span class="lineNum"> 1456</span> : : * fdt_create - begin creation of a new fdt</span> |
| <span id="L1457"><span class="lineNum"> 1457</span> : : * @buf: pointer to memory allocated where fdt will be created</span> |
| <span id="L1458"><span class="lineNum"> 1458</span> : : * @bufsize: size of the memory space at fdt</span> |
| <span id="L1459"><span class="lineNum"> 1459</span> : : *</span> |
| <span id="L1460"><span class="lineNum"> 1460</span> : : * fdt_create() is equivalent to fdt_create_with_flags() with flags=0.</span> |
| <span id="L1461"><span class="lineNum"> 1461</span> : : *</span> |
| <span id="L1462"><span class="lineNum"> 1462</span> : : * returns:</span> |
| <span id="L1463"><span class="lineNum"> 1463</span> : : * 0, on success</span> |
| <span id="L1464"><span class="lineNum"> 1464</span> : : * -FDT_ERR_NOSPACE, bufsize is insufficient for a minimal fdt</span> |
| <span id="L1465"><span class="lineNum"> 1465</span> : : */</span> |
| <span id="L1466"><span class="lineNum"> 1466</span> : : int fdt_create(void *buf, int bufsize);</span> |
| <span id="L1467"><span class="lineNum"> 1467</span> : : </span> |
| <span id="L1468"><span class="lineNum"> 1468</span> : : int fdt_resize(void *fdt, void *buf, int bufsize);</span> |
| <span id="L1469"><span class="lineNum"> 1469</span> : : int fdt_add_reservemap_entry(void *fdt, uint64_t addr, uint64_t size);</span> |
| <span id="L1470"><span class="lineNum"> 1470</span> : : int fdt_finish_reservemap(void *fdt);</span> |
| <span id="L1471"><span class="lineNum"> 1471</span> : : int fdt_begin_node(void *fdt, const char *name);</span> |
| <span id="L1472"><span class="lineNum"> 1472</span> : : int fdt_property(void *fdt, const char *name, const void *val, int len);</span> |
| <span id="L1473"><span class="lineNum"> 1473</span> :<span class="tlaGNC"> 80 : static inline int fdt_property_u32(void *fdt, const char *name, uint32_t val)</span></span> |
| <span id="L1474"><span class="lineNum"> 1474</span> : : {</span> |
| <span id="L1475"><span class="lineNum"> 1475</span> :<span class="tlaGNC"> 80 : fdt32_t tmp = cpu_to_fdt32(val);</span></span> |
| <span id="L1476"><span class="lineNum"> 1476</span> :<span class="tlaGNC"> 80 : return fdt_property(fdt, name, &tmp, sizeof(tmp));</span></span> |
| <span id="L1477"><span class="lineNum"> 1477</span> : : }</span> |
| <span id="L1478"><span class="lineNum"> 1478</span> : : static inline int fdt_property_u64(void *fdt, const char *name, uint64_t val)</span> |
| <span id="L1479"><span class="lineNum"> 1479</span> : : {</span> |
| <span id="L1480"><span class="lineNum"> 1480</span> : : fdt64_t tmp = cpu_to_fdt64(val);</span> |
| <span id="L1481"><span class="lineNum"> 1481</span> : : return fdt_property(fdt, name, &tmp, sizeof(tmp));</span> |
| <span id="L1482"><span class="lineNum"> 1482</span> : : }</span> |
| <span id="L1483"><span class="lineNum"> 1483</span> : : </span> |
| <span id="L1484"><span class="lineNum"> 1484</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L1485"><span class="lineNum"> 1485</span> :<span class="tlaGNC"> 80 : static inline int fdt_property_cell(void *fdt, const char *name, uint32_t val)</span></span> |
| <span id="L1486"><span class="lineNum"> 1486</span> : : {</span> |
| <span id="L1487"><span class="lineNum"> 1487</span> :<span class="tlaGNC"> 80 : return fdt_property_u32(fdt, name, val);</span></span> |
| <span id="L1488"><span class="lineNum"> 1488</span> : : }</span> |
| <span id="L1489"><span class="lineNum"> 1489</span> : : #endif</span> |
| <span id="L1490"><span class="lineNum"> 1490</span> : : </span> |
| <span id="L1491"><span class="lineNum"> 1491</span> : : /**</span> |
| <span id="L1492"><span class="lineNum"> 1492</span> : : * fdt_property_placeholder - add a new property and return a ptr to its value</span> |
| <span id="L1493"><span class="lineNum"> 1493</span> : : *</span> |
| <span id="L1494"><span class="lineNum"> 1494</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1495"><span class="lineNum"> 1495</span> : : * @name: name of property to add</span> |
| <span id="L1496"><span class="lineNum"> 1496</span> : : * @len: length of property value in bytes</span> |
| <span id="L1497"><span class="lineNum"> 1497</span> : : * @valp: returns a pointer to where where the value should be placed</span> |
| <span id="L1498"><span class="lineNum"> 1498</span> : : *</span> |
| <span id="L1499"><span class="lineNum"> 1499</span> : : * returns:</span> |
| <span id="L1500"><span class="lineNum"> 1500</span> : : * 0, on success</span> |
| <span id="L1501"><span class="lineNum"> 1501</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1502"><span class="lineNum"> 1502</span> : : * -FDT_ERR_NOSPACE, standard meanings</span> |
| <span id="L1503"><span class="lineNum"> 1503</span> : : */</span> |
| <span id="L1504"><span class="lineNum"> 1504</span> : : int fdt_property_placeholder(void *fdt, const char *name, int len, void **valp);</span> |
| <span id="L1505"><span class="lineNum"> 1505</span> : : </span> |
| <span id="L1506"><span class="lineNum"> 1506</span> : : #define fdt_property_string(fdt, name, str) \</span> |
| <span id="L1507"><span class="lineNum"> 1507</span> : : fdt_property(fdt, name, str, strlen(str)+1)</span> |
| <span id="L1508"><span class="lineNum"> 1508</span> : : int fdt_end_node(void *fdt);</span> |
| <span id="L1509"><span class="lineNum"> 1509</span> : : int fdt_finish(void *fdt);</span> |
| <span id="L1510"><span class="lineNum"> 1510</span> : : </span> |
| <span id="L1511"><span class="lineNum"> 1511</span> : : /**********************************************************************/</span> |
| <span id="L1512"><span class="lineNum"> 1512</span> : : /* Read-write functions */</span> |
| <span id="L1513"><span class="lineNum"> 1513</span> : : /**********************************************************************/</span> |
| <span id="L1514"><span class="lineNum"> 1514</span> : : </span> |
| <span id="L1515"><span class="lineNum"> 1515</span> : : int fdt_create_empty_tree(void *buf, int bufsize);</span> |
| <span id="L1516"><span class="lineNum"> 1516</span> : : int fdt_open_into(const void *fdt, void *buf, int bufsize);</span> |
| <span id="L1517"><span class="lineNum"> 1517</span> : : int fdt_pack(void *fdt);</span> |
| <span id="L1518"><span class="lineNum"> 1518</span> : : </span> |
| <span id="L1519"><span class="lineNum"> 1519</span> : : /**</span> |
| <span id="L1520"><span class="lineNum"> 1520</span> : : * fdt_add_mem_rsv - add one memory reserve map entry</span> |
| <span id="L1521"><span class="lineNum"> 1521</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1522"><span class="lineNum"> 1522</span> : : * @address: 64-bit start address of the reserve map entry</span> |
| <span id="L1523"><span class="lineNum"> 1523</span> : : * @size: 64-bit size of the reserved region</span> |
| <span id="L1524"><span class="lineNum"> 1524</span> : : *</span> |
| <span id="L1525"><span class="lineNum"> 1525</span> : : * Adds a reserve map entry to the given blob reserving a region at</span> |
| <span id="L1526"><span class="lineNum"> 1526</span> : : * address address of length size.</span> |
| <span id="L1527"><span class="lineNum"> 1527</span> : : *</span> |
| <span id="L1528"><span class="lineNum"> 1528</span> : : * This function will insert data into the reserve map and will</span> |
| <span id="L1529"><span class="lineNum"> 1529</span> : : * therefore change the indexes of some entries in the table.</span> |
| <span id="L1530"><span class="lineNum"> 1530</span> : : *</span> |
| <span id="L1531"><span class="lineNum"> 1531</span> : : * returns:</span> |
| <span id="L1532"><span class="lineNum"> 1532</span> : : * 0, on success</span> |
| <span id="L1533"><span class="lineNum"> 1533</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1534"><span class="lineNum"> 1534</span> : : * contain the new reservation entry</span> |
| <span id="L1535"><span class="lineNum"> 1535</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1536"><span class="lineNum"> 1536</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1537"><span class="lineNum"> 1537</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1538"><span class="lineNum"> 1538</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1539"><span class="lineNum"> 1539</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1540"><span class="lineNum"> 1540</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1541"><span class="lineNum"> 1541</span> : : */</span> |
| <span id="L1542"><span class="lineNum"> 1542</span> : : int fdt_add_mem_rsv(void *fdt, uint64_t address, uint64_t size);</span> |
| <span id="L1543"><span class="lineNum"> 1543</span> : : </span> |
| <span id="L1544"><span class="lineNum"> 1544</span> : : /**</span> |
| <span id="L1545"><span class="lineNum"> 1545</span> : : * fdt_del_mem_rsv - remove a memory reserve map entry</span> |
| <span id="L1546"><span class="lineNum"> 1546</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1547"><span class="lineNum"> 1547</span> : : * @n: entry to remove</span> |
| <span id="L1548"><span class="lineNum"> 1548</span> : : *</span> |
| <span id="L1549"><span class="lineNum"> 1549</span> : : * fdt_del_mem_rsv() removes the n-th memory reserve map entry from</span> |
| <span id="L1550"><span class="lineNum"> 1550</span> : : * the blob.</span> |
| <span id="L1551"><span class="lineNum"> 1551</span> : : *</span> |
| <span id="L1552"><span class="lineNum"> 1552</span> : : * This function will delete data from the reservation table and will</span> |
| <span id="L1553"><span class="lineNum"> 1553</span> : : * therefore change the indexes of some entries in the table.</span> |
| <span id="L1554"><span class="lineNum"> 1554</span> : : *</span> |
| <span id="L1555"><span class="lineNum"> 1555</span> : : * returns:</span> |
| <span id="L1556"><span class="lineNum"> 1556</span> : : * 0, on success</span> |
| <span id="L1557"><span class="lineNum"> 1557</span> : : * -FDT_ERR_NOTFOUND, there is no entry of the given index (i.e. there</span> |
| <span id="L1558"><span class="lineNum"> 1558</span> : : * are less than n+1 reserve map entries)</span> |
| <span id="L1559"><span class="lineNum"> 1559</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1560"><span class="lineNum"> 1560</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1561"><span class="lineNum"> 1561</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1562"><span class="lineNum"> 1562</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1563"><span class="lineNum"> 1563</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1564"><span class="lineNum"> 1564</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1565"><span class="lineNum"> 1565</span> : : */</span> |
| <span id="L1566"><span class="lineNum"> 1566</span> : : int fdt_del_mem_rsv(void *fdt, int n);</span> |
| <span id="L1567"><span class="lineNum"> 1567</span> : : </span> |
| <span id="L1568"><span class="lineNum"> 1568</span> : : /**</span> |
| <span id="L1569"><span class="lineNum"> 1569</span> : : * fdt_set_name - change the name of a given node</span> |
| <span id="L1570"><span class="lineNum"> 1570</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1571"><span class="lineNum"> 1571</span> : : * @nodeoffset: structure block offset of a node</span> |
| <span id="L1572"><span class="lineNum"> 1572</span> : : * @name: name to give the node</span> |
| <span id="L1573"><span class="lineNum"> 1573</span> : : *</span> |
| <span id="L1574"><span class="lineNum"> 1574</span> : : * fdt_set_name() replaces the name (including unit address, if any)</span> |
| <span id="L1575"><span class="lineNum"> 1575</span> : : * of the given node with the given string. NOTE: this function can't</span> |
| <span id="L1576"><span class="lineNum"> 1576</span> : : * efficiently check if the new name is unique amongst the given</span> |
| <span id="L1577"><span class="lineNum"> 1577</span> : : * node's siblings; results are undefined if this function is invoked</span> |
| <span id="L1578"><span class="lineNum"> 1578</span> : : * with a name equal to one of the given node's siblings.</span> |
| <span id="L1579"><span class="lineNum"> 1579</span> : : *</span> |
| <span id="L1580"><span class="lineNum"> 1580</span> : : * This function may insert or delete data from the blob, and will</span> |
| <span id="L1581"><span class="lineNum"> 1581</span> : : * therefore change the offsets of some existing nodes.</span> |
| <span id="L1582"><span class="lineNum"> 1582</span> : : *</span> |
| <span id="L1583"><span class="lineNum"> 1583</span> : : * returns:</span> |
| <span id="L1584"><span class="lineNum"> 1584</span> : : * 0, on success</span> |
| <span id="L1585"><span class="lineNum"> 1585</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob</span> |
| <span id="L1586"><span class="lineNum"> 1586</span> : : * to contain the new name</span> |
| <span id="L1587"><span class="lineNum"> 1587</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1588"><span class="lineNum"> 1588</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1589"><span class="lineNum"> 1589</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1590"><span class="lineNum"> 1590</span> : : * -FDT_ERR_BADSTATE, standard meanings</span> |
| <span id="L1591"><span class="lineNum"> 1591</span> : : */</span> |
| <span id="L1592"><span class="lineNum"> 1592</span> : : int fdt_set_name(void *fdt, int nodeoffset, const char *name);</span> |
| <span id="L1593"><span class="lineNum"> 1593</span> : : </span> |
| <span id="L1594"><span class="lineNum"> 1594</span> : : /**</span> |
| <span id="L1595"><span class="lineNum"> 1595</span> : : * fdt_setprop - create or change a property</span> |
| <span id="L1596"><span class="lineNum"> 1596</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1597"><span class="lineNum"> 1597</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1598"><span class="lineNum"> 1598</span> : : * @name: name of the property to change</span> |
| <span id="L1599"><span class="lineNum"> 1599</span> : : * @val: pointer to data to set the property value to</span> |
| <span id="L1600"><span class="lineNum"> 1600</span> : : * @len: length of the property value</span> |
| <span id="L1601"><span class="lineNum"> 1601</span> : : *</span> |
| <span id="L1602"><span class="lineNum"> 1602</span> : : * fdt_setprop() sets the value of the named property in the given</span> |
| <span id="L1603"><span class="lineNum"> 1603</span> : : * node to the given value and length, creating the property if it</span> |
| <span id="L1604"><span class="lineNum"> 1604</span> : : * does not already exist.</span> |
| <span id="L1605"><span class="lineNum"> 1605</span> : : *</span> |
| <span id="L1606"><span class="lineNum"> 1606</span> : : * This function may insert or delete data from the blob, and will</span> |
| <span id="L1607"><span class="lineNum"> 1607</span> : : * therefore change the offsets of some existing nodes.</span> |
| <span id="L1608"><span class="lineNum"> 1608</span> : : *</span> |
| <span id="L1609"><span class="lineNum"> 1609</span> : : * returns:</span> |
| <span id="L1610"><span class="lineNum"> 1610</span> : : * 0, on success</span> |
| <span id="L1611"><span class="lineNum"> 1611</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1612"><span class="lineNum"> 1612</span> : : * contain the new property value</span> |
| <span id="L1613"><span class="lineNum"> 1613</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1614"><span class="lineNum"> 1614</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1615"><span class="lineNum"> 1615</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1616"><span class="lineNum"> 1616</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1617"><span class="lineNum"> 1617</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1618"><span class="lineNum"> 1618</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1619"><span class="lineNum"> 1619</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1620"><span class="lineNum"> 1620</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1621"><span class="lineNum"> 1621</span> : : */</span> |
| <span id="L1622"><span class="lineNum"> 1622</span> : : int fdt_setprop(void *fdt, int nodeoffset, const char *name,</span> |
| <span id="L1623"><span class="lineNum"> 1623</span> : : const void *val, int len);</span> |
| <span id="L1624"><span class="lineNum"> 1624</span> : : </span> |
| <span id="L1625"><span class="lineNum"> 1625</span> : : /**</span> |
| <span id="L1626"><span class="lineNum"> 1626</span> : : * fdt_setprop_placeholder - allocate space for a property</span> |
| <span id="L1627"><span class="lineNum"> 1627</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1628"><span class="lineNum"> 1628</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1629"><span class="lineNum"> 1629</span> : : * @name: name of the property to change</span> |
| <span id="L1630"><span class="lineNum"> 1630</span> : : * @len: length of the property value</span> |
| <span id="L1631"><span class="lineNum"> 1631</span> : : * @prop_data: return pointer to property data</span> |
| <span id="L1632"><span class="lineNum"> 1632</span> : : *</span> |
| <span id="L1633"><span class="lineNum"> 1633</span> : : * fdt_setprop_placeholer() allocates the named property in the given node.</span> |
| <span id="L1634"><span class="lineNum"> 1634</span> : : * If the property exists it is resized. In either case a pointer to the</span> |
| <span id="L1635"><span class="lineNum"> 1635</span> : : * property data is returned.</span> |
| <span id="L1636"><span class="lineNum"> 1636</span> : : *</span> |
| <span id="L1637"><span class="lineNum"> 1637</span> : : * This function may insert or delete data from the blob, and will</span> |
| <span id="L1638"><span class="lineNum"> 1638</span> : : * therefore change the offsets of some existing nodes.</span> |
| <span id="L1639"><span class="lineNum"> 1639</span> : : *</span> |
| <span id="L1640"><span class="lineNum"> 1640</span> : : * returns:</span> |
| <span id="L1641"><span class="lineNum"> 1641</span> : : * 0, on success</span> |
| <span id="L1642"><span class="lineNum"> 1642</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1643"><span class="lineNum"> 1643</span> : : * contain the new property value</span> |
| <span id="L1644"><span class="lineNum"> 1644</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1645"><span class="lineNum"> 1645</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1646"><span class="lineNum"> 1646</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1647"><span class="lineNum"> 1647</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1648"><span class="lineNum"> 1648</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1649"><span class="lineNum"> 1649</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1650"><span class="lineNum"> 1650</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1651"><span class="lineNum"> 1651</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1652"><span class="lineNum"> 1652</span> : : */</span> |
| <span id="L1653"><span class="lineNum"> 1653</span> : : int fdt_setprop_placeholder(void *fdt, int nodeoffset, const char *name,</span> |
| <span id="L1654"><span class="lineNum"> 1654</span> : : int len, void **prop_data);</span> |
| <span id="L1655"><span class="lineNum"> 1655</span> : : </span> |
| <span id="L1656"><span class="lineNum"> 1656</span> : : /**</span> |
| <span id="L1657"><span class="lineNum"> 1657</span> : : * fdt_setprop_u32 - set a property to a 32-bit integer</span> |
| <span id="L1658"><span class="lineNum"> 1658</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1659"><span class="lineNum"> 1659</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1660"><span class="lineNum"> 1660</span> : : * @name: name of the property to change</span> |
| <span id="L1661"><span class="lineNum"> 1661</span> : : * @val: 32-bit integer value for the property (native endian)</span> |
| <span id="L1662"><span class="lineNum"> 1662</span> : : *</span> |
| <span id="L1663"><span class="lineNum"> 1663</span> : : * fdt_setprop_u32() sets the value of the named property in the given</span> |
| <span id="L1664"><span class="lineNum"> 1664</span> : : * node to the given 32-bit integer value (converting to big-endian if</span> |
| <span id="L1665"><span class="lineNum"> 1665</span> : : * necessary), or creates a new property with that value if it does</span> |
| <span id="L1666"><span class="lineNum"> 1666</span> : : * not already exist.</span> |
| <span id="L1667"><span class="lineNum"> 1667</span> : : *</span> |
| <span id="L1668"><span class="lineNum"> 1668</span> : : * This function may insert or delete data from the blob, and will</span> |
| <span id="L1669"><span class="lineNum"> 1669</span> : : * therefore change the offsets of some existing nodes.</span> |
| <span id="L1670"><span class="lineNum"> 1670</span> : : *</span> |
| <span id="L1671"><span class="lineNum"> 1671</span> : : * returns:</span> |
| <span id="L1672"><span class="lineNum"> 1672</span> : : * 0, on success</span> |
| <span id="L1673"><span class="lineNum"> 1673</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1674"><span class="lineNum"> 1674</span> : : * contain the new property value</span> |
| <span id="L1675"><span class="lineNum"> 1675</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1676"><span class="lineNum"> 1676</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1677"><span class="lineNum"> 1677</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1678"><span class="lineNum"> 1678</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1679"><span class="lineNum"> 1679</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1680"><span class="lineNum"> 1680</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1681"><span class="lineNum"> 1681</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1682"><span class="lineNum"> 1682</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1683"><span class="lineNum"> 1683</span> : : */</span> |
| <span id="L1684"><span class="lineNum"> 1684</span> : : static inline int fdt_setprop_u32(void *fdt, int nodeoffset, const char *name,</span> |
| <span id="L1685"><span class="lineNum"> 1685</span> : : uint32_t val)</span> |
| <span id="L1686"><span class="lineNum"> 1686</span> : : {</span> |
| <span id="L1687"><span class="lineNum"> 1687</span> : : fdt32_t tmp = cpu_to_fdt32(val);</span> |
| <span id="L1688"><span class="lineNum"> 1688</span> : : return fdt_setprop(fdt, nodeoffset, name, &tmp, sizeof(tmp));</span> |
| <span id="L1689"><span class="lineNum"> 1689</span> : : }</span> |
| <span id="L1690"><span class="lineNum"> 1690</span> : : </span> |
| <span id="L1691"><span class="lineNum"> 1691</span> : : /**</span> |
| <span id="L1692"><span class="lineNum"> 1692</span> : : * fdt_setprop_u64 - set a property to a 64-bit integer</span> |
| <span id="L1693"><span class="lineNum"> 1693</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1694"><span class="lineNum"> 1694</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1695"><span class="lineNum"> 1695</span> : : * @name: name of the property to change</span> |
| <span id="L1696"><span class="lineNum"> 1696</span> : : * @val: 64-bit integer value for the property (native endian)</span> |
| <span id="L1697"><span class="lineNum"> 1697</span> : : *</span> |
| <span id="L1698"><span class="lineNum"> 1698</span> : : * fdt_setprop_u64() sets the value of the named property in the given</span> |
| <span id="L1699"><span class="lineNum"> 1699</span> : : * node to the given 64-bit integer value (converting to big-endian if</span> |
| <span id="L1700"><span class="lineNum"> 1700</span> : : * necessary), or creates a new property with that value if it does</span> |
| <span id="L1701"><span class="lineNum"> 1701</span> : : * not already exist.</span> |
| <span id="L1702"><span class="lineNum"> 1702</span> : : *</span> |
| <span id="L1703"><span class="lineNum"> 1703</span> : : * This function may insert or delete data from the blob, and will</span> |
| <span id="L1704"><span class="lineNum"> 1704</span> : : * therefore change the offsets of some existing nodes.</span> |
| <span id="L1705"><span class="lineNum"> 1705</span> : : *</span> |
| <span id="L1706"><span class="lineNum"> 1706</span> : : * returns:</span> |
| <span id="L1707"><span class="lineNum"> 1707</span> : : * 0, on success</span> |
| <span id="L1708"><span class="lineNum"> 1708</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1709"><span class="lineNum"> 1709</span> : : * contain the new property value</span> |
| <span id="L1710"><span class="lineNum"> 1710</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1711"><span class="lineNum"> 1711</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1712"><span class="lineNum"> 1712</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1713"><span class="lineNum"> 1713</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1714"><span class="lineNum"> 1714</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1715"><span class="lineNum"> 1715</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1716"><span class="lineNum"> 1716</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1717"><span class="lineNum"> 1717</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1718"><span class="lineNum"> 1718</span> : : */</span> |
| <span id="L1719"><span class="lineNum"> 1719</span> : : static inline int fdt_setprop_u64(void *fdt, int nodeoffset, const char *name,</span> |
| <span id="L1720"><span class="lineNum"> 1720</span> : : uint64_t val)</span> |
| <span id="L1721"><span class="lineNum"> 1721</span> : : {</span> |
| <span id="L1722"><span class="lineNum"> 1722</span> : : fdt64_t tmp = cpu_to_fdt64(val);</span> |
| <span id="L1723"><span class="lineNum"> 1723</span> : : return fdt_setprop(fdt, nodeoffset, name, &tmp, sizeof(tmp));</span> |
| <span id="L1724"><span class="lineNum"> 1724</span> : : }</span> |
| <span id="L1725"><span class="lineNum"> 1725</span> : : </span> |
| <span id="L1726"><span class="lineNum"> 1726</span> : : /**</span> |
| <span id="L1727"><span class="lineNum"> 1727</span> : : * fdt_setprop_cell - set a property to a single cell value</span> |
| <span id="L1728"><span class="lineNum"> 1728</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1729"><span class="lineNum"> 1729</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1730"><span class="lineNum"> 1730</span> : : * @name: name of the property to change</span> |
| <span id="L1731"><span class="lineNum"> 1731</span> : : * @val: 32-bit integer value for the property (native endian)</span> |
| <span id="L1732"><span class="lineNum"> 1732</span> : : *</span> |
| <span id="L1733"><span class="lineNum"> 1733</span> : : * This is an alternative name for fdt_setprop_u32()</span> |
| <span id="L1734"><span class="lineNum"> 1734</span> : : *</span> |
| <span id="L1735"><span class="lineNum"> 1735</span> : : * Return: 0 on success, negative libfdt error value otherwise.</span> |
| <span id="L1736"><span class="lineNum"> 1736</span> : : */</span> |
| <span id="L1737"><span class="lineNum"> 1737</span> : : static inline int fdt_setprop_cell(void *fdt, int nodeoffset, const char *name,</span> |
| <span id="L1738"><span class="lineNum"> 1738</span> : : uint32_t val)</span> |
| <span id="L1739"><span class="lineNum"> 1739</span> : : {</span> |
| <span id="L1740"><span class="lineNum"> 1740</span> : : return fdt_setprop_u32(fdt, nodeoffset, name, val);</span> |
| <span id="L1741"><span class="lineNum"> 1741</span> : : }</span> |
| <span id="L1742"><span class="lineNum"> 1742</span> : : </span> |
| <span id="L1743"><span class="lineNum"> 1743</span> : : /**</span> |
| <span id="L1744"><span class="lineNum"> 1744</span> : : * fdt_setprop_string - set a property to a string value</span> |
| <span id="L1745"><span class="lineNum"> 1745</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1746"><span class="lineNum"> 1746</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1747"><span class="lineNum"> 1747</span> : : * @name: name of the property to change</span> |
| <span id="L1748"><span class="lineNum"> 1748</span> : : * @str: string value for the property</span> |
| <span id="L1749"><span class="lineNum"> 1749</span> : : *</span> |
| <span id="L1750"><span class="lineNum"> 1750</span> : : * fdt_setprop_string() sets the value of the named property in the</span> |
| <span id="L1751"><span class="lineNum"> 1751</span> : : * given node to the given string value (using the length of the</span> |
| <span id="L1752"><span class="lineNum"> 1752</span> : : * string to determine the new length of the property), or creates a</span> |
| <span id="L1753"><span class="lineNum"> 1753</span> : : * new property with that value if it does not already exist.</span> |
| <span id="L1754"><span class="lineNum"> 1754</span> : : *</span> |
| <span id="L1755"><span class="lineNum"> 1755</span> : : * This function may insert or delete data from the blob, and will</span> |
| <span id="L1756"><span class="lineNum"> 1756</span> : : * therefore change the offsets of some existing nodes.</span> |
| <span id="L1757"><span class="lineNum"> 1757</span> : : *</span> |
| <span id="L1758"><span class="lineNum"> 1758</span> : : * returns:</span> |
| <span id="L1759"><span class="lineNum"> 1759</span> : : * 0, on success</span> |
| <span id="L1760"><span class="lineNum"> 1760</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1761"><span class="lineNum"> 1761</span> : : * contain the new property value</span> |
| <span id="L1762"><span class="lineNum"> 1762</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1763"><span class="lineNum"> 1763</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1764"><span class="lineNum"> 1764</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1765"><span class="lineNum"> 1765</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1766"><span class="lineNum"> 1766</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1767"><span class="lineNum"> 1767</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1768"><span class="lineNum"> 1768</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1769"><span class="lineNum"> 1769</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1770"><span class="lineNum"> 1770</span> : : */</span> |
| <span id="L1771"><span class="lineNum"> 1771</span> : : #define fdt_setprop_string(fdt, nodeoffset, name, str) \</span> |
| <span id="L1772"><span class="lineNum"> 1772</span> : : fdt_setprop((fdt), (nodeoffset), (name), (str), strlen(str)+1)</span> |
| <span id="L1773"><span class="lineNum"> 1773</span> : : </span> |
| <span id="L1774"><span class="lineNum"> 1774</span> : : </span> |
| <span id="L1775"><span class="lineNum"> 1775</span> : : /**</span> |
| <span id="L1776"><span class="lineNum"> 1776</span> : : * fdt_setprop_empty - set a property to an empty value</span> |
| <span id="L1777"><span class="lineNum"> 1777</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1778"><span class="lineNum"> 1778</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1779"><span class="lineNum"> 1779</span> : : * @name: name of the property to change</span> |
| <span id="L1780"><span class="lineNum"> 1780</span> : : *</span> |
| <span id="L1781"><span class="lineNum"> 1781</span> : : * fdt_setprop_empty() sets the value of the named property in the</span> |
| <span id="L1782"><span class="lineNum"> 1782</span> : : * given node to an empty (zero length) value, or creates a new empty</span> |
| <span id="L1783"><span class="lineNum"> 1783</span> : : * property if it does not already exist.</span> |
| <span id="L1784"><span class="lineNum"> 1784</span> : : *</span> |
| <span id="L1785"><span class="lineNum"> 1785</span> : : * This function may insert or delete data from the blob, and will</span> |
| <span id="L1786"><span class="lineNum"> 1786</span> : : * therefore change the offsets of some existing nodes.</span> |
| <span id="L1787"><span class="lineNum"> 1787</span> : : *</span> |
| <span id="L1788"><span class="lineNum"> 1788</span> : : * returns:</span> |
| <span id="L1789"><span class="lineNum"> 1789</span> : : * 0, on success</span> |
| <span id="L1790"><span class="lineNum"> 1790</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1791"><span class="lineNum"> 1791</span> : : * contain the new property value</span> |
| <span id="L1792"><span class="lineNum"> 1792</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1793"><span class="lineNum"> 1793</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1794"><span class="lineNum"> 1794</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1795"><span class="lineNum"> 1795</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1796"><span class="lineNum"> 1796</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1797"><span class="lineNum"> 1797</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1798"><span class="lineNum"> 1798</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1799"><span class="lineNum"> 1799</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1800"><span class="lineNum"> 1800</span> : : */</span> |
| <span id="L1801"><span class="lineNum"> 1801</span> : : #define fdt_setprop_empty(fdt, nodeoffset, name) \</span> |
| <span id="L1802"><span class="lineNum"> 1802</span> : : fdt_setprop((fdt), (nodeoffset), (name), NULL, 0)</span> |
| <span id="L1803"><span class="lineNum"> 1803</span> : : </span> |
| <span id="L1804"><span class="lineNum"> 1804</span> : : /**</span> |
| <span id="L1805"><span class="lineNum"> 1805</span> : : * fdt_appendprop - append to or create a property</span> |
| <span id="L1806"><span class="lineNum"> 1806</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1807"><span class="lineNum"> 1807</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1808"><span class="lineNum"> 1808</span> : : * @name: name of the property to append to</span> |
| <span id="L1809"><span class="lineNum"> 1809</span> : : * @val: pointer to data to append to the property value</span> |
| <span id="L1810"><span class="lineNum"> 1810</span> : : * @len: length of the data to append to the property value</span> |
| <span id="L1811"><span class="lineNum"> 1811</span> : : *</span> |
| <span id="L1812"><span class="lineNum"> 1812</span> : : * fdt_appendprop() appends the value to the named property in the</span> |
| <span id="L1813"><span class="lineNum"> 1813</span> : : * given node, creating the property if it does not already exist.</span> |
| <span id="L1814"><span class="lineNum"> 1814</span> : : *</span> |
| <span id="L1815"><span class="lineNum"> 1815</span> : : * This function may insert data into the blob, and will therefore</span> |
| <span id="L1816"><span class="lineNum"> 1816</span> : : * change the offsets of some existing nodes.</span> |
| <span id="L1817"><span class="lineNum"> 1817</span> : : *</span> |
| <span id="L1818"><span class="lineNum"> 1818</span> : : * returns:</span> |
| <span id="L1819"><span class="lineNum"> 1819</span> : : * 0, on success</span> |
| <span id="L1820"><span class="lineNum"> 1820</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1821"><span class="lineNum"> 1821</span> : : * contain the new property value</span> |
| <span id="L1822"><span class="lineNum"> 1822</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1823"><span class="lineNum"> 1823</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1824"><span class="lineNum"> 1824</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1825"><span class="lineNum"> 1825</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1826"><span class="lineNum"> 1826</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1827"><span class="lineNum"> 1827</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1828"><span class="lineNum"> 1828</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1829"><span class="lineNum"> 1829</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1830"><span class="lineNum"> 1830</span> : : */</span> |
| <span id="L1831"><span class="lineNum"> 1831</span> : : int fdt_appendprop(void *fdt, int nodeoffset, const char *name,</span> |
| <span id="L1832"><span class="lineNum"> 1832</span> : : const void *val, int len);</span> |
| <span id="L1833"><span class="lineNum"> 1833</span> : : </span> |
| <span id="L1834"><span class="lineNum"> 1834</span> : : /**</span> |
| <span id="L1835"><span class="lineNum"> 1835</span> : : * fdt_appendprop_u32 - append a 32-bit integer value to a property</span> |
| <span id="L1836"><span class="lineNum"> 1836</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1837"><span class="lineNum"> 1837</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1838"><span class="lineNum"> 1838</span> : : * @name: name of the property to change</span> |
| <span id="L1839"><span class="lineNum"> 1839</span> : : * @val: 32-bit integer value to append to the property (native endian)</span> |
| <span id="L1840"><span class="lineNum"> 1840</span> : : *</span> |
| <span id="L1841"><span class="lineNum"> 1841</span> : : * fdt_appendprop_u32() appends the given 32-bit integer value</span> |
| <span id="L1842"><span class="lineNum"> 1842</span> : : * (converting to big-endian if necessary) to the value of the named</span> |
| <span id="L1843"><span class="lineNum"> 1843</span> : : * property in the given node, or creates a new property with that</span> |
| <span id="L1844"><span class="lineNum"> 1844</span> : : * value if it does not already exist.</span> |
| <span id="L1845"><span class="lineNum"> 1845</span> : : *</span> |
| <span id="L1846"><span class="lineNum"> 1846</span> : : * This function may insert data into the blob, and will therefore</span> |
| <span id="L1847"><span class="lineNum"> 1847</span> : : * change the offsets of some existing nodes.</span> |
| <span id="L1848"><span class="lineNum"> 1848</span> : : *</span> |
| <span id="L1849"><span class="lineNum"> 1849</span> : : * returns:</span> |
| <span id="L1850"><span class="lineNum"> 1850</span> : : * 0, on success</span> |
| <span id="L1851"><span class="lineNum"> 1851</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1852"><span class="lineNum"> 1852</span> : : * contain the new property value</span> |
| <span id="L1853"><span class="lineNum"> 1853</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1854"><span class="lineNum"> 1854</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1855"><span class="lineNum"> 1855</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1856"><span class="lineNum"> 1856</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1857"><span class="lineNum"> 1857</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1858"><span class="lineNum"> 1858</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1859"><span class="lineNum"> 1859</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1860"><span class="lineNum"> 1860</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1861"><span class="lineNum"> 1861</span> : : */</span> |
| <span id="L1862"><span class="lineNum"> 1862</span> : : static inline int fdt_appendprop_u32(void *fdt, int nodeoffset,</span> |
| <span id="L1863"><span class="lineNum"> 1863</span> : : const char *name, uint32_t val)</span> |
| <span id="L1864"><span class="lineNum"> 1864</span> : : {</span> |
| <span id="L1865"><span class="lineNum"> 1865</span> : : fdt32_t tmp = cpu_to_fdt32(val);</span> |
| <span id="L1866"><span class="lineNum"> 1866</span> : : return fdt_appendprop(fdt, nodeoffset, name, &tmp, sizeof(tmp));</span> |
| <span id="L1867"><span class="lineNum"> 1867</span> : : }</span> |
| <span id="L1868"><span class="lineNum"> 1868</span> : : </span> |
| <span id="L1869"><span class="lineNum"> 1869</span> : : /**</span> |
| <span id="L1870"><span class="lineNum"> 1870</span> : : * fdt_appendprop_u64 - append a 64-bit integer value to a property</span> |
| <span id="L1871"><span class="lineNum"> 1871</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1872"><span class="lineNum"> 1872</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1873"><span class="lineNum"> 1873</span> : : * @name: name of the property to change</span> |
| <span id="L1874"><span class="lineNum"> 1874</span> : : * @val: 64-bit integer value to append to the property (native endian)</span> |
| <span id="L1875"><span class="lineNum"> 1875</span> : : *</span> |
| <span id="L1876"><span class="lineNum"> 1876</span> : : * fdt_appendprop_u64() appends the given 64-bit integer value</span> |
| <span id="L1877"><span class="lineNum"> 1877</span> : : * (converting to big-endian if necessary) to the value of the named</span> |
| <span id="L1878"><span class="lineNum"> 1878</span> : : * property in the given node, or creates a new property with that</span> |
| <span id="L1879"><span class="lineNum"> 1879</span> : : * value if it does not already exist.</span> |
| <span id="L1880"><span class="lineNum"> 1880</span> : : *</span> |
| <span id="L1881"><span class="lineNum"> 1881</span> : : * This function may insert data into the blob, and will therefore</span> |
| <span id="L1882"><span class="lineNum"> 1882</span> : : * change the offsets of some existing nodes.</span> |
| <span id="L1883"><span class="lineNum"> 1883</span> : : *</span> |
| <span id="L1884"><span class="lineNum"> 1884</span> : : * returns:</span> |
| <span id="L1885"><span class="lineNum"> 1885</span> : : * 0, on success</span> |
| <span id="L1886"><span class="lineNum"> 1886</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1887"><span class="lineNum"> 1887</span> : : * contain the new property value</span> |
| <span id="L1888"><span class="lineNum"> 1888</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1889"><span class="lineNum"> 1889</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1890"><span class="lineNum"> 1890</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1891"><span class="lineNum"> 1891</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1892"><span class="lineNum"> 1892</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1893"><span class="lineNum"> 1893</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1894"><span class="lineNum"> 1894</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1895"><span class="lineNum"> 1895</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1896"><span class="lineNum"> 1896</span> : : */</span> |
| <span id="L1897"><span class="lineNum"> 1897</span> : : static inline int fdt_appendprop_u64(void *fdt, int nodeoffset,</span> |
| <span id="L1898"><span class="lineNum"> 1898</span> : : const char *name, uint64_t val)</span> |
| <span id="L1899"><span class="lineNum"> 1899</span> : : {</span> |
| <span id="L1900"><span class="lineNum"> 1900</span> : : fdt64_t tmp = cpu_to_fdt64(val);</span> |
| <span id="L1901"><span class="lineNum"> 1901</span> : : return fdt_appendprop(fdt, nodeoffset, name, &tmp, sizeof(tmp));</span> |
| <span id="L1902"><span class="lineNum"> 1902</span> : : }</span> |
| <span id="L1903"><span class="lineNum"> 1903</span> : : </span> |
| <span id="L1904"><span class="lineNum"> 1904</span> : : /**</span> |
| <span id="L1905"><span class="lineNum"> 1905</span> : : * fdt_appendprop_cell - append a single cell value to a property</span> |
| <span id="L1906"><span class="lineNum"> 1906</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1907"><span class="lineNum"> 1907</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1908"><span class="lineNum"> 1908</span> : : * @name: name of the property to change</span> |
| <span id="L1909"><span class="lineNum"> 1909</span> : : * @val: 32-bit integer value to append to the property (native endian)</span> |
| <span id="L1910"><span class="lineNum"> 1910</span> : : *</span> |
| <span id="L1911"><span class="lineNum"> 1911</span> : : * This is an alternative name for fdt_appendprop_u32()</span> |
| <span id="L1912"><span class="lineNum"> 1912</span> : : *</span> |
| <span id="L1913"><span class="lineNum"> 1913</span> : : * Return: 0 on success, negative libfdt error value otherwise.</span> |
| <span id="L1914"><span class="lineNum"> 1914</span> : : */</span> |
| <span id="L1915"><span class="lineNum"> 1915</span> : : static inline int fdt_appendprop_cell(void *fdt, int nodeoffset,</span> |
| <span id="L1916"><span class="lineNum"> 1916</span> : : const char *name, uint32_t val)</span> |
| <span id="L1917"><span class="lineNum"> 1917</span> : : {</span> |
| <span id="L1918"><span class="lineNum"> 1918</span> : : return fdt_appendprop_u32(fdt, nodeoffset, name, val);</span> |
| <span id="L1919"><span class="lineNum"> 1919</span> : : }</span> |
| <span id="L1920"><span class="lineNum"> 1920</span> : : </span> |
| <span id="L1921"><span class="lineNum"> 1921</span> : : /**</span> |
| <span id="L1922"><span class="lineNum"> 1922</span> : : * fdt_appendprop_string - append a string to a property</span> |
| <span id="L1923"><span class="lineNum"> 1923</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1924"><span class="lineNum"> 1924</span> : : * @nodeoffset: offset of the node whose property to change</span> |
| <span id="L1925"><span class="lineNum"> 1925</span> : : * @name: name of the property to change</span> |
| <span id="L1926"><span class="lineNum"> 1926</span> : : * @str: string value to append to the property</span> |
| <span id="L1927"><span class="lineNum"> 1927</span> : : *</span> |
| <span id="L1928"><span class="lineNum"> 1928</span> : : * fdt_appendprop_string() appends the given string to the value of</span> |
| <span id="L1929"><span class="lineNum"> 1929</span> : : * the named property in the given node, or creates a new property</span> |
| <span id="L1930"><span class="lineNum"> 1930</span> : : * with that value if it does not already exist.</span> |
| <span id="L1931"><span class="lineNum"> 1931</span> : : *</span> |
| <span id="L1932"><span class="lineNum"> 1932</span> : : * This function may insert data into the blob, and will therefore</span> |
| <span id="L1933"><span class="lineNum"> 1933</span> : : * change the offsets of some existing nodes.</span> |
| <span id="L1934"><span class="lineNum"> 1934</span> : : *</span> |
| <span id="L1935"><span class="lineNum"> 1935</span> : : * returns:</span> |
| <span id="L1936"><span class="lineNum"> 1936</span> : : * 0, on success</span> |
| <span id="L1937"><span class="lineNum"> 1937</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1938"><span class="lineNum"> 1938</span> : : * contain the new property value</span> |
| <span id="L1939"><span class="lineNum"> 1939</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1940"><span class="lineNum"> 1940</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1941"><span class="lineNum"> 1941</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1942"><span class="lineNum"> 1942</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1943"><span class="lineNum"> 1943</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1944"><span class="lineNum"> 1944</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1945"><span class="lineNum"> 1945</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1946"><span class="lineNum"> 1946</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1947"><span class="lineNum"> 1947</span> : : */</span> |
| <span id="L1948"><span class="lineNum"> 1948</span> : : #define fdt_appendprop_string(fdt, nodeoffset, name, str) \</span> |
| <span id="L1949"><span class="lineNum"> 1949</span> : : fdt_appendprop((fdt), (nodeoffset), (name), (str), strlen(str)+1)</span> |
| <span id="L1950"><span class="lineNum"> 1950</span> : : </span> |
| <span id="L1951"><span class="lineNum"> 1951</span> : : /**</span> |
| <span id="L1952"><span class="lineNum"> 1952</span> : : * fdt_appendprop_addrrange - append a address range property</span> |
| <span id="L1953"><span class="lineNum"> 1953</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1954"><span class="lineNum"> 1954</span> : : * @parent: offset of the parent node</span> |
| <span id="L1955"><span class="lineNum"> 1955</span> : : * @nodeoffset: offset of the node to add a property at</span> |
| <span id="L1956"><span class="lineNum"> 1956</span> : : * @name: name of property</span> |
| <span id="L1957"><span class="lineNum"> 1957</span> : : * @addr: start address of a given range</span> |
| <span id="L1958"><span class="lineNum"> 1958</span> : : * @size: size of a given range</span> |
| <span id="L1959"><span class="lineNum"> 1959</span> : : *</span> |
| <span id="L1960"><span class="lineNum"> 1960</span> : : * fdt_appendprop_addrrange() appends an address range value (start</span> |
| <span id="L1961"><span class="lineNum"> 1961</span> : : * address and size) to the value of the named property in the given</span> |
| <span id="L1962"><span class="lineNum"> 1962</span> : : * node, or creates a new property with that value if it does not</span> |
| <span id="L1963"><span class="lineNum"> 1963</span> : : * already exist.</span> |
| <span id="L1964"><span class="lineNum"> 1964</span> : : * If "name" is not specified, a default "reg" is used.</span> |
| <span id="L1965"><span class="lineNum"> 1965</span> : : * Cell sizes are determined by parent's #address-cells and #size-cells.</span> |
| <span id="L1966"><span class="lineNum"> 1966</span> : : *</span> |
| <span id="L1967"><span class="lineNum"> 1967</span> : : * This function may insert data into the blob, and will therefore</span> |
| <span id="L1968"><span class="lineNum"> 1968</span> : : * change the offsets of some existing nodes.</span> |
| <span id="L1969"><span class="lineNum"> 1969</span> : : *</span> |
| <span id="L1970"><span class="lineNum"> 1970</span> : : * returns:</span> |
| <span id="L1971"><span class="lineNum"> 1971</span> : : * 0, on success</span> |
| <span id="L1972"><span class="lineNum"> 1972</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L1973"><span class="lineNum"> 1973</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L1974"><span class="lineNum"> 1974</span> : : * -FDT_ERR_BADNCELLS, if the node has a badly formatted or invalid</span> |
| <span id="L1975"><span class="lineNum"> 1975</span> : : * #address-cells property</span> |
| <span id="L1976"><span class="lineNum"> 1976</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L1977"><span class="lineNum"> 1977</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L1978"><span class="lineNum"> 1978</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L1979"><span class="lineNum"> 1979</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L1980"><span class="lineNum"> 1980</span> : : * -FDT_ERR_BADVALUE, addr or size doesn't fit to respective cells size</span> |
| <span id="L1981"><span class="lineNum"> 1981</span> : : * -FDT_ERR_NOSPACE, there is insufficient free space in the blob to</span> |
| <span id="L1982"><span class="lineNum"> 1982</span> : : * contain a new property</span> |
| <span id="L1983"><span class="lineNum"> 1983</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L1984"><span class="lineNum"> 1984</span> : : */</span> |
| <span id="L1985"><span class="lineNum"> 1985</span> : : int fdt_appendprop_addrrange(void *fdt, int parent, int nodeoffset,</span> |
| <span id="L1986"><span class="lineNum"> 1986</span> : : const char *name, uint64_t addr, uint64_t size);</span> |
| <span id="L1987"><span class="lineNum"> 1987</span> : : </span> |
| <span id="L1988"><span class="lineNum"> 1988</span> : : /**</span> |
| <span id="L1989"><span class="lineNum"> 1989</span> : : * fdt_delprop - delete a property</span> |
| <span id="L1990"><span class="lineNum"> 1990</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L1991"><span class="lineNum"> 1991</span> : : * @nodeoffset: offset of the node whose property to nop</span> |
| <span id="L1992"><span class="lineNum"> 1992</span> : : * @name: name of the property to nop</span> |
| <span id="L1993"><span class="lineNum"> 1993</span> : : *</span> |
| <span id="L1994"><span class="lineNum"> 1994</span> : : * fdt_del_property() will delete the given property.</span> |
| <span id="L1995"><span class="lineNum"> 1995</span> : : *</span> |
| <span id="L1996"><span class="lineNum"> 1996</span> : : * This function will delete data from the blob, and will therefore</span> |
| <span id="L1997"><span class="lineNum"> 1997</span> : : * change the offsets of some existing nodes.</span> |
| <span id="L1998"><span class="lineNum"> 1998</span> : : *</span> |
| <span id="L1999"><span class="lineNum"> 1999</span> : : * returns:</span> |
| <span id="L2000"><span class="lineNum"> 2000</span> : : * 0, on success</span> |
| <span id="L2001"><span class="lineNum"> 2001</span> : : * -FDT_ERR_NOTFOUND, node does not have the named property</span> |
| <span id="L2002"><span class="lineNum"> 2002</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L2003"><span class="lineNum"> 2003</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L2004"><span class="lineNum"> 2004</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L2005"><span class="lineNum"> 2005</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L2006"><span class="lineNum"> 2006</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L2007"><span class="lineNum"> 2007</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L2008"><span class="lineNum"> 2008</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L2009"><span class="lineNum"> 2009</span> : : */</span> |
| <span id="L2010"><span class="lineNum"> 2010</span> : : int fdt_delprop(void *fdt, int nodeoffset, const char *name);</span> |
| <span id="L2011"><span class="lineNum"> 2011</span> : : </span> |
| <span id="L2012"><span class="lineNum"> 2012</span> : : /**</span> |
| <span id="L2013"><span class="lineNum"> 2013</span> : : * fdt_add_subnode_namelen - creates a new node based on substring</span> |
| <span id="L2014"><span class="lineNum"> 2014</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L2015"><span class="lineNum"> 2015</span> : : * @parentoffset: structure block offset of a node</span> |
| <span id="L2016"><span class="lineNum"> 2016</span> : : * @name: name of the subnode to create</span> |
| <span id="L2017"><span class="lineNum"> 2017</span> : : * @namelen: number of characters of name to consider</span> |
| <span id="L2018"><span class="lineNum"> 2018</span> : : *</span> |
| <span id="L2019"><span class="lineNum"> 2019</span> : : * Identical to fdt_add_subnode(), but use only the first @namelen</span> |
| <span id="L2020"><span class="lineNum"> 2020</span> : : * characters of @name as the name of the new node. This is useful for</span> |
| <span id="L2021"><span class="lineNum"> 2021</span> : : * creating subnodes based on a portion of a larger string, such as a</span> |
| <span id="L2022"><span class="lineNum"> 2022</span> : : * full path.</span> |
| <span id="L2023"><span class="lineNum"> 2023</span> : : *</span> |
| <span id="L2024"><span class="lineNum"> 2024</span> : : * Return: structure block offset of the created subnode (>=0),</span> |
| <span id="L2025"><span class="lineNum"> 2025</span> : : * negative libfdt error value otherwise</span> |
| <span id="L2026"><span class="lineNum"> 2026</span> : : */</span> |
| <span id="L2027"><span class="lineNum"> 2027</span> : : #ifndef SWIG /* Not available in Python */</span> |
| <span id="L2028"><span class="lineNum"> 2028</span> : : int fdt_add_subnode_namelen(void *fdt, int parentoffset,</span> |
| <span id="L2029"><span class="lineNum"> 2029</span> : : const char *name, int namelen);</span> |
| <span id="L2030"><span class="lineNum"> 2030</span> : : #endif</span> |
| <span id="L2031"><span class="lineNum"> 2031</span> : : </span> |
| <span id="L2032"><span class="lineNum"> 2032</span> : : /**</span> |
| <span id="L2033"><span class="lineNum"> 2033</span> : : * fdt_add_subnode - creates a new node</span> |
| <span id="L2034"><span class="lineNum"> 2034</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L2035"><span class="lineNum"> 2035</span> : : * @parentoffset: structure block offset of a node</span> |
| <span id="L2036"><span class="lineNum"> 2036</span> : : * @name: name of the subnode to locate</span> |
| <span id="L2037"><span class="lineNum"> 2037</span> : : *</span> |
| <span id="L2038"><span class="lineNum"> 2038</span> : : * fdt_add_subnode() creates a new node as a subnode of the node at</span> |
| <span id="L2039"><span class="lineNum"> 2039</span> : : * structure block offset parentoffset, with the given name (which</span> |
| <span id="L2040"><span class="lineNum"> 2040</span> : : * should include the unit address, if any).</span> |
| <span id="L2041"><span class="lineNum"> 2041</span> : : *</span> |
| <span id="L2042"><span class="lineNum"> 2042</span> : : * This function will insert data into the blob, and will therefore</span> |
| <span id="L2043"><span class="lineNum"> 2043</span> : : * change the offsets of some existing nodes.</span> |
| <span id="L2044"><span class="lineNum"> 2044</span> : : *</span> |
| <span id="L2045"><span class="lineNum"> 2045</span> : : * returns:</span> |
| <span id="L2046"><span class="lineNum"> 2046</span> : : * structure block offset of the created nodeequested subnode (>=0), on</span> |
| <span id="L2047"><span class="lineNum"> 2047</span> : : * success</span> |
| <span id="L2048"><span class="lineNum"> 2048</span> : : * -FDT_ERR_NOTFOUND, if the requested subnode does not exist</span> |
| <span id="L2049"><span class="lineNum"> 2049</span> : : * -FDT_ERR_BADOFFSET, if parentoffset did not point to an FDT_BEGIN_NODE</span> |
| <span id="L2050"><span class="lineNum"> 2050</span> : : * tag</span> |
| <span id="L2051"><span class="lineNum"> 2051</span> : : * -FDT_ERR_EXISTS, if the node at parentoffset already has a subnode of</span> |
| <span id="L2052"><span class="lineNum"> 2052</span> : : * the given name</span> |
| <span id="L2053"><span class="lineNum"> 2053</span> : : * -FDT_ERR_NOSPACE, if there is insufficient free space in the</span> |
| <span id="L2054"><span class="lineNum"> 2054</span> : : * blob to contain the new node</span> |
| <span id="L2055"><span class="lineNum"> 2055</span> : : * -FDT_ERR_NOSPACE</span> |
| <span id="L2056"><span class="lineNum"> 2056</span> : : * -FDT_ERR_BADLAYOUT</span> |
| <span id="L2057"><span class="lineNum"> 2057</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L2058"><span class="lineNum"> 2058</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L2059"><span class="lineNum"> 2059</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L2060"><span class="lineNum"> 2060</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L2061"><span class="lineNum"> 2061</span> : : * -FDT_ERR_TRUNCATED, standard meanings.</span> |
| <span id="L2062"><span class="lineNum"> 2062</span> : : */</span> |
| <span id="L2063"><span class="lineNum"> 2063</span> : : int fdt_add_subnode(void *fdt, int parentoffset, const char *name);</span> |
| <span id="L2064"><span class="lineNum"> 2064</span> : : </span> |
| <span id="L2065"><span class="lineNum"> 2065</span> : : /**</span> |
| <span id="L2066"><span class="lineNum"> 2066</span> : : * fdt_del_node - delete a node (subtree)</span> |
| <span id="L2067"><span class="lineNum"> 2067</span> : : * @fdt: pointer to the device tree blob</span> |
| <span id="L2068"><span class="lineNum"> 2068</span> : : * @nodeoffset: offset of the node to nop</span> |
| <span id="L2069"><span class="lineNum"> 2069</span> : : *</span> |
| <span id="L2070"><span class="lineNum"> 2070</span> : : * fdt_del_node() will remove the given node, including all its</span> |
| <span id="L2071"><span class="lineNum"> 2071</span> : : * subnodes if any, from the blob.</span> |
| <span id="L2072"><span class="lineNum"> 2072</span> : : *</span> |
| <span id="L2073"><span class="lineNum"> 2073</span> : : * This function will delete data from the blob, and will therefore</span> |
| <span id="L2074"><span class="lineNum"> 2074</span> : : * change the offsets of some existing nodes.</span> |
| <span id="L2075"><span class="lineNum"> 2075</span> : : *</span> |
| <span id="L2076"><span class="lineNum"> 2076</span> : : * returns:</span> |
| <span id="L2077"><span class="lineNum"> 2077</span> : : * 0, on success</span> |
| <span id="L2078"><span class="lineNum"> 2078</span> : : * -FDT_ERR_BADOFFSET, nodeoffset did not point to FDT_BEGIN_NODE tag</span> |
| <span id="L2079"><span class="lineNum"> 2079</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L2080"><span class="lineNum"> 2080</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L2081"><span class="lineNum"> 2081</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L2082"><span class="lineNum"> 2082</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L2083"><span class="lineNum"> 2083</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L2084"><span class="lineNum"> 2084</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L2085"><span class="lineNum"> 2085</span> : : */</span> |
| <span id="L2086"><span class="lineNum"> 2086</span> : : int fdt_del_node(void *fdt, int nodeoffset);</span> |
| <span id="L2087"><span class="lineNum"> 2087</span> : : </span> |
| <span id="L2088"><span class="lineNum"> 2088</span> : : /**</span> |
| <span id="L2089"><span class="lineNum"> 2089</span> : : * fdt_overlay_apply - Applies a DT overlay on a base DT</span> |
| <span id="L2090"><span class="lineNum"> 2090</span> : : * @fdt: pointer to the base device tree blob</span> |
| <span id="L2091"><span class="lineNum"> 2091</span> : : * @fdto: pointer to the device tree overlay blob</span> |
| <span id="L2092"><span class="lineNum"> 2092</span> : : *</span> |
| <span id="L2093"><span class="lineNum"> 2093</span> : : * fdt_overlay_apply() will apply the given device tree overlay on the</span> |
| <span id="L2094"><span class="lineNum"> 2094</span> : : * given base device tree.</span> |
| <span id="L2095"><span class="lineNum"> 2095</span> : : *</span> |
| <span id="L2096"><span class="lineNum"> 2096</span> : : * Expect the base device tree to be modified, even if the function</span> |
| <span id="L2097"><span class="lineNum"> 2097</span> : : * returns an error.</span> |
| <span id="L2098"><span class="lineNum"> 2098</span> : : *</span> |
| <span id="L2099"><span class="lineNum"> 2099</span> : : * returns:</span> |
| <span id="L2100"><span class="lineNum"> 2100</span> : : * 0, on success</span> |
| <span id="L2101"><span class="lineNum"> 2101</span> : : * -FDT_ERR_NOSPACE, there's not enough space in the base device tree</span> |
| <span id="L2102"><span class="lineNum"> 2102</span> : : * -FDT_ERR_NOTFOUND, the overlay points to some inexistant nodes or</span> |
| <span id="L2103"><span class="lineNum"> 2103</span> : : * properties in the base DT</span> |
| <span id="L2104"><span class="lineNum"> 2104</span> : : * -FDT_ERR_BADPHANDLE,</span> |
| <span id="L2105"><span class="lineNum"> 2105</span> : : * -FDT_ERR_BADOVERLAY,</span> |
| <span id="L2106"><span class="lineNum"> 2106</span> : : * -FDT_ERR_NOPHANDLES,</span> |
| <span id="L2107"><span class="lineNum"> 2107</span> : : * -FDT_ERR_INTERNAL,</span> |
| <span id="L2108"><span class="lineNum"> 2108</span> : : * -FDT_ERR_BADLAYOUT,</span> |
| <span id="L2109"><span class="lineNum"> 2109</span> : : * -FDT_ERR_BADMAGIC,</span> |
| <span id="L2110"><span class="lineNum"> 2110</span> : : * -FDT_ERR_BADOFFSET,</span> |
| <span id="L2111"><span class="lineNum"> 2111</span> : : * -FDT_ERR_BADPATH,</span> |
| <span id="L2112"><span class="lineNum"> 2112</span> : : * -FDT_ERR_BADVERSION,</span> |
| <span id="L2113"><span class="lineNum"> 2113</span> : : * -FDT_ERR_BADSTRUCTURE,</span> |
| <span id="L2114"><span class="lineNum"> 2114</span> : : * -FDT_ERR_BADSTATE,</span> |
| <span id="L2115"><span class="lineNum"> 2115</span> : : * -FDT_ERR_TRUNCATED, standard meanings</span> |
| <span id="L2116"><span class="lineNum"> 2116</span> : : */</span> |
| <span id="L2117"><span class="lineNum"> 2117</span> : : int fdt_overlay_apply(void *fdt, void *fdto);</span> |
| <span id="L2118"><span class="lineNum"> 2118</span> : : </span> |
| <span id="L2119"><span class="lineNum"> 2119</span> : : /**</span> |
| <span id="L2120"><span class="lineNum"> 2120</span> : : * fdt_overlay_target_offset - retrieves the offset of a fragment's target</span> |
| <span id="L2121"><span class="lineNum"> 2121</span> : : * @fdt: Base device tree blob</span> |
| <span id="L2122"><span class="lineNum"> 2122</span> : : * @fdto: Device tree overlay blob</span> |
| <span id="L2123"><span class="lineNum"> 2123</span> : : * @fragment_offset: node offset of the fragment in the overlay</span> |
| <span id="L2124"><span class="lineNum"> 2124</span> : : * @pathp: pointer which receives the path of the target (or NULL)</span> |
| <span id="L2125"><span class="lineNum"> 2125</span> : : *</span> |
| <span id="L2126"><span class="lineNum"> 2126</span> : : * fdt_overlay_target_offset() retrieves the target offset in the base</span> |
| <span id="L2127"><span class="lineNum"> 2127</span> : : * device tree of a fragment, no matter how the actual targeting is</span> |
| <span id="L2128"><span class="lineNum"> 2128</span> : : * done (through a phandle or a path)</span> |
| <span id="L2129"><span class="lineNum"> 2129</span> : : *</span> |
| <span id="L2130"><span class="lineNum"> 2130</span> : : * returns:</span> |
| <span id="L2131"><span class="lineNum"> 2131</span> : : * the targeted node offset in the base device tree</span> |
| <span id="L2132"><span class="lineNum"> 2132</span> : : * Negative error code on error</span> |
| <span id="L2133"><span class="lineNum"> 2133</span> : : */</span> |
| <span id="L2134"><span class="lineNum"> 2134</span> : : int fdt_overlay_target_offset(const void *fdt, const void *fdto,</span> |
| <span id="L2135"><span class="lineNum"> 2135</span> : : int fragment_offset, char const **pathp);</span> |
| <span id="L2136"><span class="lineNum"> 2136</span> : : </span> |
| <span id="L2137"><span class="lineNum"> 2137</span> : : /**********************************************************************/</span> |
| <span id="L2138"><span class="lineNum"> 2138</span> : : /* Debugging / informational functions */</span> |
| <span id="L2139"><span class="lineNum"> 2139</span> : : /**********************************************************************/</span> |
| <span id="L2140"><span class="lineNum"> 2140</span> : : </span> |
| <span id="L2141"><span class="lineNum"> 2141</span> : : const char *fdt_strerror(int errval);</span> |
| <span id="L2142"><span class="lineNum"> 2142</span> : : </span> |
| <span id="L2143"><span class="lineNum"> 2143</span> : : #ifdef __cplusplus</span> |
| <span id="L2144"><span class="lineNum"> 2144</span> : : }</span> |
| <span id="L2145"><span class="lineNum"> 2145</span> : : #endif</span> |
| <span id="L2146"><span class="lineNum"> 2146</span> : : </span> |
| <span id="L2147"><span class="lineNum"> 2147</span> : : #endif /* LIBFDT_H */</span> |
| </pre> |
| </td> |
| </tr> |
| </table> |
| <br> |
| |
| <table width="100%" border=0 cellspacing=0 cellpadding=0> |
| <tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr> |
| <tr><td class="versionInfo">Generated by: <a href="https://github.com//linux-test-project/lcov" target="_parent">LCOV version 2.0-1</a></td></tr> |
| </table> |
| <br> |
| |
| </body> |
| </html> |
