« libraries « resources - csit - Integration tests</title>
<meta name='generator' content='cgit 1.2.3-korg'/>
<meta name='robots' content='noindex, nofollow'/>
<link rel='stylesheet' type='text/css' href='/cgit-data/cgit.css'/>
<script type='text/javascript' src='/cgit.js'></script>
<link rel='shortcut icon' href='/favicon.ico'/>
<link rel='alternate' title='Atom feed' href='http://git.fd.io/csit/atom/resources/libraries/bash/function/common.sh?h=oper-rls2410-241030' type='application/atom+xml'/>
<link rel='vcs-git' href='https://git.fd.io/csit' title='csit Git repository'/>
</head>
<body>
<div id="lfcollabprojects-header">
  <div class="gray-diagonal">
    <div class="header-inner">
      <a
        id="lfcollabprojects-logo"
        href="http://collabprojects.linuxfoundation.org"
        >Linux Foundation Collaborative Projects</a
      >
    </div>
  </div>
</div>
<div id='cgit'><table id='header'>
<tr>
<td class='logo' rowspan='2'><a href='/'><img src='/cgit-data/cgit.png' alt='cgit logo'/></a></td>
<td class='main'><a href='/'>index</a> : <a href='/csit/'>csit</a></td><td class='form'><form method='get'>
<input type='hidden' name='id' value='8aa83d922392c488df80cc1c490c0715b94aa250'/><select name='h' onchange='this.form.submit();'>
<option value='master'>master</option>
<option value='oper-20230522'>oper-20230522</option>
<option value='oper-20241028'>oper-20241028</option>
<option value='oper-230327'>oper-230327</option>
<option value='oper-230403'>oper-230403</option>
<option value='oper-230411'>oper-230411</option>
<option value='oper-230417'>oper-230417</option>
<option value='oper-230424'>oper-230424</option>
<option value='oper-230502'>oper-230502</option>
<option value='oper-230509'>oper-230509</option>
<option value='oper-230515'>oper-230515</option>
<option value='oper-230529'>oper-230529</option>
<option value='oper-230605'>oper-230605</option>
<option value='oper-230612'>oper-230612</option>
<option value='oper-230619'>oper-230619</option>
<option value='oper-230626'>oper-230626</option>
<option value='oper-230710'>oper-230710</option>
<option value='oper-230717'>oper-230717</option>
<option value='oper-230724'>oper-230724</option>
<option value='oper-230731'>oper-230731</option>
<option value='oper-230807'>oper-230807</option>
<option value='oper-230814'>oper-230814</option>
<option value='oper-230821'>oper-230821</option>
<option value='oper-230905'>oper-230905</option>
<option value='oper-230911'>oper-230911</option>
<option value='oper-230918'>oper-230918</option>
<option value='oper-230925'>oper-230925</option>
<option value='oper-231002'>oper-231002</option>
<option value='oper-231009'>oper-231009</option>
<option value='oper-231016'>oper-231016</option>
<option value='oper-231023'>oper-231023</option>
<option value='oper-231030'>oper-231030</option>
<option value='oper-231106'>oper-231106</option>
<option value='oper-231113'>oper-231113</option>
<option value='oper-231120'>oper-231120</option>
<option value='oper-231127'>oper-231127</option>
<option value='oper-231204'>oper-231204</option>
<option value='oper-231211'>oper-231211</option>
<option value='oper-231218'>oper-231218</option>
<option value='oper-240115'>oper-240115</option>
<option value='oper-240122'>oper-240122</option>
<option value='oper-240124'>oper-240124</option>
<option value='oper-240129'>oper-240129</option>
<option value='oper-240205'>oper-240205</option>
<option value='oper-240212'>oper-240212</option>
<option value='oper-240219'>oper-240219</option>
<option value='oper-240226'>oper-240226</option>
<option value='oper-240304'>oper-240304</option>
<option value='oper-240311'>oper-240311</option>
<option value='oper-240318'>oper-240318</option>
<option value='oper-240325'>oper-240325</option>
<option value='oper-240402'>oper-240402</option>
<option value='oper-240408'>oper-240408</option>
<option value='oper-240415'>oper-240415</option>
<option value='oper-240422'>oper-240422</option>
<option value='oper-240429'>oper-240429</option>
<option value='oper-240506'>oper-240506</option>
<option value='oper-240513'>oper-240513</option>
<option value='oper-240520'>oper-240520</option>
<option value='oper-240527'>oper-240527</option>
<option value='oper-240603'>oper-240603</option>
<option value='oper-240610'>oper-240610</option>
<option value='oper-240617'>oper-240617</option>
<option value='oper-240624'>oper-240624</option>
<option value='oper-240701'>oper-240701</option>
<option value='oper-240708'>oper-240708</option>
<option value='oper-240715'>oper-240715</option>
<option value='oper-240722'>oper-240722</option>
<option value='oper-240729'>oper-240729</option>
<option value='oper-240805'>oper-240805</option>
<option value='oper-240812'>oper-240812</option>
<option value='oper-240902'>oper-240902</option>
<option value='oper-240909'>oper-240909</option>
<option value='oper-240916'>oper-240916</option>
<option value='oper-240923'>oper-240923</option>
<option value='oper-240930'>oper-240930</option>
<option value='oper-241014'>oper-241014</option>
<option value='oper-241021'>oper-241021</option>
<option value='oper-241028'>oper-241028</option>
<option value='oper-241104'>oper-241104</option>
<option value='oper-241111'>oper-241111</option>
<option value='oper-241117'>oper-241117</option>
<option value='oper-241125'>oper-241125</option>
<option value='oper-241202'>oper-241202</option>
<option value='oper-241209'>oper-241209</option>
<option value='oper-250108'>oper-250108</option>
<option value='oper-250113'>oper-250113</option>
<option value='oper-250120'>oper-250120</option>
<option value='oper-rls2210-221128'>oper-rls2210-221128</option>
<option value='oper-rls2210-221205'>oper-rls2210-221205</option>
<option value='oper-rls2302-230320'>oper-rls2302-230320</option>
<option value='oper-rls2302-230327'>oper-rls2302-230327</option>
<option value='oper-rls2306-230525'>oper-rls2306-230525</option>
<option value='oper-rls2306-230529'>oper-rls2306-230529</option>
<option value='oper-rls2306-230605'>oper-rls2306-230605</option>
<option value='oper-rls2306-230612'>oper-rls2306-230612</option>
<option value='oper-rls2306-230619'>oper-rls2306-230619</option>
<option value='oper-rls2306-230626'>oper-rls2306-230626</option>
<option value='oper-rls2306-230629'>oper-rls2306-230629</option>
<option value='oper-rls2306-230710'>oper-rls2306-230710</option>
<option value='oper-rls2310-230921'>oper-rls2310-230921</option>
<option value='oper-rls2310-230925'>oper-rls2310-230925</option>
<option value='oper-rls2310-231016'>oper-rls2310-231016</option>
<option value='oper-rls2310-231023'>oper-rls2310-231023</option>
<option value='oper-rls2310-231030'>oper-rls2310-231030</option>
<option value='oper-rls2402-240125'>oper-rls2402-240125</option>
<option value='oper-rls2402-240129'>oper-rls2402-240129</option>
<option value='oper-rls2402-240205'>oper-rls2402-240205</option>
<option value='oper-rls2402-240219'>oper-rls2402-240219</option>
<option value='oper-rls2402-240304'>oper-rls2402-240304</option>
<option value='oper-rls2406-240523'>oper-rls2406-240523</option>
<option value='oper-rls2406-240603'>oper-rls2406-240603</option>
<option value='oper-rls2406-240610'>oper-rls2406-240610</option>
<option value='oper-rls2406-240617'>oper-rls2406-240617</option>
<option value='oper-rls2406-240624'>oper-rls2406-240624</option>
<option value='oper-rls2406-240701'>oper-rls2406-240701</option>
<option value='oper-rls2406-240708'>oper-rls2406-240708</option>
<option value='oper-rls2406-240715'>oper-rls2406-240715</option>
<option value='oper-rls2406-240722'>oper-rls2406-240722</option>
<option value='oper-rls2410-240926'>oper-rls2410-240926</option>
<option value='oper-rls2410-241017'>oper-rls2410-241017</option>
<option value='oper-rls2410-241030' selected='selected'>oper-rls2410-241030</option>
<option value='oper-rls2502-250123'>oper-rls2502-250123</option>
<option value='oper241007'>oper241007</option>
<option value='rls1606'>rls1606</option>
<option value='rls1609'>rls1609</option>
<option value='rls1701'>rls1701</option>
<option value='rls1704'>rls1704</option>
<option value='rls1707'>rls1707</option>
<option value='rls1710'>rls1710</option>
<option value='rls1801'>rls1801</option>
<option value='rls1801_2'>rls1801_2</option>
<option value='rls1804'>rls1804</option>
<option value='rls1807'>rls1807</option>
<option value='rls1810'>rls1810</option>
<option value='rls1901'>rls1901</option>
<option value='rls1901_1'>rls1901_1</option>
<option value='rls1901_2'>rls1901_2</option>
<option value='rls1901_3'>rls1901_3</option>
<option value='rls1904'>rls1904</option>
<option value='rls1904_1'>rls1904_1</option>
<option value='rls1904_2'>rls1904_2</option>
<option value='rls1908'>rls1908</option>
<option value='rls1908_1'>rls1908_1</option>
<option value='rls1908_2'>rls1908_2</option>
<option value='rls2001'>rls2001</option>
<option value='rls2005'>rls2005</option>
<option value='rls2009'>rls2009</option>
<option value='rls2009_lts'>rls2009_lts</option>
<option value='rls2101'>rls2101</option>
<option value='rls2101_1'>rls2101_1</option>
<option value='rls2106'>rls2106</option>
<option value='rls2110'>rls2110</option>
<option value='rls2202'>rls2202</option>
<option value='rls2206'>rls2206</option>
<option value='rls2210'>rls2210</option>
<option value='rls2302'>rls2302</option>
<option value='rls2306'>rls2306</option>
<option value='rls2310'>rls2310</option>
<option value='rls2402'>rls2402</option>
<option value='rls2406'>rls2406</option>
<option value='rls2410'>rls2410</option>
<option value='rls2502'>rls2502</option>
</select> <input type='submit' value='switch'/></form></td></tr>
<tr><td class='sub'>Integration tests</td><td class='sub right'>Grokmirror user</td></tr></table>
<table class='tabs'><tr><td>
<a href='/csit/about/?h=oper-rls2410-241030'>about</a><a href='/csit/?h=oper-rls2410-241030'>summary</a><a href='/csit/refs/?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>refs</a><a href='/csit/log/resources/libraries/bash/function/common.sh?h=oper-rls2410-241030'>log</a><a class='active' href='/csit/tree/resources/libraries/bash/function/common.sh?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>tree</a><a href='/csit/commit/resources/libraries/bash/function/common.sh?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>commit</a><a href='/csit/diff/resources/libraries/bash/function/common.sh?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>diff</a><a href='/csit/stats/resources/libraries/bash/function/common.sh?h=oper-rls2410-241030'>stats</a></td><td class='form'><form class='right' method='get' action='/csit/log/resources/libraries/bash/function/common.sh'>
<input type='hidden' name='h' value='oper-rls2410-241030'/><input type='hidden' name='id' value='8aa83d922392c488df80cc1c490c0715b94aa250'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/csit/tree/?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>root</a>/<a href='/csit/tree/resources?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>resources</a>/<a href='/csit/tree/resources/libraries?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>libraries</a>/<a href='/csit/tree/resources/libraries/bash?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>bash</a>/<a href='/csit/tree/resources/libraries/bash/function?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>function</a>/<a href='/csit/tree/resources/libraries/bash/function/common.sh?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>common.sh</a></div><div class='content'>blob: d191e783d4754f068278b92c9b69b5e2c59910ef (<a href='/csit/plain/resources/libraries/bash/function/common.sh?h=oper-rls2410-241030&amp;id=8aa83d922392c488df80cc1c490c0715b94aa250'>plain</a>)
<table summary='blob content' class='blob'>
<tr><td class='linenumbers'><pre><a id='n1' href='#n1'>1</a>
<a id='n2' href='#n2'>2</a>
<a id='n3' href='#n3'>3</a>
<a id='n4' href='#n4'>4</a>
<a id='n5' href='#n5'>5</a>
<a id='n6' href='#n6'>6</a>
<a id='n7' href='#n7'>7</a>
<a id='n8' href='#n8'>8</a>
<a id='n9' href='#n9'>9</a>
<a id='n10' href='#n10'>10</a>
<a id='n11' href='#n11'>11</a>
<a id='n12' href='#n12'>12</a>
<a id='n13' href='#n13'>13</a>
<a id='n14' href='#n14'>14</a>
<a id='n15' href='#n15'>15</a>
<a id='n16' href='#n16'>16</a>
<a id='n17' href='#n17'>17</a>
<a id='n18' href='#n18'>18</a>
<a id='n19' href='#n19'>19</a>
<a id='n20' href='#n20'>20</a>
<a id='n21' href='#n21'>21</a>
<a id='n22' href='#n22'>22</a>
<a id='n23' href='#n23'>23</a>
<a id='n24' href='#n24'>24</a>
<a id='n25' href='#n25'>25</a>
<a id='n26' href='#n26'>26</a>
<a id='n27' href='#n27'>27</a>
<a id='n28' href='#n28'>28</a>
<a id='n29' href='#n29'>29</a>
<a id='n30' href='#n30'>30</a>
<a id='n31' href='#n31'>31</a>
<a id='n32' href='#n32'>32</a>
<a id='n33' href='#n33'>33</a>
<a id='n34' href='#n34'>34</a>
<a id='n35' href='#n35'>35</a>
<a id='n36' href='#n36'>36</a>
<a id='n37' href='#n37'>37</a>
<a id='n38' href='#n38'>38</a>
<a id='n39' href='#n39'>39</a>
<a id='n40' href='#n40'>40</a>
<a id='n41' href='#n41'>41</a>
<a id='n42' href='#n42'>42</a>
<a id='n43' href='#n43'>43</a>
<a id='n44' href='#n44'>44</a>
<a id='n45' href='#n45'>45</a>
<a id='n46' href='#n46'>46</a>
<a id='n47' href='#n47'>47</a>
<a id='n48' href='#n48'>48</a>
<a id='n49' href='#n49'>49</a>
<a id='n50' href='#n50'>50</a>
<a id='n51' href='#n51'>51</a>
<a id='n52' href='#n52'>52</a>
<a id='n53' href='#n53'>53</a>
<a id='n54' href='#n54'>54</a>
<a id='n55' href='#n55'>55</a>
<a id='n56' href='#n56'>56</a>
<a id='n57' href='#n57'>57</a>
<a id='n58' href='#n58'>58</a>
<a id='n59' href='#n59'>59</a>
<a id='n60' href='#n60'>60</a>
<a id='n61' href='#n61'>61</a>
<a id='n62' href='#n62'>62</a>
<a id='n63' href='#n63'>63</a>
<a id='n64' href='#n64'>64</a>
<a id='n65' href='#n65'>65</a>
<a id='n66' href='#n66'>66</a>
<a id='n67' href='#n67'>67</a>
<a id='n68' href='#n68'>68</a>
<a id='n69' href='#n69'>69</a>
<a id='n70' href='#n70'>70</a>
<a id='n71' href='#n71'>71</a>
<a id='n72' href='#n72'>72</a>
<a id='n73' href='#n73'>73</a>
<a id='n74' href='#n74'>74</a>
<a id='n75' href='#n75'>75</a>
<a id='n76' href='#n76'>76</a>
<a id='n77' href='#n77'>77</a>
<a id='n78' href='#n78'>78</a>
<a id='n79' href='#n79'>79</a>
<a id='n80' href='#n80'>80</a>
<a id='n81' href='#n81'>81</a>
<a id='n82' href='#n82'>82</a>
<a id='n83' href='#n83'>83</a>
<a id='n84' href='#n84'>84</a>
<a id='n85' href='#n85'>85</a>
<a id='n86' href='#n86'>86</a>
<a id='n87' href='#n87'>87</a>
<a id='n88' href='#n88'>88</a>
<a id='n89' href='#n89'>89</a>
<a id='n90' href='#n90'>90</a>
<a id='n91' href='#n91'>91</a>
<a id='n92' href='#n92'>92</a>
<a id='n93' href='#n93'>93</a>
<a id='n94' href='#n94'>94</a>
<a id='n95' href='#n95'>95</a>
<a id='n96' href='#n96'>96</a>
<a id='n97' href='#n97'>97</a>
<a id='n98' href='#n98'>98</a>
<a id='n99' href='#n99'>99</a>
<a id='n100' href='#n100'>100</a>
<a id='n101' href='#n101'>101</a>
<a id='n102' href='#n102'>102</a>
<a id='n103' href='#n103'>103</a>
<a id='n104' href='#n104'>104</a>
<a id='n105' href='#n105'>105</a>
<a id='n106' href='#n106'>106</a>
<a id='n107' href='#n107'>107</a>
<a id='n108' href='#n108'>108</a>
<a id='n109' href='#n109'>109</a>
<a id='n110' href='#n110'>110</a>
<a id='n111' href='#n111'>111</a>
<a id='n112' href='#n112'>112</a>
<a id='n113' href='#n113'>113</a>
<a id='n114' href='#n114'>114</a>
<a id='n115' href='#n115'>115</a>
<a id='n116' href='#n116'>116</a>
<a id='n117' href='#n117'>117</a>
<a id='n118' href='#n118'>118</a>
<a id='n119' href='#n119'>119</a>
<a id='n120' href='#n120'>120</a>
<a id='n121' href='#n121'>121</a>
<a id='n122' href='#n122'>122</a>
<a id='n123' href='#n123'>123</a>
<a id='n124' href='#n124'>124</a>
<a id='n125' href='#n125'>125</a>
<a id='n126' href='#n126'>126</a>
<a id='n127' href='#n127'>127</a>
<a id='n128' href='#n128'>128</a>
<a id='n129' href='#n129'>129</a>
<a id='n130' href='#n130'>130</a>
<a id='n131' href='#n131'>131</a>
<a id='n132' href='#n132'>132</a>
<a id='n133' href='#n133'>133</a>
<a id='n134' href='#n134'>134</a>
<a id='n135' href='#n135'>135</a>
<a id='n136' href='#n136'>136</a>
<a id='n137' href='#n137'>137</a>
<a id='n138' href='#n138'>138</a>
<a id='n139' href='#n139'>139</a>
<a id='n140' href='#n140'>140</a>
<a id='n141' href='#n141'>141</a>
<a id='n142' href='#n142'>142</a>
<a id='n143' href='#n143'>143</a>
<a id='n144' href='#n144'>144</a>
<a id='n145' href='#n145'>145</a>
<a id='n146' href='#n146'>146</a>
<a id='n147' href='#n147'>147</a>
<a id='n148' href='#n148'>148</a>
<a id='n149' href='#n149'>149</a>
<a id='n150' href='#n150'>150</a>
<a id='n151' href='#n151'>151</a>
<a id='n152' href='#n152'>152</a>
<a id='n153' href='#n153'>153</a>
<a id='n154' href='#n154'>154</a>
<a id='n155' href='#n155'>155</a>
<a id='n156' href='#n156'>156</a>
<a id='n157' href='#n157'>157</a>
<a id='n158' href='#n158'>158</a>
<a id='n159' href='#n159'>159</a>
<a id='n160' href='#n160'>160</a>
<a id='n161' href='#n161'>161</a>
<a id='n162' href='#n162'>162</a>
<a id='n163' href='#n163'>163</a>
<a id='n164' href='#n164'>164</a>
<a id='n165' href='#n165'>165</a>
<a id='n166' href='#n166'>166</a>
<a id='n167' href='#n167'>167</a>
<a id='n168' href='#n168'>168</a>
<a id='n169' href='#n169'>169</a>
<a id='n170' href='#n170'>170</a>
<a id='n171' href='#n171'>171</a>
<a id='n172' href='#n172'>172</a>
<a id='n173' href='#n173'>173</a>
<a id='n174' href='#n174'>174</a>
<a id='n175' href='#n175'>175</a>
<a id='n176' href='#n176'>176</a>
<a id='n177' href='#n177'>177</a>
<a id='n178' href='#n178'>178</a>
<a id='n179' href='#n179'>179</a>
<a id='n180' href='#n180'>180</a>
<a id='n181' href='#n181'>181</a>
<a id='n182' href='#n182'>182</a>
<a id='n183' href='#n183'>183</a>
<a id='n184' href='#n184'>184</a>
<a id='n185' href='#n185'>185</a>
<a id='n186' href='#n186'>186</a>
<a id='n187' href='#n187'>187</a>
<a id='n188' href='#n188'>188</a>
<a id='n189' href='#n189'>189</a>
<a id='n190' href='#n190'>190</a>
<a id='n191' href='#n191'>191</a>
<a id='n192' href='#n192'>192</a>
<a id='n193' href='#n193'>193</a>
<a id='n194' href='#n194'>194</a>
<a id='n195' href='#n195'>195</a>
<a id='n196' href='#n196'>196</a>
<a id='n197' href='#n197'>197</a>
<a id='n198' href='#n198'>198</a>
<a id='n199' href='#n199'>199</a>
<a id='n200' href='#n200'>200</a>
<a id='n201' href='#n201'>201</a>
<a id='n202' href='#n202'>202</a>
<a id='n203' href='#n203'>203</a>
<a id='n204' href='#n204'>204</a>
<a id='n205' href='#n205'>205</a>
<a id='n206' href='#n206'>206</a>
<a id='n207' href='#n207'>207</a>
<a id='n208' href='#n208'>208</a>
<a id='n209' href='#n209'>209</a>
<a id='n210' href='#n210'>210</a>
<a id='n211' href='#n211'>211</a>
<a id='n212' href='#n212'>212</a>
<a id='n213' href='#n213'>213</a>
<a id='n214' href='#n214'>214</a>
<a id='n215' href='#n215'>215</a>
<a id='n216' href='#n216'>216</a>
<a id='n217' href='#n217'>217</a>
<a id='n218' href='#n218'>218</a>
<a id='n219' href='#n219'>219</a>
<a id='n220' href='#n220'>220</a>
<a id='n221' href='#n221'>221</a>
<a id='n222' href='#n222'>222</a>
<a id='n223' href='#n223'>223</a>
<a id='n224' href='#n224'>224</a>
<a id='n225' href='#n225'>225</a>
<a id='n226' href='#n226'>226</a>
<a id='n227' href='#n227'>227</a>
<a id='n228' href='#n228'>228</a>
<a id='n229' href='#n229'>229</a>
<a id='n230' href='#n230'>230</a>
<a id='n231' href='#n231'>231</a>
<a id='n232' href='#n232'>232</a>
<a id='n233' href='#n233'>233</a>
<a id='n234' href='#n234'>234</a>
<a id='n235' href='#n235'>235</a>
<a id='n236' href='#n236'>236</a>
<a id='n237' href='#n237'>237</a>
<a id='n238' href='#n238'>238</a>
<a id='n239' href='#n239'>239</a>
<a id='n240' href='#n240'>240</a>
<a id='n241' href='#n241'>241</a>
<a id='n242' href='#n242'>242</a>
<a id='n243' href='#n243'>243</a>
<a id='n244' href='#n244'>244</a>
<a id='n245' href='#n245'>245</a>
<a id='n246' href='#n246'>246</a>
<a id='n247' href='#n247'>247</a>
<a id='n248' href='#n248'>248</a>
<a id='n249' href='#n249'>249</a>
<a id='n250' href='#n250'>250</a>
<a id='n251' href='#n251'>251</a>
<a id='n252' href='#n252'>252</a>
<a id='n253' href='#n253'>253</a>
<a id='n254' href='#n254'>254</a>
<a id='n255' href='#n255'>255</a>
<a id='n256' href='#n256'>256</a>
<a id='n257' href='#n257'>257</a>
<a id='n258' href='#n258'>258</a>
<a id='n259' href='#n259'>259</a>
<a id='n260' href='#n260'>260</a>
<a id='n261' href='#n261'>261</a>
<a id='n262' href='#n262'>262</a>
<a id='n263' href='#n263'>263</a>
<a id='n264' href='#n264'>264</a>
<a id='n265' href='#n265'>265</a>
<a id='n266' href='#n266'>266</a>
<a id='n267' href='#n267'>267</a>
<a id='n268' href='#n268'>268</a>
<a id='n269' href='#n269'>269</a>
<a id='n270' href='#n270'>270</a>
<a id='n271' href='#n271'>271</a>
<a id='n272' href='#n272'>272</a>
<a id='n273' href='#n273'>273</a>
<a id='n274' href='#n274'>274</a>
<a id='n275' href='#n275'>275</a>
<a id='n276' href='#n276'>276</a>
<a id='n277' href='#n277'>277</a>
<a id='n278' href='#n278'>278</a>
<a id='n279' href='#n279'>279</a>
<a id='n280' href='#n280'>280</a>
<a id='n281' href='#n281'>281</a>
<a id='n282' href='#n282'>282</a>
<a id='n283' href='#n283'>283</a>
<a id='n284' href='#n284'>284</a>
<a id='n285' href='#n285'>285</a>
<a id='n286' href='#n286'>286</a>
<a id='n287' href='#n287'>287</a>
<a id='n288' href='#n288'>288</a>
<a id='n289' href='#n289'>289</a>
<a id='n290' href='#n290'>290</a>
<a id='n291' href='#n291'>291</a>
<a id='n292' href='#n292'>292</a>
<a id='n293' href='#n293'>293</a>
<a id='n294' href='#n294'>294</a>
<a id='n295' href='#n295'>295</a>
<a id='n296' href='#n296'>296</a>
<a id='n297' href='#n297'>297</a>
<a id='n298' href='#n298'>298</a>
<a id='n299' href='#n299'>299</a>
<a id='n300' href='#n300'>300</a>
<a id='n301' href='#n301'>301</a>
<a id='n302' href='#n302'>302</a>
<a id='n303' href='#n303'>303</a>
<a id='n304' href='#n304'>304</a>
<a id='n305' href='#n305'>305</a>
<a id='n306' href='#n306'>306</a>
<a id='n307' href='#n307'>307</a>
<a id='n308' href='#n308'>308</a>
<a id='n309' href='#n309'>309</a>
<a id='n310' href='#n310'>310</a>
<a id='n311' href='#n311'>311</a>
<a id='n312' href='#n312'>312</a>
<a id='n313' href='#n313'>313</a>
<a id='n314' href='#n314'>314</a>
<a id='n315' href='#n315'>315</a>
<a id='n316' href='#n316'>316</a>
<a id='n317' href='#n317'>317</a>
<a id='n318' href='#n318'>318</a>
<a id='n319' href='#n319'>319</a>
<a id='n320' href='#n320'>320</a>
<a id='n321' href='#n321'>321</a>
<a id='n322' href='#n322'>322</a>
<a id='n323' href='#n323'>323</a>
<a id='n324' href='#n324'>324</a>
<a id='n325' href='#n325'>325</a>
<a id='n326' href='#n326'>326</a>
<a id='n327' href='#n327'>327</a>
<a id='n328' href='#n328'>328</a>
<a id='n329' href='#n329'>329</a>
<a id='n330' href='#n330'>330</a>
<a id='n331' href='#n331'>331</a>
<a id='n332' href='#n332'>332</a>
<a id='n333' href='#n333'>333</a>
<a id='n334' href='#n334'>334</a>
<a id='n335' href='#n335'>335</a>
<a id='n336' href='#n336'>336</a>
<a id='n337' href='#n337'>337</a>
<a id='n338' href='#n338'>338</a>
<a id='n339' href='#n339'>339</a>
<a id='n340' href='#n340'>340</a>
<a id='n341' href='#n341'>341</a>
<a id='n342' href='#n342'>342</a>
<a id='n343' href='#n343'>343</a>
<a id='n344' href='#n344'>344</a>
<a id='n345' href='#n345'>345</a>
<a id='n346' href='#n346'>346</a>
<a id='n347' href='#n347'>347</a>
<a id='n348' href='#n348'>348</a>
<a id='n349' href='#n349'>349</a>
<a id='n350' href='#n350'>350</a>
<a id='n351' href='#n351'>351</a>
<a id='n352' href='#n352'>352</a>
<a id='n353' href='#n353'>353</a>
<a id='n354' href='#n354'>354</a>
<a id='n355' href='#n355'>355</a>
<a id='n356' href='#n356'>356</a>
<a id='n357' href='#n357'>357</a>
<a id='n358' href='#n358'>358</a>
<a id='n359' href='#n359'>359</a>
<a id='n360' href='#n360'>360</a>
<a id='n361' href='#n361'>361</a>
<a id='n362' href='#n362'>362</a>
<a id='n363' href='#n363'>363</a>
<a id='n364' href='#n364'>364</a>
<a id='n365' href='#n365'>365</a>
<a id='n366' href='#n366'>366</a>
<a id='n367' href='#n367'>367</a>
<a id='n368' href='#n368'>368</a>
<a id='n369' href='#n369'>369</a>
<a id='n370' href='#n370'>370</a>
<a id='n371' href='#n371'>371</a>
<a id='n372' href='#n372'>372</a>
<a id='n373' href='#n373'>373</a>
<a id='n374' href='#n374'>374</a>
<a id='n375' href='#n375'>375</a>
<a id='n376' href='#n376'>376</a>
<a id='n377' href='#n377'>377</a>
<a id='n378' href='#n378'>378</a>
<a id='n379' href='#n379'>379</a>
<a id='n380' href='#n380'>380</a>
<a id='n381' href='#n381'>381</a>
<a id='n382' href='#n382'>382</a>
<a id='n383' href='#n383'>383</a>
<a id='n384' href='#n384'>384</a>
<a id='n385' href='#n385'>385</a>
<a id='n386' href='#n386'>386</a>
<a id='n387' href='#n387'>387</a>
<a id='n388' href='#n388'>388</a>
<a id='n389' href='#n389'>389</a>
<a id='n390' href='#n390'>390</a>
<a id='n391' href='#n391'>391</a>
<a id='n392' href='#n392'>392</a>
<a id='n393' href='#n393'>393</a>
<a id='n394' href='#n394'>394</a>
<a id='n395' href='#n395'>395</a>
<a id='n396' href='#n396'>396</a>
<a id='n397' href='#n397'>397</a>
<a id='n398' href='#n398'>398</a>
<a id='n399' href='#n399'>399</a>
<a id='n400' href='#n400'>400</a>
<a id='n401' href='#n401'>401</a>
<a id='n402' href='#n402'>402</a>
<a id='n403' href='#n403'>403</a>
<a id='n404' href='#n404'>404</a>
<a id='n405' href='#n405'>405</a>
<a id='n406' href='#n406'>406</a>
<a id='n407' href='#n407'>407</a>
<a id='n408' href='#n408'>408</a>
<a id='n409' href='#n409'>409</a>
<a id='n410' href='#n410'>410</a>
<a id='n411' href='#n411'>411</a>
<a id='n412' href='#n412'>412</a>
<a id='n413' href='#n413'>413</a>
<a id='n414' href='#n414'>414</a>
<a id='n415' href='#n415'>415</a>
<a id='n416' href='#n416'>416</a>
<a id='n417' href='#n417'>417</a>
<a id='n418' href='#n418'>418</a>
<a id='n419' href='#n419'>419</a>
<a id='n420' href='#n420'>420</a>
<a id='n421' href='#n421'>421</a>
<a id='n422' href='#n422'>422</a>
<a id='n423' href='#n423'>423</a>
<a id='n424' href='#n424'>424</a>
<a id='n425' href='#n425'>425</a>
<a id='n426' href='#n426'>426</a>
<a id='n427' href='#n427'>427</a>
<a id='n428' href='#n428'>428</a>
<a id='n429' href='#n429'>429</a>
<a id='n430' href='#n430'>430</a>
<a id='n431' href='#n431'>431</a>
<a id='n432' href='#n432'>432</a>
<a id='n433' href='#n433'>433</a>
<a id='n434' href='#n434'>434</a>
<a id='n435' href='#n435'>435</a>
<a id='n436' href='#n436'>436</a>
<a id='n437' href='#n437'>437</a>
<a id='n438' href='#n438'>438</a>
<a id='n439' href='#n439'>439</a>
<a id='n440' href='#n440'>440</a>
<a id='n441' href='#n441'>441</a>
<a id='n442' href='#n442'>442</a>
<a id='n443' href='#n443'>443</a>
<a id='n444' href='#n444'>444</a>
<a id='n445' href='#n445'>445</a>
<a id='n446' href='#n446'>446</a>
<a id='n447' href='#n447'>447</a>
<a id='n448' href='#n448'>448</a>
<a id='n449' href='#n449'>449</a>
<a id='n450' href='#n450'>450</a>
<a id='n451' href='#n451'>451</a>
<a id='n452' href='#n452'>452</a>
<a id='n453' href='#n453'>453</a>
<a id='n454' href='#n454'>454</a>
<a id='n455' href='#n455'>455</a>
<a id='n456' href='#n456'>456</a>
<a id='n457' href='#n457'>457</a>
<a id='n458' href='#n458'>458</a>
<a id='n459' href='#n459'>459</a>
<a id='n460' href='#n460'>460</a>
<a id='n461' href='#n461'>461</a>
<a id='n462' href='#n462'>462</a>
<a id='n463' href='#n463'>463</a>
<a id='n464' href='#n464'>464</a>
<a id='n465' href='#n465'>465</a>
<a id='n466' href='#n466'>466</a>
<a id='n467' href='#n467'>467</a>
<a id='n468' href='#n468'>468</a>
<a id='n469' href='#n469'>469</a>
<a id='n470' href='#n470'>470</a>
<a id='n471' href='#n471'>471</a>
<a id='n472' href='#n472'>472</a>
<a id='n473' href='#n473'>473</a>
<a id='n474' href='#n474'>474</a>
<a id='n475' href='#n475'>475</a>
<a id='n476' href='#n476'>476</a>
<a id='n477' href='#n477'>477</a>
<a id='n478' href='#n478'>478</a>
<a id='n479' href='#n479'>479</a>
<a id='n480' href='#n480'>480</a>
<a id='n481' href='#n481'>481</a>
<a id='n482' href='#n482'>482</a>
<a id='n483' href='#n483'>483</a>
<a id='n484' href='#n484'>484</a>
<a id='n485' href='#n485'>485</a>
<a id='n486' href='#n486'>486</a>
<a id='n487' href='#n487'>487</a>
<a id='n488' href='#n488'>488</a>
<a id='n489' href='#n489'>489</a>
<a id='n490' href='#n490'>490</a>
<a id='n491' href='#n491'>491</a>
<a id='n492' href='#n492'>492</a>
<a id='n493' href='#n493'>493</a>
<a id='n494' href='#n494'>494</a>
<a id='n495' href='#n495'>495</a>
<a id='n496' href='#n496'>496</a>
<a id='n497' href='#n497'>497</a>
<a id='n498' href='#n498'>498</a>
<a id='n499' href='#n499'>499</a>
<a id='n500' href='#n500'>500</a>
<a id='n501' href='#n501'>501</a>
<a id='n502' href='#n502'>502</a>
<a id='n503' href='#n503'>503</a>
<a id='n504' href='#n504'>504</a>
<a id='n505' href='#n505'>505</a>
<a id='n506' href='#n506'>506</a>
<a id='n507' href='#n507'>507</a>
<a id='n508' href='#n508'>508</a>
<a id='n509' href='#n509'>509</a>
<a id='n510' href='#n510'>510</a>
<a id='n511' href='#n511'>511</a>
<a id='n512' href='#n512'>512</a>
<a id='n513' href='#n513'>513</a>
<a id='n514' href='#n514'>514</a>
<a id='n515' href='#n515'>515</a>
<a id='n516' href='#n516'>516</a>
<a id='n517' href='#n517'>517</a>
<a id='n518' href='#n518'>518</a>
<a id='n519' href='#n519'>519</a>
<a id='n520' href='#n520'>520</a>
<a id='n521' href='#n521'>521</a>
<a id='n522' href='#n522'>522</a>
<a id='n523' href='#n523'>523</a>
<a id='n524' href='#n524'>524</a>
<a id='n525' href='#n525'>525</a>
<a id='n526' href='#n526'>526</a>
<a id='n527' href='#n527'>527</a>
<a id='n528' href='#n528'>528</a>
<a id='n529' href='#n529'>529</a>
<a id='n530' href='#n530'>530</a>
<a id='n531' href='#n531'>531</a>
<a id='n532' href='#n532'>532</a>
<a id='n533' href='#n533'>533</a>
<a id='n534' href='#n534'>534</a>
<a id='n535' href='#n535'>535</a>
<a id='n536' href='#n536'>536</a>
<a id='n537' href='#n537'>537</a>
<a id='n538' href='#n538'>538</a>
<a id='n539' href='#n539'>539</a>
<a id='n540' href='#n540'>540</a>
<a id='n541' href='#n541'>541</a>
<a id='n542' href='#n542'>542</a>
<a id='n543' href='#n543'>543</a>
<a id='n544' href='#n544'>544</a>
<a id='n545' href='#n545'>545</a>
<a id='n546' href='#n546'>546</a>
<a id='n547' href='#n547'>547</a>
<a id='n548' href='#n548'>548</a>
<a id='n549' href='#n549'>549</a>
<a id='n550' href='#n550'>550</a>
<a id='n551' href='#n551'>551</a>
<a id='n552' href='#n552'>552</a>
<a id='n553' href='#n553'>553</a>
<a id='n554' href='#n554'>554</a>
<a id='n555' href='#n555'>555</a>
<a id='n556' href='#n556'>556</a>
<a id='n557' href='#n557'>557</a>
<a id='n558' href='#n558'>558</a>
<a id='n559' href='#n559'>559</a>
<a id='n560' href='#n560'>560</a>
<a id='n561' href='#n561'>561</a>
<a id='n562' href='#n562'>562</a>
<a id='n563' href='#n563'>563</a>
<a id='n564' href='#n564'>564</a>
<a id='n565' href='#n565'>565</a>
<a id='n566' href='#n566'>566</a>
<a id='n567' href='#n567'>567</a>
<a id='n568' href='#n568'>568</a>
<a id='n569' href='#n569'>569</a>
<a id='n570' href='#n570'>570</a>
<a id='n571' href='#n571'>571</a>
<a id='n572' href='#n572'>572</a>
<a id='n573' href='#n573'>573</a>
<a id='n574' href='#n574'>574</a>
<a id='n575' href='#n575'>575</a>
<a id='n576' href='#n576'>576</a>
<a id='n577' href='#n577'>577</a>
<a id='n578' href='#n578'>578</a>
<a id='n579' href='#n579'>579</a>
<a id='n580' href='#n580'>580</a>
<a id='n581' href='#n581'>581</a>
<a id='n582' href='#n582'>582</a>
<a id='n583' href='#n583'>583</a>
<a id='n584' href='#n584'>584</a>
<a id='n585' href='#n585'>585</a>
<a id='n586' href='#n586'>586</a>
<a id='n587' href='#n587'>587</a>
<a id='n588' href='#n588'>588</a>
<a id='n589' href='#n589'>589</a>
<a id='n590' href='#n590'>590</a>
<a id='n591' href='#n591'>591</a>
<a id='n592' href='#n592'>592</a>
<a id='n593' href='#n593'>593</a>
<a id='n594' href='#n594'>594</a>
<a id='n595' href='#n595'>595</a>
<a id='n596' href='#n596'>596</a>
<a id='n597' href='#n597'>597</a>
<a id='n598' href='#n598'>598</a>
<a id='n599' href='#n599'>599</a>
<a id='n600' href='#n600'>600</a>
<a id='n601' href='#n601'>601</a>
<a id='n602' href='#n602'>602</a>
<a id='n603' href='#n603'>603</a>
<a id='n604' href='#n604'>604</a>
<a id='n605' href='#n605'>605</a>
<a id='n606' href='#n606'>606</a>
<a id='n607' href='#n607'>607</a>
<a id='n608' href='#n608'>608</a>
<a id='n609' href='#n609'>609</a>
<a id='n610' href='#n610'>610</a>
<a id='n611' href='#n611'>611</a>
<a id='n612' href='#n612'>612</a>
<a id='n613' href='#n613'>613</a>
<a id='n614' href='#n614'>614</a>
<a id='n615' href='#n615'>615</a>
<a id='n616' href='#n616'>616</a>
<a id='n617' href='#n617'>617</a>
<a id='n618' href='#n618'>618</a>
<a id='n619' href='#n619'>619</a>
<a id='n620' href='#n620'>620</a>
<a id='n621' href='#n621'>621</a>
<a id='n622' href='#n622'>622</a>
<a id='n623' href='#n623'>623</a>
<a id='n624' href='#n624'>624</a>
<a id='n625' href='#n625'>625</a>
<a id='n626' href='#n626'>626</a>
<a id='n627' href='#n627'>627</a>
<a id='n628' href='#n628'>628</a>
<a id='n629' href='#n629'>629</a>
<a id='n630' href='#n630'>630</a>
<a id='n631' href='#n631'>631</a>
<a id='n632' href='#n632'>632</a>
<a id='n633' href='#n633'>633</a>
<a id='n634' href='#n634'>634</a>
<a id='n635' href='#n635'>635</a>
<a id='n636' href='#n636'>636</a>
<a id='n637' href='#n637'>637</a>
<a id='n638' href='#n638'>638</a>
<a id='n639' href='#n639'>639</a>
<a id='n640' href='#n640'>640</a>
<a id='n641' href='#n641'>641</a>
<a id='n642' href='#n642'>642</a>
<a id='n643' href='#n643'>643</a>
<a id='n644' href='#n644'>644</a>
<a id='n645' href='#n645'>645</a>
<a id='n646' href='#n646'>646</a>
<a id='n647' href='#n647'>647</a>
<a id='n648' href='#n648'>648</a>
<a id='n649' href='#n649'>649</a>
<a id='n650' href='#n650'>650</a>
<a id='n651' href='#n651'>651</a>
<a id='n652' href='#n652'>652</a>
<a id='n653' href='#n653'>653</a>
<a id='n654' href='#n654'>654</a>
<a id='n655' href='#n655'>655</a>
<a id='n656' href='#n656'>656</a>
<a id='n657' href='#n657'>657</a>
<a id='n658' href='#n658'>658</a>
<a id='n659' href='#n659'>659</a>
<a id='n660' href='#n660'>660</a>
<a id='n661' href='#n661'>661</a>
<a id='n662' href='#n662'>662</a>
<a id='n663' href='#n663'>663</a>
<a id='n664' href='#n664'>664</a>
<a id='n665' href='#n665'>665</a>
<a id='n666' href='#n666'>666</a>
<a id='n667' href='#n667'>667</a>
<a id='n668' href='#n668'>668</a>
<a id='n669' href='#n669'>669</a>
<a id='n670' href='#n670'>670</a>
<a id='n671' href='#n671'>671</a>
<a id='n672' href='#n672'>672</a>
<a id='n673' href='#n673'>673</a>
<a id='n674' href='#n674'>674</a>
<a id='n675' href='#n675'>675</a>
<a id='n676' href='#n676'>676</a>
<a id='n677' href='#n677'>677</a>
<a id='n678' href='#n678'>678</a>
<a id='n679' href='#n679'>679</a>
<a id='n680' href='#n680'>680</a>
<a id='n681' href='#n681'>681</a>
<a id='n682' href='#n682'>682</a>
<a id='n683' href='#n683'>683</a>
<a id='n684' href='#n684'>684</a>
<a id='n685' href='#n685'>685</a>
<a id='n686' href='#n686'>686</a>
<a id='n687' href='#n687'>687</a>
<a id='n688' href='#n688'>688</a>
<a id='n689' href='#n689'>689</a>
<a id='n690' href='#n690'>690</a>
<a id='n691' href='#n691'>691</a>
<a id='n692' href='#n692'>692</a>
<a id='n693' href='#n693'>693</a>
<a id='n694' href='#n694'>694</a>
<a id='n695' href='#n695'>695</a>
<a id='n696' href='#n696'>696</a>
<a id='n697' href='#n697'>697</a>
<a id='n698' href='#n698'>698</a>
<a id='n699' href='#n699'>699</a>
<a id='n700' href='#n700'>700</a>
<a id='n701' href='#n701'>701</a>
<a id='n702' href='#n702'>702</a>
<a id='n703' href='#n703'>703</a>
<a id='n704' href='#n704'>704</a>
<a id='n705' href='#n705'>705</a>
<a id='n706' href='#n706'>706</a>
<a id='n707' href='#n707'>707</a>
<a id='n708' href='#n708'>708</a>
<a id='n709' href='#n709'>709</a>
<a id='n710' href='#n710'>710</a>
<a id='n711' href='#n711'>711</a>
<a id='n712' href='#n712'>712</a>
<a id='n713' href='#n713'>713</a>
<a id='n714' href='#n714'>714</a>
<a id='n715' href='#n715'>715</a>
<a id='n716' href='#n716'>716</a>
<a id='n717' href='#n717'>717</a>
<a id='n718' href='#n718'>718</a>
<a id='n719' href='#n719'>719</a>
<a id='n720' href='#n720'>720</a>
<a id='n721' href='#n721'>721</a>
<a id='n722' href='#n722'>722</a>
<a id='n723' href='#n723'>723</a>
<a id='n724' href='#n724'>724</a>
<a id='n725' href='#n725'>725</a>
<a id='n726' href='#n726'>726</a>
<a id='n727' href='#n727'>727</a>
<a id='n728' href='#n728'>728</a>
<a id='n729' href='#n729'>729</a>
<a id='n730' href='#n730'>730</a>
<a id='n731' href='#n731'>731</a>
<a id='n732' href='#n732'>732</a>
<a id='n733' href='#n733'>733</a>
<a id='n734' href='#n734'>734</a>
<a id='n735' href='#n735'>735</a>
<a id='n736' href='#n736'>736</a>
<a id='n737' href='#n737'>737</a>
<a id='n738' href='#n738'>738</a>
<a id='n739' href='#n739'>739</a>
<a id='n740' href='#n740'>740</a>
<a id='n741' href='#n741'>741</a>
<a id='n742' href='#n742'>742</a>
<a id='n743' href='#n743'>743</a>
<a id='n744' href='#n744'>744</a>
<a id='n745' href='#n745'>745</a>
<a id='n746' href='#n746'>746</a>
<a id='n747' href='#n747'>747</a>
<a id='n748' href='#n748'>748</a>
<a id='n749' href='#n749'>749</a>
<a id='n750' href='#n750'>750</a>
<a id='n751' href='#n751'>751</a>
<a id='n752' href='#n752'>752</a>
<a id='n753' href='#n753'>753</a>
<a id='n754' href='#n754'>754</a>
<a id='n755' href='#n755'>755</a>
<a id='n756' href='#n756'>756</a>
<a id='n757' href='#n757'>757</a>
<a id='n758' href='#n758'>758</a>
<a id='n759' href='#n759'>759</a>
<a id='n760' href='#n760'>760</a>
<a id='n761' href='#n761'>761</a>
<a id='n762' href='#n762'>762</a>
<a id='n763' href='#n763'>763</a>
<a id='n764' href='#n764'>764</a>
<a id='n765' href='#n765'>765</a>
<a id='n766' href='#n766'>766</a>
<a id='n767' href='#n767'>767</a>
<a id='n768' href='#n768'>768</a>
<a id='n769' href='#n769'>769</a>
<a id='n770' href='#n770'>770</a>
<a id='n771' href='#n771'>771</a>
<a id='n772' href='#n772'>772</a>
<a id='n773' href='#n773'>773</a>
<a id='n774' href='#n774'>774</a>
<a id='n775' href='#n775'>775</a>
<a id='n776' href='#n776'>776</a>
<a id='n777' href='#n777'>777</a>
<a id='n778' href='#n778'>778</a>
<a id='n779' href='#n779'>779</a>
<a id='n780' href='#n780'>780</a>
<a id='n781' href='#n781'>781</a>
<a id='n782' href='#n782'>782</a>
<a id='n783' href='#n783'>783</a>
<a id='n784' href='#n784'>784</a>
<a id='n785' href='#n785'>785</a>
<a id='n786' href='#n786'>786</a>
<a id='n787' href='#n787'>787</a>
<a id='n788' href='#n788'>788</a>
<a id='n789' href='#n789'>789</a>
<a id='n790' href='#n790'>790</a>
<a id='n791' href='#n791'>791</a>
<a id='n792' href='#n792'>792</a>
<a id='n793' href='#n793'>793</a>
<a id='n794' href='#n794'>794</a>
<a id='n795' href='#n795'>795</a>
<a id='n796' href='#n796'>796</a>
<a id='n797' href='#n797'>797</a>
<a id='n798' href='#n798'>798</a>
<a id='n799' href='#n799'>799</a>
<a id='n800' href='#n800'>800</a>
<a id='n801' href='#n801'>801</a>
<a id='n802' href='#n802'>802</a>
<a id='n803' href='#n803'>803</a>
<a id='n804' href='#n804'>804</a>
<a id='n805' href='#n805'>805</a>
<a id='n806' href='#n806'>806</a>
<a id='n807' href='#n807'>807</a>
<a id='n808' href='#n808'>808</a>
<a id='n809' href='#n809'>809</a>
<a id='n810' href='#n810'>810</a>
<a id='n811' href='#n811'>811</a>
<a id='n812' href='#n812'>812</a>
<a id='n813' href='#n813'>813</a>
<a id='n814' href='#n814'>814</a>
<a id='n815' href='#n815'>815</a>
<a id='n816' href='#n816'>816</a>
<a id='n817' href='#n817'>817</a>
<a id='n818' href='#n818'>818</a>
<a id='n819' href='#n819'>819</a>
<a id='n820' href='#n820'>820</a>
<a id='n821' href='#n821'>821</a>
<a id='n822' href='#n822'>822</a>
<a id='n823' href='#n823'>823</a>
<a id='n824' href='#n824'>824</a>
<a id='n825' href='#n825'>825</a>
<a id='n826' href='#n826'>826</a>
<a id='n827' href='#n827'>827</a>
<a id='n828' href='#n828'>828</a>
<a id='n829' href='#n829'>829</a>
<a id='n830' href='#n830'>830</a>
<a id='n831' href='#n831'>831</a>
<a id='n832' href='#n832'>832</a>
<a id='n833' href='#n833'>833</a>
<a id='n834' href='#n834'>834</a>
<a id='n835' href='#n835'>835</a>
<a id='n836' href='#n836'>836</a>
<a id='n837' href='#n837'>837</a>
<a id='n838' href='#n838'>838</a>
<a id='n839' href='#n839'>839</a>
<a id='n840' href='#n840'>840</a>
<a id='n841' href='#n841'>841</a>
<a id='n842' href='#n842'>842</a>
<a id='n843' href='#n843'>843</a>
<a id='n844' href='#n844'>844</a>
<a id='n845' href='#n845'>845</a>
<a id='n846' href='#n846'>846</a>
<a id='n847' href='#n847'>847</a>
<a id='n848' href='#n848'>848</a>
<a id='n849' href='#n849'>849</a>
<a id='n850' href='#n850'>850</a>
<a id='n851' href='#n851'>851</a>
<a id='n852' href='#n852'>852</a>
<a id='n853' href='#n853'>853</a>
<a id='n854' href='#n854'>854</a>
<a id='n855' href='#n855'>855</a>
<a id='n856' href='#n856'>856</a>
<a id='n857' href='#n857'>857</a>
<a id='n858' href='#n858'>858</a>
<a id='n859' href='#n859'>859</a>
<a id='n860' href='#n860'>860</a>
<a id='n861' href='#n861'>861</a>
<a id='n862' href='#n862'>862</a>
<a id='n863' href='#n863'>863</a>
<a id='n864' href='#n864'>864</a>
<a id='n865' href='#n865'>865</a>
<a id='n866' href='#n866'>866</a>
<a id='n867' href='#n867'>867</a>
<a id='n868' href='#n868'>868</a>
<a id='n869' href='#n869'>869</a>
<a id='n870' href='#n870'>870</a>
<a id='n871' href='#n871'>871</a>
<a id='n872' href='#n872'>872</a>
<a id='n873' href='#n873'>873</a>
<a id='n874' href='#n874'>874</a>
<a id='n875' href='#n875'>875</a>
<a id='n876' href='#n876'>876</a>
<a id='n877' href='#n877'>877</a>
<a id='n878' href='#n878'>878</a>
<a id='n879' href='#n879'>879</a>
<a id='n880' href='#n880'>880</a>
<a id='n881' href='#n881'>881</a>
<a id='n882' href='#n882'>882</a>
<a id='n883' href='#n883'>883</a>
<a id='n884' href='#n884'>884</a>
<a id='n885' href='#n885'>885</a>
<a id='n886' href='#n886'>886</a>
<a id='n887' href='#n887'>887</a>
<a id='n888' href='#n888'>888</a>
<a id='n889' href='#n889'>889</a>
<a id='n890' href='#n890'>890</a>
<a id='n891' href='#n891'>891</a>
<a id='n892' href='#n892'>892</a>
<a id='n893' href='#n893'>893</a>
<a id='n894' href='#n894'>894</a>
<a id='n895' href='#n895'>895</a>
<a id='n896' href='#n896'>896</a>
<a id='n897' href='#n897'>897</a>
<a id='n898' href='#n898'>898</a>
<a id='n899' href='#n899'>899</a>
<a id='n900' href='#n900'>900</a>
<a id='n901' href='#n901'>901</a>
<a id='n902' href='#n902'>902</a>
<a id='n903' href='#n903'>903</a>
<a id='n904' href='#n904'>904</a>
<a id='n905' href='#n905'>905</a>
<a id='n906' href='#n906'>906</a>
<a id='n907' href='#n907'>907</a>
<a id='n908' href='#n908'>908</a>
<a id='n909' href='#n909'>909</a>
<a id='n910' href='#n910'>910</a>
<a id='n911' href='#n911'>911</a>
<a id='n912' href='#n912'>912</a>
<a id='n913' href='#n913'>913</a>
<a id='n914' href='#n914'>914</a>
<a id='n915' href='#n915'>915</a>
<a id='n916' href='#n916'>916</a>
<a id='n917' href='#n917'>917</a>
<a id='n918' href='#n918'>918</a>
<a id='n919' href='#n919'>919</a>
<a id='n920' href='#n920'>920</a>
<a id='n921' href='#n921'>921</a>
<a id='n922' href='#n922'>922</a>
<a id='n923' href='#n923'>923</a>
<a id='n924' href='#n924'>924</a>
<a id='n925' href='#n925'>925</a>
<a id='n926' href='#n926'>926</a>
<a id='n927' href='#n927'>927</a>
<a id='n928' href='#n928'>928</a>
<a id='n929' href='#n929'>929</a>
<a id='n930' href='#n930'>930</a>
<a id='n931' href='#n931'>931</a>
<a id='n932' href='#n932'>932</a>
<a id='n933' href='#n933'>933</a>
<a id='n934' href='#n934'>934</a>
<a id='n935' href='#n935'>935</a>
<a id='n936' href='#n936'>936</a>
<a id='n937' href='#n937'>937</a>
<a id='n938' href='#n938'>938</a>
<a id='n939' href='#n939'>939</a>
<a id='n940' href='#n940'>940</a>
<a id='n941' href='#n941'>941</a>
<a id='n942' href='#n942'>942</a>
<a id='n943' href='#n943'>943</a>
<a id='n944' href='#n944'>944</a>
<a id='n945' href='#n945'>945</a>
<a id='n946' href='#n946'>946</a>
<a id='n947' href='#n947'>947</a>
<a id='n948' href='#n948'>948</a>
<a id='n949' href='#n949'>949</a>
<a id='n950' href='#n950'>950</a>
<a id='n951' href='#n951'>951</a>
<a id='n952' href='#n952'>952</a>
<a id='n953' href='#n953'>953</a>
<a id='n954' href='#n954'>954</a>
<a id='n955' href='#n955'>955</a>
<a id='n956' href='#n956'>956</a>
<a id='n957' href='#n957'>957</a>
<a id='n958' href='#n958'>958</a>
<a id='n959' href='#n959'>959</a>
<a id='n960' href='#n960'>960</a>
<a id='n961' href='#n961'>961</a>
<a id='n962' href='#n962'>962</a>
<a id='n963' href='#n963'>963</a>
<a id='n964' href='#n964'>964</a>
<a id='n965' href='#n965'>965</a>
<a id='n966' href='#n966'>966</a>
<a id='n967' href='#n967'>967</a>
<a id='n968' href='#n968'>968</a>
<a id='n969' href='#n969'>969</a>
<a id='n970' href='#n970'>970</a>
<a id='n971' href='#n971'>971</a>
<a id='n972' href='#n972'>972</a>
<a id='n973' href='#n973'>973</a>
<a id='n974' href='#n974'>974</a>
<a id='n975' href='#n975'>975</a>
<a id='n976' href='#n976'>976</a>
<a id='n977' href='#n977'>977</a>
<a id='n978' href='#n978'>978</a>
<a id='n979' href='#n979'>979</a>
<a id='n980' href='#n980'>980</a>
<a id='n981' href='#n981'>981</a>
<a id='n982' href='#n982'>982</a>
<a id='n983' href='#n983'>983</a>
<a id='n984' href='#n984'>984</a>
<a id='n985' href='#n985'>985</a>
<a id='n986' href='#n986'>986</a>
<a id='n987' href='#n987'>987</a>
<a id='n988' href='#n988'>988</a>
<a id='n989' href='#n989'>989</a>
<a id='n990' href='#n990'>990</a>
<a id='n991' href='#n991'>991</a>
<a id='n992' href='#n992'>992</a>
<a id='n993' href='#n993'>993</a>
<a id='n994' href='#n994'>994</a>
<a id='n995' href='#n995'>995</a>
<a id='n996' href='#n996'>996</a>
<a id='n997' href='#n997'>997</a>
<a id='n998' href='#n998'>998</a>
<a id='n999' href='#n999'>999</a>
<a id='n1000' href='#n1000'>1000</a>
<a id='n1001' href='#n1001'>1001</a>
<a id='n1002' href='#n1002'>1002</a>
<a id='n1003' href='#n1003'>1003</a>
<a id='n1004' href='#n1004'>1004</a>
<a id='n1005' href='#n1005'>1005</a>
<a id='n1006' href='#n1006'>1006</a>
<a id='n1007' href='#n1007'>1007</a>
<a id='n1008' href='#n1008'>1008</a>
<a id='n1009' href='#n1009'>1009</a>
<a id='n1010' href='#n1010'>1010</a>
<a id='n1011' href='#n1011'>1011</a>
<a id='n1012' href='#n1012'>1012</a>
<a id='n1013' href='#n1013'>1013</a>
<a id='n1014' href='#n1014'>1014</a>
<a id='n1015' href='#n1015'>1015</a>
<a id='n1016' href='#n1016'>1016</a>
<a id='n1017' href='#n1017'>1017</a>
<a id='n1018' href='#n1018'>1018</a>
<a id='n1019' href='#n1019'>1019</a>
<a id='n1020' href='#n1020'>1020</a>
<a id='n1021' href='#n1021'>1021</a>
<a id='n1022' href='#n1022'>1022</a>
<a id='n1023' href='#n1023'>1023</a>
<a id='n1024' href='#n1024'>1024</a>
<a id='n1025' href='#n1025'>1025</a>
<a id='n1026' href='#n1026'>1026</a>
<a id='n1027' href='#n1027'>1027</a>
<a id='n1028' href='#n1028'>1028</a>
<a id='n1029' href='#n1029'>1029</a>
<a id='n1030' href='#n1030'>1030</a>
<a id='n1031' href='#n1031'>1031</a>
<a id='n1032' href='#n1032'>1032</a>
<a id='n1033' href='#n1033'>1033</a>
<a id='n1034' href='#n1034'>1034</a>
<a id='n1035' href='#n1035'>1035</a>
<a id='n1036' href='#n1036'>1036</a>
<a id='n1037' href='#n1037'>1037</a>
<a id='n1038' href='#n1038'>1038</a>
<a id='n1039' href='#n1039'>1039</a>
<a id='n1040' href='#n1040'>1040</a>
<a id='n1041' href='#n1041'>1041</a>
<a id='n1042' href='#n1042'>1042</a>
<a id='n1043' href='#n1043'>1043</a>
<a id='n1044' href='#n1044'>1044</a>
<a id='n1045' href='#n1045'>1045</a>
<a id='n1046' href='#n1046'>1046</a>
<a id='n1047' href='#n1047'>1047</a>
<a id='n1048' href='#n1048'>1048</a>
<a id='n1049' href='#n1049'>1049</a>
<a id='n1050' href='#n1050'>1050</a>
<a id='n1051' href='#n1051'>1051</a>
<a id='n1052' href='#n1052'>1052</a>
<a id='n1053' href='#n1053'>1053</a>
<a id='n1054' href='#n1054'>1054</a>
<a id='n1055' href='#n1055'>1055</a>
<a id='n1056' href='#n1056'>1056</a>
<a id='n1057' href='#n1057'>1057</a>
<a id='n1058' href='#n1058'>1058</a>
<a id='n1059' href='#n1059'>1059</a>
<a id='n1060' href='#n1060'>1060</a>
<a id='n1061' href='#n1061'>1061</a>
<a id='n1062' href='#n1062'>1062</a>
<a id='n1063' href='#n1063'>1063</a>
<a id='n1064' href='#n1064'>1064</a>
<a id='n1065' href='#n1065'>1065</a>
</pre></td>
<td class='lines'><pre><code><style>
@media only all and (prefers-color-scheme: dark) {
.highlight .hll { background-color: #49483e }
.highlight .c { color: #75715e } /* Comment */
.highlight .err { color: #960050; background-color: #1e0010 } /* Error */
.highlight .k { color: #66d9ef } /* Keyword */
.highlight .l { color: #ae81ff } /* Literal */
.highlight .n { color: #f8f8f2 } /* Name */
.highlight .o { color: #f92672 } /* Operator */
.highlight .p { color: #f8f8f2 } /* Punctuation */
.highlight .ch { color: #75715e } /* Comment.Hashbang */
.highlight .cm { color: #75715e } /* Comment.Multiline */
.highlight .cp { color: #75715e } /* Comment.Preproc */
.highlight .cpf { color: #75715e } /* Comment.PreprocFile */
.highlight .c1 { color: #75715e } /* Comment.Single */
.highlight .cs { color: #75715e } /* Comment.Special */
.highlight .gd { color: #f92672 } /* Generic.Deleted */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gi { color: #a6e22e } /* Generic.Inserted */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #75715e } /* Generic.Subheading */
.highlight .kc { color: #66d9ef } /* Keyword.Constant */
.highlight .kd { color: #66d9ef } /* Keyword.Declaration */
.highlight .kn { color: #f92672 } /* Keyword.Namespace */
.highlight .kp { color: #66d9ef } /* Keyword.Pseudo */
.highlight .kr { color: #66d9ef } /* Keyword.Reserved */
.highlight .kt { color: #66d9ef } /* Keyword.Type */
.highlight .ld { color: #e6db74 } /* Literal.Date */
.highlight .m { color: #ae81ff } /* Literal.Number */
.highlight .s { color: #e6db74 } /* Literal.String */
.highlight .na { color: #a6e22e } /* Name.Attribute */
.highlight .nb { color: #f8f8f2 } /* Name.Builtin */
.highlight .nc { color: #a6e22e } /* Name.Class */
.highlight .no { color: #66d9ef } /* Name.Constant */
.highlight .nd { color: #a6e22e } /* Name.Decorator */
.highlight .ni { color: #f8f8f2 } /* Name.Entity */
.highlight .ne { color: #a6e22e } /* Name.Exception */
.highlight .nf { color: #a6e22e } /* Name.Function */
.highlight .nl { color: #f8f8f2 } /* Name.Label */
.highlight .nn { color: #f8f8f2 } /* Name.Namespace */
.highlight .nx { color: #a6e22e } /* Name.Other */
.highlight .py { color: #f8f8f2 } /* Name.Property */
.highlight .nt { color: #f92672 } /* Name.Tag */
.highlight .nv { color: #f8f8f2 } /* Name.Variable */
.highlight .ow { color: #f92672 } /* Operator.Word */
.highlight .w { color: #f8f8f2 } /* Text.Whitespace */
.highlight .mb { color: #ae81ff } /* Literal.Number.Bin */
.highlight .mf { color: #ae81ff } /* Literal.Number.Float */
.highlight .mh { color: #ae81ff } /* Literal.Number.Hex */
.highlight .mi { color: #ae81ff } /* Literal.Number.Integer */
.highlight .mo { color: #ae81ff } /* Literal.Number.Oct */
.highlight .sa { color: #e6db74 } /* Literal.String.Affix */
.highlight .sb { color: #e6db74 } /* Literal.String.Backtick */
.highlight .sc { color: #e6db74 } /* Literal.String.Char */
.highlight .dl { color: #e6db74 } /* Literal.String.Delimiter */
.highlight .sd { color: #e6db74 } /* Literal.String.Doc */
.highlight .s2 { color: #e6db74 } /* Literal.String.Double */
.highlight .se { color: #ae81ff } /* Literal.String.Escape */
.highlight .sh { color: #e6db74 } /* Literal.String.Heredoc */
.highlight .si { color: #e6db74 } /* Literal.String.Interpol */
.highlight .sx { color: #e6db74 } /* Literal.String.Other */
.highlight .sr { color: #e6db74 } /* Literal.String.Regex */
.highlight .s1 { color: #e6db74 } /* Literal.String.Single */
.highlight .ss { color: #e6db74 } /* Literal.String.Symbol */
.highlight .bp { color: #f8f8f2 } /* Name.Builtin.Pseudo */
.highlight .fm { color: #a6e22e } /* Name.Function.Magic */
.highlight .vc { color: #f8f8f2 } /* Name.Variable.Class */
.highlight .vg { color: #f8f8f2 } /* Name.Variable.Global */
.highlight .vi { color: #f8f8f2 } /* Name.Variable.Instance */
.highlight .vm { color: #f8f8f2 } /* Name.Variable.Magic */
.highlight .il { color: #ae81ff } /* Literal.Number.Integer.Long */
}
@media (prefers-color-scheme: light) {
.highlight .hll { background-color: #ffffcc }
.highlight .c { color: #888888 } /* Comment */
.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
.highlight .k { color: #008800; font-weight: bold } /* Keyword */
.highlight .ch { color: #888888 } /* Comment.Hashbang */
.highlight .cm { color: #888888 } /* Comment.Multiline */
.highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */
.highlight .cpf { color: #888888 } /* Comment.PreprocFile */
.highlight .c1 { color: #888888 } /* Comment.Single */
.highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */
.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gr { color: #aa0000 } /* Generic.Error */
.highlight .gh { color: #333333 } /* Generic.Heading */
.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
.highlight .go { color: #888888 } /* Generic.Output */
.highlight .gp { color: #555555 } /* Generic.Prompt */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #666666 } /* Generic.Subheading */
.highlight .gt { color: #aa0000 } /* Generic.Traceback */
.highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */
.highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */
.highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */
.highlight .kp { color: #008800 } /* Keyword.Pseudo */
.highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */
.highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */
.highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */
.highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */
.highlight .na { color: #336699 } /* Name.Attribute */
.highlight .nb { color: #003388 } /* Name.Builtin */
.highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */
.highlight .no { color: #003366; font-weight: bold } /* Name.Constant */
.highlight .nd { color: #555555 } /* Name.Decorator */
.highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */
.highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */
.highlight .nl { color: #336699; font-style: italic } /* Name.Label */
.highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */
.highlight .py { color: #336699; font-weight: bold } /* Name.Property */
.highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */
.highlight .nv { color: #336699 } /* Name.Variable */
.highlight .ow { color: #008800 } /* Operator.Word */
.highlight .w { color: #bbbbbb } /* Text.Whitespace */
.highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */
.highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */
.highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */
.highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */
.highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */
.highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */
.highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */
.highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */
.highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */
.highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */
.highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */
.highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */
.highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */
.highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */
.highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */
.highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */
.highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */
.highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */
.highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */
.highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */
.highlight .vc { color: #336699 } /* Name.Variable.Class */
.highlight .vg { color: #dd7700 } /* Name.Variable.Global */
.highlight .vi { color: #3333bb } /* Name.Variable.Instance */
.highlight .vm { color: #336699 } /* Name.Variable.Magic */
.highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */
}
</style><div class="highlight"><pre><span></span><span class="c1"># Copyright (c) 2019 Cisco and/or its affiliates.</span>
<span class="c1"># Copyright (c) 2019 PANTHEON.tech and/or its affiliates.</span>
<span class="c1"># Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
<span class="c1"># you may not use this file except in compliance with the License.</span>
<span class="c1"># You may obtain a copy of the License at:</span>
<span class="c1">#</span>
<span class="c1">#     http://www.apache.org/licenses/LICENSE-2.0</span>
<span class="c1">#</span>
<span class="c1"># Unless required by applicable law or agreed to in writing, software</span>
<span class="c1"># distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
<span class="c1"># WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
<span class="c1"># See the License for the specific language governing permissions and</span>
<span class="c1"># limitations under the License.</span>

<span class="nb">set</span> -exuo pipefail

<span class="c1"># This library defines functions used by multiple entry scripts.</span>
<span class="c1"># Keep functions ordered alphabetically, please.</span>

<span class="c1"># TODO: Add a link to bash style guide.</span>
<span class="c1"># TODO: Consider putting every die into a {} block,</span>
<span class="c1">#   the code might become more readable (but longer).</span>


<span class="k">function</span> activate_docker_topology <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Create virtual vpp-device topology. Output of the function is topology</span>
    <span class="c1"># file describing created environment saved to a file.</span>
    <span class="c1">#</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - BASH_FUNCTION_DIR - Path to existing directory this file is located in.</span>
    <span class="c1"># - TOPOLOGIES - Available topologies.</span>
    <span class="c1"># - NODENESS - Node multiplicity of desired testbed.</span>
    <span class="c1"># - FLAVOR - Node flavor string, usually describing the processor.</span>
    <span class="c1"># - IMAGE_VER_FILE - Name of file that contains the image version.</span>
    <span class="c1"># - CSIT_DIR - Directory where ${IMAGE_VER_FILE} is located.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - WORKING_TOPOLOGY - Path to topology file.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nb">source</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">BASH_FUNCTION_DIR</span><span class="si">}</span><span class="s2">/device.sh&quot;</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Source failed!&quot;</span>
    <span class="o">}</span>

    <span class="nv">device_image</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>&lt; <span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span>/<span class="si">${</span><span class="nv">IMAGE_VER_FILE</span><span class="si">}</span><span class="k">)</span><span class="s2">&quot;</span>
    <span class="nv">case_text</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">NODENESS</span><span class="si">}</span><span class="s2">_</span><span class="si">${</span><span class="nv">FLAVOR</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">case_text</span><span class="si">}</span><span class="s2">&quot;</span> in
        <span class="s2">&quot;1n_skx&quot;</span> <span class="p">|</span> <span class="s2">&quot;1n_tx2&quot;</span><span class="o">)</span>
            <span class="c1"># We execute reservation over csit-shim-dcr (ssh) which runs sourced</span>
            <span class="c1"># script&#39;s functions. Env variables are read from ssh output</span>
            <span class="c1"># back to localhost for further processing.</span>
            <span class="nv">hostname</span><span class="o">=</span><span class="k">$(</span>grep search /etc/resolv.conf <span class="p">|</span> cut -d<span class="s1">&#39; &#39;</span> -f3<span class="k">)</span> <span class="o">||</span> die
            <span class="nv">ssh</span><span class="o">=</span><span class="s2">&quot;ssh root@</span><span class="si">${</span><span class="nv">hostname</span><span class="si">}</span><span class="s2"> -p 6022&quot;</span>
            <span class="nv">run</span><span class="o">=</span><span class="s2">&quot;activate_wrapper </span><span class="si">${</span><span class="nv">NODENESS</span><span class="si">}</span><span class="s2"> </span><span class="si">${</span><span class="nv">FLAVOR</span><span class="si">}</span><span class="s2"> </span><span class="si">${</span><span class="nv">device_image</span><span class="si">}</span><span class="s2">&quot;</span>
            <span class="c1"># The &quot;declare -f&quot; output is long and boring.</span>
            <span class="nb">set</span> +x
            <span class="c1"># backtics to avoid https://midnight-commander.org/ticket/2142</span>
            <span class="nv">env_vars</span><span class="o">=</span><span class="sb">`</span><span class="si">${</span><span class="nv">ssh</span><span class="si">}</span> <span class="s2">&quot;</span><span class="k">$(</span><span class="nb">declare</span> -f<span class="k">)</span><span class="s2">; </span><span class="si">${</span><span class="nv">run</span><span class="si">}</span><span class="s2">&quot;</span><span class="sb">`</span> <span class="o">||</span> <span class="o">{</span>
                die <span class="s2">&quot;Topology reservation via shim-dcr failed!&quot;</span>
            <span class="o">}</span>
            <span class="nb">set</span> -x
            <span class="nb">set</span> -a
            <span class="nb">source</span> &lt;<span class="o">(</span><span class="nb">echo</span> <span class="s2">&quot;</span><span class="nv">$env_vars</span><span class="s2">&quot;</span> <span class="p">|</span> grep -v /usr/bin/docker<span class="o">)</span> <span class="o">||</span> <span class="o">{</span>
                die <span class="s2">&quot;Source failed!&quot;</span>
            <span class="o">}</span>
            <span class="nb">set</span> +a
            <span class="p">;;</span>
        <span class="s2">&quot;1n_vbox&quot;</span><span class="o">)</span>
            <span class="c1"># We execute reservation on localhost. Sourced script automatially</span>
            <span class="c1"># sets environment variables for further processing.</span>
            activate_wrapper <span class="s2">&quot;</span><span class="si">${</span><span class="nv">NODENESS</span><span class="si">}</span><span class="s2">&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">FLAVOR</span><span class="si">}</span><span class="s2">&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">device_image</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die
            <span class="p">;;</span>
        *<span class="o">)</span>
            die <span class="s2">&quot;Unknown specification: </span><span class="si">${</span><span class="nv">case_text</span><span class="si">}</span><span class="s2">!&quot;</span>
    <span class="k">esac</span>

    <span class="nb">trap</span> <span class="s1">&#39;deactivate_docker_topology&#39;</span> EXIT <span class="o">||</span> <span class="o">{</span>
         die <span class="s2">&quot;Trap attempt failed, please cleanup manually. Aborting!&quot;</span>
    <span class="o">}</span>

    <span class="c1"># Replace all variables in template with those in environment.</span>
    <span class="nb">source</span> &lt;<span class="o">(</span><span class="nb">echo</span> <span class="s1">&#39;cat &lt;&lt;EOF &gt;topo.yml&#39;</span><span class="p">;</span> cat <span class="si">${</span><span class="nv">TOPOLOGIES</span><span class="p">[0]</span><span class="si">}</span><span class="p">;</span> <span class="nb">echo</span> EOF<span class="p">;</span><span class="o">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Topology file create failed!&quot;</span>
    <span class="o">}</span>

    <span class="nv">WORKING_TOPOLOGY</span><span class="o">=</span><span class="s2">&quot;/tmp/topology.yaml&quot;</span>
    mv topo.yml <span class="s2">&quot;</span><span class="si">${</span><span class="nv">WORKING_TOPOLOGY</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Topology move failed!&quot;</span>
    <span class="o">}</span>
    cat <span class="si">${</span><span class="nv">WORKING_TOPOLOGY</span><span class="si">}</span> <span class="p">|</span> grep -v password <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Topology read failed!&quot;</span>
    <span class="o">}</span>
<span class="o">}</span>


<span class="k">function</span> activate_virtualenv <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Update virtualenv pip package, delete and create virtualenv directory,</span>
    <span class="c1"># activate the virtualenv, install requirements, set PYTHONPATH.</span>

    <span class="c1"># Arguments:</span>
    <span class="c1"># - ${1} - Path to existing directory for creating virtualenv in.</span>
    <span class="c1">#          If missing or empty, ${CSIT_DIR} is used.</span>
    <span class="c1"># - ${2} - Path to requirements file, ${CSIT_DIR}/requirements.txt if empty.</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - CSIT_DIR - Path to existing root of local CSIT git repository.</span>
    <span class="c1"># Variables exported:</span>
    <span class="c1"># - PYTHONPATH - CSIT_DIR, as CSIT Python scripts usually need this.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nv">root_path</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">1</span><span class="p">-</span><span class="nv">$CSIT_DIR</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="nv">env_dir</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">root_path</span><span class="si">}</span><span class="s2">/env&quot;</span>
    <span class="nv">req_path</span><span class="o">=</span><span class="si">${</span><span class="nv">2</span><span class="p">-</span><span class="nv">$CSIT_DIR</span><span class="p">/requirements.txt</span><span class="si">}</span>
    rm -rf <span class="s2">&quot;</span><span class="si">${</span><span class="nv">env_dir</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Failed to clean previous virtualenv.&quot;</span>
    pip3 install --upgrade virtualenv <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Virtualenv package install failed.&quot;</span>
    <span class="o">}</span>
    virtualenv --python<span class="o">=</span><span class="k">$(</span>which python3<span class="k">)</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">env_dir</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Virtualenv creation for </span><span class="k">$(</span>which python3<span class="k">)</span><span class="s2"> failed.&quot;</span>
    <span class="o">}</span>
    <span class="nb">set</span> +u
    <span class="nb">source</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">env_dir</span><span class="si">}</span><span class="s2">/bin/activate&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Virtualenv activation failed.&quot;</span>
    <span class="nb">set</span> -u
    pip3 install --upgrade -r <span class="s2">&quot;</span><span class="si">${</span><span class="nv">req_path</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Requirements installation failed.&quot;</span>
    <span class="o">}</span>
    <span class="c1"># Most CSIT Python scripts assume PYTHONPATH is set and exported.</span>
    <span class="nb">export</span> <span class="nv">PYTHONPATH</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Export failed.&quot;</span>
<span class="o">}</span>


<span class="k">function</span> archive_tests <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Create .tar.xz of generated/tests for archiving.</span>
    <span class="c1"># To be run after generate_tests, kept separate to offer more flexibility.</span>

    <span class="c1"># Directory read:</span>
    <span class="c1"># - ${GENERATED_DIR}/tests - Tree of executed suites to archive.</span>
    <span class="c1"># File rewriten:</span>
    <span class="c1"># - ${ARCHIVE_DIR}/tests.tar.xz - Archive of generated tests.</span>

    <span class="nb">set</span> -exuo pipefail

    tar c <span class="s2">&quot;</span><span class="si">${</span><span class="nv">GENERATED_DIR</span><span class="si">}</span><span class="s2">/tests&quot;</span> <span class="p">|</span> xz -9e &gt; <span class="s2">&quot;</span><span class="si">${</span><span class="nv">ARCHIVE_DIR</span><span class="si">}</span><span class="s2">/tests.tar.xz&quot;</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Error creating archive of generated tests.&quot;</span>
    <span class="o">}</span>
<span class="o">}</span>


<span class="k">function</span> check_download_dir <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Fail if there are no files visible in ${DOWNLOAD_DIR}.</span>
    <span class="c1">#</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - DOWNLOAD_DIR - Path to directory pybot takes the build to test from.</span>
    <span class="c1"># Directories read:</span>
    <span class="c1"># - ${DOWNLOAD_DIR} - Has to be non-empty to proceed.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="k">if</span> <span class="o">[[</span> ! <span class="s2">&quot;</span><span class="k">$(</span>ls -A <span class="s2">&quot;</span><span class="si">${</span><span class="nv">DOWNLOAD_DIR</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span><span class="s2">&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        die <span class="s2">&quot;No artifacts downloaded!&quot;</span>
    <span class="k">fi</span>
<span class="o">}</span>


<span class="k">function</span> check_prerequisites <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Fail if prerequisites are not met.</span>
    <span class="c1">#</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - installed - Check if application is installed/present in system.</span>
    <span class="c1"># - die - Print to stderr and exit.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="k">if</span> ! installed sshpass<span class="p">;</span> <span class="k">then</span>
        die <span class="s2">&quot;Please install sshpass before continue!&quot;</span>
    <span class="k">fi</span>
<span class="o">}</span>


<span class="k">function</span> common_dirs <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Set global variables, create some directories (without touching content).</span>

    <span class="c1"># Variables set:</span>
    <span class="c1"># - BASH_FUNCTION_DIR - Path to existing directory this file is located in.</span>
    <span class="c1"># - CSIT_DIR - Path to existing root of local CSIT git repository.</span>
    <span class="c1"># - TOPOLOGIES_DIR - Path to existing directory with available tpologies.</span>
    <span class="c1"># - RESOURCES_DIR - Path to existing CSIT subdirectory &quot;resources&quot;.</span>
    <span class="c1"># - TOOLS_DIR - Path to existing resources subdirectory &quot;tools&quot;.</span>
    <span class="c1"># - PYTHON_SCRIPTS_DIR - Path to existing tools subdirectory &quot;scripts&quot;.</span>
    <span class="c1"># - ARCHIVE_DIR - Path to created CSIT subdirectory &quot;archive&quot;.</span>
    <span class="c1"># - DOWNLOAD_DIR - Path to created CSIT subdirectory &quot;download_dir&quot;.</span>
    <span class="c1"># - GENERATED_DIR - Path to created CSIT subdirectory &quot;generated&quot;.</span>
    <span class="c1"># Directories created if not present:</span>
    <span class="c1"># ARCHIVE_DIR, DOWNLOAD_DIR, GENERATED_DIR.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nv">this_file</span><span class="o">=</span><span class="k">$(</span>readlink -e <span class="s2">&quot;</span><span class="si">${</span><span class="nv">BASH_SOURCE</span><span class="p">[0]</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Some error during locating of this source file.&quot;</span>
    <span class="o">}</span>
    <span class="nv">BASH_FUNCTION_DIR</span><span class="o">=</span><span class="k">$(</span>dirname <span class="s2">&quot;</span><span class="si">${</span><span class="nv">this_file</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Some error during dirname call.&quot;</span>
    <span class="o">}</span>
    <span class="c1"># Current working directory could be in a different repo, e.g. VPP.</span>
    <span class="nb">pushd</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">BASH_FUNCTION_DIR</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Pushd failed&quot;</span>
    <span class="nv">relative_csit_dir</span><span class="o">=</span><span class="k">$(</span>git rev-parse --show-toplevel<span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Git rev-parse failed.&quot;</span>
    <span class="o">}</span>
    <span class="nv">CSIT_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -e <span class="s2">&quot;</span><span class="si">${</span><span class="nv">relative_csit_dir</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span> <span class="o">||</span> die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="nb">popd</span> <span class="o">||</span> die <span class="s2">&quot;Popd failed.&quot;</span>
    <span class="nv">TOPOLOGIES_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -e <span class="s2">&quot;</span><span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span><span class="s2">/topologies/available&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="o">}</span>
    <span class="nv">RESOURCES_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -e <span class="s2">&quot;</span><span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span><span class="s2">/resources&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="o">}</span>
    <span class="nv">TOOLS_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -e <span class="s2">&quot;</span><span class="si">${</span><span class="nv">RESOURCES_DIR</span><span class="si">}</span><span class="s2">/tools&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="o">}</span>
    <span class="nv">DOC_GEN_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -e <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOOLS_DIR</span><span class="si">}</span><span class="s2">/doc_gen&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="o">}</span>
    <span class="nv">PYTHON_SCRIPTS_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -e <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOOLS_DIR</span><span class="si">}</span><span class="s2">/scripts&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="o">}</span>

    <span class="nv">ARCHIVE_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -f <span class="s2">&quot;</span><span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span><span class="s2">/archive&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="o">}</span>
    mkdir -p <span class="s2">&quot;</span><span class="si">${</span><span class="nv">ARCHIVE_DIR</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Mkdir failed.&quot;</span>
    <span class="nv">DOWNLOAD_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -f <span class="s2">&quot;</span><span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span><span class="s2">/download_dir&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="o">}</span>
    mkdir -p <span class="s2">&quot;</span><span class="si">${</span><span class="nv">DOWNLOAD_DIR</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Mkdir failed.&quot;</span>
    <span class="nv">GENERATED_DIR</span><span class="o">=</span><span class="k">$(</span>readlink -f <span class="s2">&quot;</span><span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span><span class="s2">/generated&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Readlink failed.&quot;</span>
    <span class="o">}</span>
    mkdir -p <span class="s2">&quot;</span><span class="si">${</span><span class="nv">GENERATED_DIR</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Mkdir failed.&quot;</span>
<span class="o">}</span>


<span class="k">function</span> compose_pybot_arguments <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Variables read:</span>
    <span class="c1"># - WORKING_TOPOLOGY - Path to topology yaml file of the reserved testbed.</span>
    <span class="c1"># - DUT - CSIT test/ subdirectory, set while processing tags.</span>
    <span class="c1"># - TAGS - Array variable holding selected tag boolean expressions.</span>
    <span class="c1"># - TOPOLOGIES_TAGS - Tag boolean expression filtering tests for topology.</span>
    <span class="c1"># - TEST_CODE - The test selection string from environment or argument.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - PYBOT_ARGS - String holding part of all arguments for pybot.</span>
    <span class="c1"># - EXPANDED_TAGS - Array of strings pybot arguments compiled from tags.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="c1"># No explicit check needed with &quot;set -u&quot;.</span>
    <span class="nv">PYBOT_ARGS</span><span class="o">=(</span><span class="s2">&quot;--loglevel&quot;</span> <span class="s2">&quot;TRACE&quot;</span><span class="o">)</span>
    <span class="nv">PYBOT_ARGS</span><span class="o">+=(</span><span class="s2">&quot;--variable&quot;</span> <span class="s2">&quot;TOPOLOGY_PATH:</span><span class="si">${</span><span class="nv">WORKING_TOPOLOGY</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>

    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> in
        *<span class="s2">&quot;device&quot;</span>*<span class="o">)</span>
            <span class="nv">PYBOT_ARGS</span><span class="o">+=(</span><span class="s2">&quot;--suite&quot;</span> <span class="s2">&quot;tests.</span><span class="si">${</span><span class="nv">DUT</span><span class="si">}</span><span class="s2">.device&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;func&quot;</span>*<span class="o">)</span>
            <span class="nv">PYBOT_ARGS</span><span class="o">+=(</span><span class="s2">&quot;--suite&quot;</span> <span class="s2">&quot;tests.</span><span class="si">${</span><span class="nv">DUT</span><span class="si">}</span><span class="s2">.func&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;perf&quot;</span>*<span class="o">)</span>
            <span class="nv">PYBOT_ARGS</span><span class="o">+=(</span><span class="s2">&quot;--suite&quot;</span> <span class="s2">&quot;tests.</span><span class="si">${</span><span class="nv">DUT</span><span class="si">}</span><span class="s2">.perf&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="o">)</span>
            die <span class="s2">&quot;Unknown specification: </span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="k">esac</span>

    <span class="nv">EXPANDED_TAGS</span><span class="o">=()</span>
    <span class="k">for</span> tag in <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TAGS</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">;</span> <span class="k">do</span>
        <span class="k">if</span> <span class="o">[[</span> <span class="si">${</span><span class="nv">tag</span><span class="si">}</span> <span class="o">==</span> <span class="s2">&quot;!&quot;</span>* <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
            <span class="nv">EXPANDED_TAGS</span><span class="o">+=(</span><span class="s2">&quot;--exclude&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">tag</span><span class="p">#</span><span class="s2">$&quot;!&quot;</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>
        <span class="k">else</span>
            <span class="nv">EXPANDED_TAGS</span><span class="o">+=(</span><span class="s2">&quot;--include&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_TAGS</span><span class="si">}</span><span class="s2">AND</span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>
        <span class="k">fi</span>
    <span class="k">done</span>
<span class="o">}</span>


<span class="k">function</span> copy_archives <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Create additional archive if workspace variable is set.</span>
    <span class="c1"># This way if script is running in jenkins all will be</span>
    <span class="c1"># automatically archived to logs.fd.io.</span>
    <span class="c1">#</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - WORKSPACE - Jenkins workspace, copy only if the value is not empty.</span>
    <span class="c1">#   Can be unset, then it speeds up manual testing.</span>
    <span class="c1"># - ARCHIVE_DIR - Path to directory with content to be copied.</span>
    <span class="c1"># Directories updated:</span>
    <span class="c1"># - ${WORKSPACE}/archives/ - Created if does not exist.</span>
    <span class="c1">#   Content of ${ARCHIVE_DIR}/ is copied here.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="k">if</span> <span class="o">[[</span> -n <span class="s2">&quot;</span><span class="si">${</span><span class="nv">WORKSPACE</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        mkdir -p <span class="s2">&quot;</span><span class="si">${</span><span class="nv">WORKSPACE</span><span class="si">}</span><span class="s2">/archives/&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Archives dir create failed.&quot;</span>
        cp -rf <span class="s2">&quot;</span><span class="si">${</span><span class="nv">ARCHIVE_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/* <span class="s2">&quot;</span><span class="si">${</span><span class="nv">WORKSPACE</span><span class="si">}</span><span class="s2">/archives&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Copy failed.&quot;</span>
    <span class="k">fi</span>
<span class="o">}</span>


<span class="k">function</span> deactivate_docker_topology <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Deactivate virtual vpp-device topology by removing containers.</span>
    <span class="c1">#</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - NODENESS - Node multiplicity of desired testbed.</span>
    <span class="c1"># - FLAVOR - Node flavor string, usually describing the processor.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nv">case_text</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">NODENESS</span><span class="si">}</span><span class="s2">_</span><span class="si">${</span><span class="nv">FLAVOR</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">case_text</span><span class="si">}</span><span class="s2">&quot;</span> in
        <span class="s2">&quot;1n_skx&quot;</span> <span class="p">|</span> <span class="s2">&quot;1n_tx2&quot;</span><span class="o">)</span>
            <span class="nv">hostname</span><span class="o">=</span><span class="k">$(</span>grep search /etc/resolv.conf <span class="p">|</span> cut -d<span class="s1">&#39; &#39;</span> -f3<span class="k">)</span> <span class="o">||</span> die
            <span class="nv">ssh</span><span class="o">=</span><span class="s2">&quot;ssh root@</span><span class="si">${</span><span class="nv">hostname</span><span class="si">}</span><span class="s2"> -p 6022&quot;</span>
            <span class="nv">env_vars</span><span class="o">=</span><span class="k">$(</span>env <span class="p">|</span> grep CSIT_ <span class="p">|</span> tr <span class="s1">&#39;\n&#39;</span> <span class="s1">&#39; &#39;</span> <span class="k">)</span> <span class="o">||</span> die
            <span class="c1"># The &quot;declare -f&quot; output is long and boring.</span>
            <span class="nb">set</span> +x
            <span class="si">${</span><span class="nv">ssh</span><span class="si">}</span> <span class="s2">&quot;</span><span class="k">$(</span><span class="nb">declare</span> -f<span class="k">)</span><span class="s2">; deactivate_wrapper </span><span class="si">${</span><span class="nv">env_vars</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> <span class="o">{</span>
                die <span class="s2">&quot;Topology cleanup via shim-dcr failed!&quot;</span>
            <span class="o">}</span>
            <span class="nb">set</span> -x
            <span class="p">;;</span>
        <span class="s2">&quot;1n_vbox&quot;</span><span class="o">)</span>
            enter_mutex <span class="o">||</span> die
            clean_environment <span class="o">||</span> <span class="o">{</span>
                die <span class="s2">&quot;Topology cleanup locally failed!&quot;</span>
            <span class="o">}</span>
            exit_mutex <span class="o">||</span> die
            <span class="p">;;</span>
        *<span class="o">)</span>
            die <span class="s2">&quot;Unknown specification: </span><span class="si">${</span><span class="nv">case_text</span><span class="si">}</span><span class="s2">!&quot;</span>
    <span class="k">esac</span>
<span class="o">}</span>


<span class="k">function</span> die <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Print the message to standard error end exit with error code specified</span>
    <span class="c1"># by the second argument.</span>
    <span class="c1">#</span>
    <span class="c1"># Hardcoded values:</span>
    <span class="c1"># - The default error message.</span>
    <span class="c1"># Arguments:</span>
    <span class="c1"># - ${1} - The whole error message, be sure to quote. Optional</span>
    <span class="c1"># - ${2} - the code to exit with, default: 1.</span>

    <span class="nb">set</span> -x
    <span class="nb">set</span> +eu
    warn <span class="s2">&quot;</span><span class="si">${</span><span class="nv">1</span><span class="k">:-</span><span class="nv">Unspecified</span><span class="p"> run-time error occurred!</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="nb">exit</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">2</span><span class="k">:-</span><span class="nv">1</span><span class="si">}</span><span class="s2">&quot;</span>
<span class="o">}</span>


<span class="k">function</span> die_on_pybot_error <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Source this fragment if you want to abort on any failed test case.</span>
    <span class="c1">#</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - PYBOT_EXIT_STATUS - Set by a pybot running fragment.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">PYBOT_EXIT_STATUS</span><span class="si">}</span><span class="s2">&quot;</span> !<span class="o">=</span> <span class="s2">&quot;0&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        die <span class="s2">&quot;Test failures are present!&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">PYBOT_EXIT_STATUS</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="k">fi</span>
<span class="o">}</span>


<span class="k">function</span> generate_tests <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Populate ${GENERATED_DIR}/tests based on ${CSIT_DIR}/tests/.</span>
    <span class="c1"># Any previously existing content of ${GENERATED_DIR}/tests is wiped before.</span>
    <span class="c1"># The generation is done by executing any *.py executable</span>
    <span class="c1"># within any subdirectory after copying.</span>

    <span class="c1"># This is a separate function, because this code is called</span>
    <span class="c1"># both by autogen checker and entries calling run_pybot.</span>

    <span class="c1"># Directories read:</span>
    <span class="c1"># - ${CSIT_DIR}/tests - Used as templates for the generated tests.</span>
    <span class="c1"># Directories replaced:</span>
    <span class="c1"># - ${GENERATED_DIR}/tests - Overwritten by the generated tests.</span>

    <span class="nb">set</span> -exuo pipefail

    rm -rf <span class="s2">&quot;</span><span class="si">${</span><span class="nv">GENERATED_DIR</span><span class="si">}</span><span class="s2">/tests&quot;</span> <span class="o">||</span> die
    cp -r <span class="s2">&quot;</span><span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span><span class="s2">/tests&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">GENERATED_DIR</span><span class="si">}</span><span class="s2">/tests&quot;</span> <span class="o">||</span> die
    <span class="nv">cmd_line</span><span class="o">=(</span><span class="s2">&quot;find&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">GENERATED_DIR</span><span class="si">}</span><span class="s2">/tests&quot;</span> <span class="s2">&quot;-type&quot;</span> <span class="s2">&quot;f&quot;</span><span class="o">)</span>
    <span class="nv">cmd_line</span><span class="o">+=(</span><span class="s2">&quot;-executable&quot;</span> <span class="s2">&quot;-name&quot;</span> <span class="s2">&quot;*.py&quot;</span><span class="o">)</span>
    <span class="nv">file_list</span><span class="o">=</span><span class="k">$(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">cmd_line</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span> <span class="o">||</span> die

    <span class="k">for</span> gen in <span class="si">${</span><span class="nv">file_list</span><span class="si">}</span><span class="p">;</span> <span class="k">do</span>
        <span class="nv">directory</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>dirname <span class="s2">&quot;</span><span class="si">${</span><span class="nv">gen</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span><span class="s2">&quot;</span> <span class="o">||</span> die
        <span class="nv">filename</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>basename <span class="s2">&quot;</span><span class="si">${</span><span class="nv">gen</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span><span class="s2">&quot;</span> <span class="o">||</span> die
        <span class="nb">pushd</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">directory</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die
        ./<span class="s2">&quot;</span><span class="si">${</span><span class="nv">filename</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die
        <span class="nb">popd</span> <span class="o">||</span> die
    <span class="k">done</span>
<span class="o">}</span>


<span class="k">function</span> get_test_code <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Arguments:</span>
    <span class="c1"># - ${1} - Optional, argument of entry script (or empty as unset).</span>
    <span class="c1">#   Test code value to override job name from environment.</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - JOB_NAME - String affecting test selection, default if not argument.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - TEST_CODE - The test selection string from environment or argument.</span>
    <span class="c1"># - NODENESS - Node multiplicity of desired testbed.</span>
    <span class="c1"># - FLAVOR - Node flavor string, usually describing the processor.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nv">TEST_CODE</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">1</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Reading optional argument failed, somehow.&quot;</span>
    <span class="k">if</span> <span class="o">[[</span> -z <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        <span class="nv">TEST_CODE</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">JOB_NAME</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Reading job name failed, somehow.&quot;</span>
    <span class="k">fi</span>

    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> in
        *<span class="s2">&quot;1n-vbox&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;1n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;vbox&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;1n-skx&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;1n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;skx&quot;</span>
            <span class="p">;;</span>
       *<span class="s2">&quot;1n-tx2&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;1n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;tx2&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;2n-skx&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;2n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;skx&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-skx&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;3n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;skx&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;2n-clx&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;2n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;clx&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;2n-dnv&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;2n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;dnv&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-dnv&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;3n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;dnv&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-tsh&quot;</span>*<span class="o">)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;3n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;tsh&quot;</span>
            <span class="p">;;</span>
        *<span class="o">)</span>
            <span class="c1"># Fallback to 3-node Haswell by default (backward compatibility)</span>
            <span class="nv">NODENESS</span><span class="o">=</span><span class="s2">&quot;3n&quot;</span>
            <span class="nv">FLAVOR</span><span class="o">=</span><span class="s2">&quot;hsw&quot;</span>
            <span class="p">;;</span>
    <span class="k">esac</span>
<span class="o">}</span>


<span class="k">function</span> get_test_tag_string <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Variables read:</span>
    <span class="c1"># - GERRIT_EVENT_TYPE - Event type set by gerrit, can be unset.</span>
    <span class="c1"># - GERRIT_EVENT_COMMENT_TEXT - Comment text, read for &quot;comment-added&quot; type.</span>
    <span class="c1"># - TEST_CODE - The test selection string from environment or argument.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - TEST_TAG_STRING - The string following trigger word in gerrit comment.</span>
    <span class="c1">#   May be empty, or even not set on event types not adding comment.</span>

    <span class="c1"># TODO: ci-management scripts no longer need to perform this.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">GERRIT_EVENT_TYPE</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> <span class="s2">&quot;comment-added&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> in
            *<span class="s2">&quot;device&quot;</span>*<span class="o">)</span>
                <span class="nv">trigger</span><span class="o">=</span><span class="s2">&quot;devicetest&quot;</span>
                <span class="p">;;</span>
            *<span class="s2">&quot;perf&quot;</span>*<span class="o">)</span>
                <span class="nv">trigger</span><span class="o">=</span><span class="s2">&quot;perftest&quot;</span>
                <span class="p">;;</span>
            *<span class="o">)</span>
                die <span class="s2">&quot;Unknown specification: </span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span>
        <span class="k">esac</span>
        <span class="c1"># Ignore lines not containing the trigger word.</span>
        <span class="nv">comment</span><span class="o">=</span><span class="k">$(</span>fgrep <span class="s2">&quot;</span><span class="si">${</span><span class="nv">trigger</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">&lt;&lt;&lt;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">GERRIT_EVENT_COMMENT_TEXT</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="nb">true</span>
        <span class="c1"># The vpp-csit triggers trail stuff we are not interested in.</span>
        <span class="c1"># Removing them and trigger word: https://unix.stackexchange.com/a/13472</span>
        <span class="c1"># (except relying on \s whitespace, \S non-whitespace and . both).</span>
        <span class="c1"># The last string is concatenated, only the middle part is expanded.</span>
        <span class="nv">cmd</span><span class="o">=(</span><span class="s2">&quot;grep&quot;</span> <span class="s2">&quot;-oP&quot;</span> <span class="s1">&#39;\S*&#39;</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">trigger</span><span class="si">}</span><span class="s2">&quot;</span><span class="s1">&#39;\S*\s\K.+$&#39;</span><span class="o">)</span> <span class="o">||</span> die <span class="s2">&quot;Unset trigger?&quot;</span>
        <span class="c1"># On parsing error, TEST_TAG_STRING probably stays empty.</span>
        <span class="nv">TEST_TAG_STRING</span><span class="o">=</span><span class="k">$(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">cmd</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">&lt;&lt;&lt;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">comment</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span> <span class="o">||</span> <span class="nb">true</span>
    <span class="k">fi</span>
<span class="o">}</span>


<span class="k">function</span> installed <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Check if the given utility is installed. Fail if not installed.</span>
    <span class="c1">#</span>
    <span class="c1"># Duplicate of common.sh function, as this file is also used standalone.</span>
    <span class="c1">#</span>
    <span class="c1"># Arguments:</span>
    <span class="c1"># - ${1} - Utility to check.</span>
    <span class="c1"># Returns:</span>
    <span class="c1"># - 0 - If command is installed.</span>
    <span class="c1"># - 1 - If command is not installed.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nb">command</span> -v <span class="s2">&quot;</span><span class="si">${</span><span class="nv">1</span><span class="si">}</span><span class="s2">&quot;</span>
<span class="o">}</span>


<span class="k">function</span> reserve_and_cleanup_testbed <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Reserve physical testbed, perform cleanup, register trap to unreserve.</span>
    <span class="c1"># When cleanup fails, remove from topologies and keep retrying</span>
    <span class="c1"># until all topologies are removed.</span>
    <span class="c1">#</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - TOPOLOGIES - Array of paths to topology yaml to attempt reservation on.</span>
    <span class="c1"># - PYTHON_SCRIPTS_DIR - Path to directory holding the reservation script.</span>
    <span class="c1"># - BUILD_TAG - Any string suitable as filename, identifying</span>
    <span class="c1">#   test run executing this function. May be unset.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - TOPOLOGIES - Array of paths to topologies, with failed cleanups removed.</span>
    <span class="c1"># - WORKING_TOPOLOGY - Path to topology yaml file of the reserved testbed.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>
    <span class="c1"># - ansible_hosts - Perform an action using ansible, see ansible.sh</span>
    <span class="c1"># Traps registered:</span>
    <span class="c1"># - EXIT - Calls cancel_all for ${WORKING_TOPOLOGY}.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="k">while</span> true<span class="p">;</span> <span class="k">do</span>
        <span class="k">for</span> topo in <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">;</span> <span class="k">do</span>
            <span class="nb">set</span> +e
            <span class="nv">scrpt</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">PYTHON_SCRIPTS_DIR</span><span class="si">}</span><span class="s2">/topo_reservation.py&quot;</span>
            <span class="nv">opts</span><span class="o">=(</span><span class="s2">&quot;-t&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">topo</span><span class="si">}</span><span class="s2">&quot;</span> <span class="s2">&quot;-r&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">BUILD_TAG</span><span class="k">:-</span><span class="nv">Unknown</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>
            python3 <span class="s2">&quot;</span><span class="si">${</span><span class="nv">scrpt</span><span class="si">}</span><span class="s2">&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">opts</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span>
            <span class="nv">result</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$?</span><span class="s2">&quot;</span>
            <span class="nb">set</span> -e
            <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">result</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> <span class="s2">&quot;0&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
                <span class="c1"># Trap unreservation before cleanup check,</span>
                <span class="c1"># so multiple jobs showing failed cleanup improve chances</span>
                <span class="c1"># of humans to notice and fix.</span>
                <span class="nv">WORKING_TOPOLOGY</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">topo</span><span class="si">}</span><span class="s2">&quot;</span>
                <span class="nb">echo</span> <span class="s2">&quot;Reserved: </span><span class="si">${</span><span class="nv">WORKING_TOPOLOGY</span><span class="si">}</span><span class="s2">&quot;</span>
                <span class="nb">trap</span> <span class="s2">&quot;untrap_and_unreserve_testbed&quot;</span> EXIT <span class="o">||</span> <span class="o">{</span>
                    <span class="nv">message</span><span class="o">=</span><span class="s2">&quot;TRAP ATTEMPT AND UNRESERVE FAILED, FIX MANUALLY.&quot;</span>
                    untrap_and_unreserve_testbed <span class="s2">&quot;</span><span class="si">${</span><span class="nv">message</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> <span class="o">{</span>
                        die <span class="s2">&quot;Teardown should have died, not failed.&quot;</span>
                    <span class="o">}</span>
                    die <span class="s2">&quot;Trap attempt failed, unreserve succeeded. Aborting.&quot;</span>
                <span class="o">}</span>
                <span class="c1"># Cleanup check.</span>
                <span class="nb">set</span> +e
                ansible_hosts <span class="s2">&quot;cleanup&quot;</span>
                <span class="nv">result</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$?</span><span class="s2">&quot;</span>
                <span class="nb">set</span> -e
                <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">result</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> <span class="s2">&quot;0&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
                    <span class="nb">break</span>
                <span class="k">fi</span>
                warn <span class="s2">&quot;Testbed cleanup failed: </span><span class="si">${</span><span class="nv">topo</span><span class="si">}</span><span class="s2">&quot;</span>
                untrap_and_unreserve_testbed <span class="s2">&quot;Fail of unreserve after cleanup.&quot;</span>
            <span class="k">fi</span>
            <span class="c1"># Else testbed is accessible but currently reserved, moving on.</span>
        <span class="k">done</span>

        <span class="k">if</span> <span class="o">[[</span> -n <span class="s2">&quot;</span><span class="si">${</span><span class="nv">WORKING_TOPOLOGY</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
            <span class="c1"># Exit the infinite while loop if we made a reservation.</span>
            warn <span class="s2">&quot;Reservation and cleanup successful.&quot;</span>
            <span class="nb">break</span>
        <span class="k">fi</span>

        <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${#</span><span class="nv">TOPOLOGIES</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> <span class="s2">&quot;0&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
            die <span class="s2">&quot;Run out of operational testbeds!&quot;</span>
        <span class="k">fi</span>

        <span class="c1"># Wait ~3minutes before next try.</span>
        <span class="nv">sleep_time</span><span class="o">=</span><span class="s2">&quot;</span>$<span class="s2">[ ( </span><span class="si">${</span><span class="nv">RANDOM</span><span class="si">}</span><span class="s2"> % 20 ) + 180 ]s&quot;</span> <span class="o">||</span> <span class="o">{</span>
            die <span class="s2">&quot;Sleep time calculation failed.&quot;</span>
        <span class="o">}</span>
        <span class="nb">echo</span> <span class="s2">&quot;Sleeping </span><span class="si">${</span><span class="nv">sleep_time</span><span class="si">}</span><span class="s2">&quot;</span>
        sleep <span class="s2">&quot;</span><span class="si">${</span><span class="nv">sleep_time</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Sleep failed.&quot;</span>
    <span class="k">done</span>
<span class="o">}</span>


<span class="k">function</span> run_pybot <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Run pybot with options based on input variables. Create output_info.xml</span>
    <span class="c1">#</span>
    <span class="c1"># Variables read:</span>
    <span class="c1"># - CSIT_DIR - Path to existing root of local CSIT git repository.</span>
    <span class="c1"># - ARCHIVE_DIR - Path to store robot result files in.</span>
    <span class="c1"># - PYBOT_ARGS, EXPANDED_TAGS - See compose_pybot_arguments.sh</span>
    <span class="c1"># - GENERATED_DIR - Tests are assumed to be generated under there.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - PYBOT_EXIT_STATUS - Exit status of most recent pybot invocation.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nv">all_options</span><span class="o">=(</span><span class="s2">&quot;--outputdir&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">ARCHIVE_DIR</span><span class="si">}</span><span class="s2">&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">PYBOT_ARGS</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>
    <span class="nv">all_options</span><span class="o">+=(</span><span class="s2">&quot;--noncritical&quot;</span> <span class="s2">&quot;EXPECTED_FAILING&quot;</span><span class="o">)</span>
    <span class="nv">all_options</span><span class="o">+=(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">EXPANDED_TAGS</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>

    <span class="nb">pushd</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">CSIT_DIR</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> die <span class="s2">&quot;Change directory operation failed.&quot;</span>
    <span class="nb">set</span> +e
    robot <span class="s2">&quot;</span><span class="si">${</span><span class="nv">all_options</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">GENERATED_DIR</span><span class="si">}</span><span class="s2">/tests/&quot;</span>
    <span class="nv">PYBOT_EXIT_STATUS</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$?</span><span class="s2">&quot;</span>
    <span class="nb">set</span> -e

    <span class="c1"># Generate INFO level output_info.xml for post-processing.</span>
    <span class="nv">all_options</span><span class="o">=(</span><span class="s2">&quot;--loglevel&quot;</span> <span class="s2">&quot;INFO&quot;</span><span class="o">)</span>
    <span class="nv">all_options</span><span class="o">+=(</span><span class="s2">&quot;--log&quot;</span> <span class="s2">&quot;none&quot;</span><span class="o">)</span>
    <span class="nv">all_options</span><span class="o">+=(</span><span class="s2">&quot;--report&quot;</span> <span class="s2">&quot;none&quot;</span><span class="o">)</span>
    <span class="nv">all_options</span><span class="o">+=(</span><span class="s2">&quot;--output&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">ARCHIVE_DIR</span><span class="si">}</span><span class="s2">/output_info.xml&quot;</span><span class="o">)</span>
    <span class="nv">all_options</span><span class="o">+=(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">ARCHIVE_DIR</span><span class="si">}</span><span class="s2">/output.xml&quot;</span><span class="o">)</span>
    rebot <span class="s2">&quot;</span><span class="si">${</span><span class="nv">all_options</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> <span class="nb">true</span>
    <span class="nb">popd</span> <span class="o">||</span> die <span class="s2">&quot;Change directory operation failed.&quot;</span>
<span class="o">}</span>


<span class="k">function</span> select_arch_os <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Set variables affected by local CPU architecture and operating system.</span>
    <span class="c1">#</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - VPP_VER_FILE - Name of file in CSIT dir containing vpp stable version.</span>
    <span class="c1"># - IMAGE_VER_FILE - Name of file in CSIT dir containing the image name.</span>
    <span class="c1"># - PKG_SUFFIX - Suffix of OS package file name, &quot;rpm&quot; or &quot;deb.&quot;</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nv">os_id</span><span class="o">=</span><span class="k">$(</span>grep <span class="s1">&#39;^ID=&#39;</span> /etc/os-release <span class="p">|</span> cut -f2- -d<span class="o">=</span> <span class="p">|</span> sed -e <span class="s1">&#39;s/\&quot;//g&#39;</span><span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Get OS release failed.&quot;</span>
    <span class="o">}</span>

    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">os_id</span><span class="si">}</span><span class="s2">&quot;</span> in
        <span class="s2">&quot;ubuntu&quot;</span>*<span class="o">)</span>
            <span class="nv">IMAGE_VER_FILE</span><span class="o">=</span><span class="s2">&quot;VPP_DEVICE_IMAGE_UBUNTU&quot;</span>
            <span class="nv">VPP_VER_FILE</span><span class="o">=</span><span class="s2">&quot;VPP_STABLE_VER_UBUNTU_BIONIC&quot;</span>
            <span class="nv">PKG_SUFFIX</span><span class="o">=</span><span class="s2">&quot;deb&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;centos&quot;</span>*<span class="o">)</span>
            <span class="nv">IMAGE_VER_FILE</span><span class="o">=</span><span class="s2">&quot;VPP_DEVICE_IMAGE_CENTOS&quot;</span>
            <span class="nv">VPP_VER_FILE</span><span class="o">=</span><span class="s2">&quot;VPP_STABLE_VER_CENTOS&quot;</span>
            <span class="nv">PKG_SUFFIX</span><span class="o">=</span><span class="s2">&quot;rpm&quot;</span>
            <span class="p">;;</span>
        *<span class="o">)</span>
            die <span class="s2">&quot;Unable to identify distro or os from </span><span class="si">${</span><span class="nv">os_id</span><span class="si">}</span><span class="s2">&quot;</span>
            <span class="p">;;</span>
    <span class="k">esac</span>

    <span class="nv">arch</span><span class="o">=</span><span class="k">$(</span>uname -m<span class="k">)</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Get CPU architecture failed.&quot;</span>
    <span class="o">}</span>

    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">arch</span><span class="si">}</span><span class="s2">&quot;</span> in
        <span class="s2">&quot;aarch64&quot;</span><span class="o">)</span>
            <span class="nv">IMAGE_VER_FILE</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">IMAGE_VER_FILE</span><span class="si">}</span><span class="s2">_ARM&quot;</span>
            <span class="p">;;</span>
        *<span class="o">)</span>
            <span class="p">;;</span>
    <span class="k">esac</span>
<span class="o">}</span>


<span class="k">function</span> select_tags <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Variables read:</span>
    <span class="c1"># - WORKING_TOPOLOGY - Path to topology yaml file of the reserved testbed.</span>
    <span class="c1"># - TEST_CODE - String affecting test selection, usually jenkins job name.</span>
    <span class="c1"># - TEST_TAG_STRING - String selecting tags, from gerrit comment.</span>
    <span class="c1">#   Can be unset.</span>
    <span class="c1"># - TOPOLOGIES_DIR - Path to existing directory with available tpologies.</span>
    <span class="c1"># - BASH_FUNCTION_DIR - Directory with input files to process.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - TAGS - Array of processed tag boolean expressions.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="c1"># NIC SELECTION</span>
    <span class="nv">start_pattern</span><span class="o">=</span><span class="s1">&#39;^  TG:&#39;</span>
    <span class="nv">end_pattern</span><span class="o">=</span><span class="s1">&#39;^ \? \?[A-Za-z0-9]\+:&#39;</span>
    <span class="c1"># Remove the TG section from topology file</span>
    <span class="nv">sed_command</span><span class="o">=</span><span class="s2">&quot;/</span><span class="si">${</span><span class="nv">start_pattern</span><span class="si">}</span><span class="s2">/,/</span><span class="si">${</span><span class="nv">end_pattern</span><span class="si">}</span><span class="s2">/d&quot;</span>
    <span class="c1"># All topologies DUT NICs</span>
    <span class="nv">available</span><span class="o">=</span><span class="k">$(</span>sed <span class="s2">&quot;</span><span class="si">${</span><span class="nv">sed_command</span><span class="si">}</span><span class="s2">&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/* <span class="se">\</span>
                <span class="p">|</span> grep -hoP <span class="s2">&quot;model: \K.*&quot;</span> <span class="p">|</span> sort -u<span class="k">)</span>
    <span class="c1"># Selected topology DUT NICs</span>
    <span class="nv">reserved</span><span class="o">=</span><span class="k">$(</span>sed <span class="s2">&quot;</span><span class="si">${</span><span class="nv">sed_command</span><span class="si">}</span><span class="s2">&quot;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">WORKING_TOPOLOGY</span><span class="si">}</span><span class="s2">&quot;</span> <span class="se">\</span>
               <span class="p">|</span> grep -hoP <span class="s2">&quot;model: \K.*&quot;</span> <span class="p">|</span> sort -u<span class="k">)</span>
    <span class="c1"># All topologies DUT NICs - Selected topology DUT NICs</span>
    <span class="nv">exclude_nics</span><span class="o">=(</span><span class="k">$(</span>comm -13 &lt;<span class="o">(</span><span class="nb">echo</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">reserved</span><span class="si">}</span><span class="s2">&quot;</span><span class="k">)</span> &lt;<span class="o">(</span><span class="nb">echo</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">available</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)))</span> <span class="o">||</span> <span class="o">{</span>
        die <span class="s2">&quot;Computation of excluded NICs failed.&quot;</span>
    <span class="o">}</span>

    <span class="c1"># Select default NIC tag.</span>
    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> in
        *<span class="s2">&quot;3n-dnv&quot;</span>* <span class="p">|</span> *<span class="s2">&quot;2n-dnv&quot;</span>*<span class="o">)</span>
            <span class="nv">default_nic</span><span class="o">=</span><span class="s2">&quot;nic_intel-x553&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-tsh&quot;</span>*<span class="o">)</span>
            <span class="nv">default_nic</span><span class="o">=</span><span class="s2">&quot;nic_intel-x520-da2&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-skx&quot;</span>* <span class="p">|</span> *<span class="s2">&quot;2n-skx&quot;</span>* <span class="p">|</span> *<span class="s2">&quot;2n-clx&quot;</span>*<span class="o">)</span>
            <span class="nv">default_nic</span><span class="o">=</span><span class="s2">&quot;nic_intel-xxv710&quot;</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-hsw&quot;</span>* <span class="p">|</span> *<span class="s2">&quot;mrr-daily-master&quot;</span><span class="o">)</span>
            <span class="nv">default_nic</span><span class="o">=</span><span class="s2">&quot;nic_intel-xl710&quot;</span>
            <span class="p">;;</span>
        *<span class="o">)</span>
            <span class="nv">default_nic</span><span class="o">=</span><span class="s2">&quot;nic_intel-x710&quot;</span>
            <span class="p">;;</span>
    <span class="k">esac</span>

    <span class="nv">sed_nic_sub_cmd</span><span class="o">=</span><span class="s2">&quot;sed s/\${default_nic}/</span><span class="si">${</span><span class="nv">default_nic</span><span class="si">}</span><span class="s2">/&quot;</span>
    <span class="nv">sed_nics_sub_cmd</span><span class="o">=</span><span class="s2">&quot;sed -e s/ANDxxv710/ANDnic_intel-xxv710/&quot;</span>
    <span class="nv">sed_nics_sub_cmd</span><span class="o">+=</span><span class="s2">&quot; | sed -e s/ANDx710/ANDnic_intel-x710/&quot;</span>
    <span class="nv">sed_nics_sub_cmd</span><span class="o">+=</span><span class="s2">&quot; | sed -e s/ANDxl710/ANDnic_intel-xl710/&quot;</span>
    <span class="nv">sed_nics_sub_cmd</span><span class="o">+=</span><span class="s2">&quot; | sed -e s/ANDx520-da2/ANDnic_intel-x520-da2/&quot;</span>
    <span class="nv">sed_nics_sub_cmd</span><span class="o">+=</span><span class="s2">&quot; | sed -e s/ANDx553/ANDnic_intel-x553/&quot;</span>
    <span class="nv">sed_nics_sub_cmd</span><span class="o">+=</span><span class="s2">&quot; | sed -e s/ANDcx556a/ANDnic_mellanox-cx556a/&quot;</span>
    <span class="nv">sed_nics_sub_cmd</span><span class="o">+=</span><span class="s2">&quot; | sed -e s/ANDvic1227/ANDnic_cisco-vic-1227/&quot;</span>
    <span class="nv">sed_nics_sub_cmd</span><span class="o">+=</span><span class="s2">&quot; | sed -e s/ANDvic1385/ANDnic_cisco-vic-1385/&quot;</span>
    <span class="c1"># Tag file directory shorthand.</span>
    <span class="nv">tfd</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">BASH_FUNCTION_DIR</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> in
        <span class="c1"># Select specific performance tests based on jenkins job type variable.</span>
        *<span class="s2">&quot;ndrpdr-weekly&quot;</span>* <span class="o">)</span>
            readarray -t test_tag_array &lt; <span class="s2">&quot;</span><span class="si">${</span><span class="nv">tfd</span><span class="si">}</span><span class="s2">/mlr-weekly.txt&quot;</span> <span class="o">||</span> die
            <span class="p">;;</span>
        *<span class="s2">&quot;mrr-daily&quot;</span>* <span class="o">)</span>
            readarray -t test_tag_array <span class="o">&lt;&lt;&lt;</span> <span class="k">$(</span>sed <span class="s1">&#39;s/ //g&#39;</span> <span class="se">\</span>
                <span class="si">${</span><span class="nv">tfd</span><span class="si">}</span>/mrr-daily-<span class="si">${</span><span class="nv">NODENESS</span><span class="si">}</span>-<span class="si">${</span><span class="nv">FLAVOR</span><span class="si">}</span>.txt <span class="p">|</span>
                <span class="nb">eval</span> <span class="si">${</span><span class="nv">sed_nics_sub_cmd</span><span class="si">}</span><span class="k">)</span> <span class="o">||</span> die
            <span class="p">;;</span>
        *<span class="s2">&quot;mrr-weekly&quot;</span>* <span class="o">)</span>
            readarray -t test_tag_array <span class="o">&lt;&lt;&lt;</span> <span class="k">$(</span><span class="si">${</span><span class="nv">sed_nic_sub_cmd</span><span class="si">}</span> <span class="se">\</span>
                <span class="si">${</span><span class="nv">tfd</span><span class="si">}</span>/mrr-weekly.txt<span class="k">)</span> <span class="o">||</span> die
            <span class="p">;;</span>
        * <span class="o">)</span>
            <span class="k">if</span> <span class="o">[[</span> -z <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_TAG_STRING</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
                <span class="c1"># If nothing is specified, we will run pre-selected tests by</span>
                <span class="c1"># following tags.</span>
                <span class="nv">test_tag_array</span><span class="o">=(</span><span class="s2">&quot;mrrAND</span><span class="si">${</span><span class="nv">default_nic</span><span class="si">}</span><span class="s2">AND1cAND64bANDip4base&quot;</span>
                                <span class="s2">&quot;mrrAND</span><span class="si">${</span><span class="nv">default_nic</span><span class="si">}</span><span class="s2">AND1cAND78bANDip6base&quot;</span>
                                <span class="s2">&quot;mrrAND</span><span class="si">${</span><span class="nv">default_nic</span><span class="si">}</span><span class="s2">AND1cAND64bANDl2bdbase&quot;</span>
                                <span class="s2">&quot;mrrAND</span><span class="si">${</span><span class="nv">default_nic</span><span class="si">}</span><span class="s2">AND1cAND64bANDl2xcbase&quot;</span>
                                <span class="s2">&quot;!dot1q&quot;</span> <span class="s2">&quot;!drv_avf&quot;</span><span class="o">)</span>
            <span class="k">else</span>
                <span class="c1"># If trigger contains tags, split them into array.</span>
                <span class="nv">test_tag_array</span><span class="o">=(</span><span class="si">${</span><span class="nv">TEST_TAG_STRING</span><span class="p">//:/ </span><span class="si">}</span><span class="o">)</span>
            <span class="k">fi</span>
            <span class="p">;;</span>
    <span class="k">esac</span>

    <span class="c1"># Blacklisting certain tags per topology.</span>
    <span class="c1">#</span>
    <span class="c1"># Reasons for blacklisting:</span>
    <span class="c1"># - ipsechw - Blacklisted on testbeds without crypto hardware accelerator.</span>
    <span class="c1"># TODO: Add missing reasons here (if general) or where used (if specific).</span>
    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> in
        *<span class="s2">&quot;2n-skx&quot;</span>*<span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!ipsechw&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-skx&quot;</span>*<span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!ipsechw&quot;</span><span class="o">)</span>
            <span class="c1"># Not enough nic_intel-xxv710 to support double link tests.</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!3_node_double_link_topoANDnic_intel-xxv710&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;2n-clx&quot;</span>*<span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!ipsechw&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;2n-dnv&quot;</span>*<span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!ipsechw&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!memif&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!srv6_proxy&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!vhost&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!vts&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!drv_avf&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-dnv&quot;</span>*<span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!memif&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!srv6_proxy&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!vhost&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!vts&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!drv_avf&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-tsh&quot;</span>*<span class="o">)</span>
            <span class="c1"># 3n-tsh only has x520 NICs which don&#39;t work with AVF</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!drv_avf&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!ipsechw&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="s2">&quot;3n-hsw&quot;</span>*<span class="o">)</span>
            <span class="c1"># TODO: Introduce NOIOMMU version of AVF tests.</span>
            <span class="c1"># TODO: Make (both) AVF tests work on Haswell,</span>
            <span class="c1"># or document why (some of) it is not possible.</span>
            <span class="c1"># https://github.com/FDio/vpp/blob/master/src/plugins/avf/README.md</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!drv_avf&quot;</span><span class="o">)</span>
            <span class="c1"># All cards have access to QAT. But only one card (xl710)</span>
            <span class="c1"># resides in same NUMA as QAT. Other cards must go over QPI</span>
            <span class="c1"># which we do not want to even run.</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!ipsechwNOTnic_intel-xl710&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="o">)</span>
            <span class="c1"># Default to 3n-hsw due to compatibility.</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!drv_avf&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!ipsechwNOTnic_intel-xl710&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
    <span class="k">esac</span>

    <span class="c1"># We will add excluded NICs.</span>
    <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">exclude_nics</span><span class="p">[@]/#/!NIC_</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>

    <span class="nv">TAGS</span><span class="o">=()</span>

    <span class="c1"># We will prefix with perftest to prevent running other tests</span>
    <span class="c1"># (e.g. Functional).</span>
    <span class="nv">prefix</span><span class="o">=</span><span class="s2">&quot;perftestAND&quot;</span>
    <span class="nb">set</span> +x
    <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> <span class="s2">&quot;vpp-&quot;</span>* <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        <span class="c1"># Automatic prefixing for VPP jobs to limit the NIC used and</span>
        <span class="c1"># traffic evaluation to MRR.</span>
        <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_TAG_STRING</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> *<span class="s2">&quot;nic_&quot;</span>* <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
            <span class="nv">prefix</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">prefix</span><span class="si">}</span><span class="s2">mrrAND&quot;</span>
        <span class="k">else</span>
            <span class="nv">prefix</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">prefix</span><span class="si">}</span><span class="s2">mrrAND</span><span class="si">${</span><span class="nv">default_nic</span><span class="si">}</span><span class="s2">AND&quot;</span>
        <span class="k">fi</span>
    <span class="k">fi</span>
    <span class="k">for</span> tag in <span class="s2">&quot;</span><span class="si">${</span><span class="nv">test_tag_array</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">;</span> <span class="k">do</span>
        <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> <span class="s2">&quot;!&quot;</span>* <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
            <span class="c1"># Exclude tags are not prefixed.</span>
            <span class="nv">TAGS</span><span class="o">+=(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>
        <span class="k">elif</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> <span class="s2">&quot; &quot;</span>* <span class="o">||</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> *<span class="s2">&quot;perftest&quot;</span>* <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
            <span class="c1"># Badly formed tag expressions can trigger way too much tests.</span>
            <span class="nb">set</span> -x
            warn <span class="s2">&quot;The following tag expression hints at bad trigger: </span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span>
            warn <span class="s2">&quot;Possible cause: Multiple triggers in a single comment.&quot;</span>
            die <span class="s2">&quot;Aborting to avoid triggering too many tests.&quot;</span>
        <span class="k">elif</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span> !<span class="o">=</span> <span class="s2">&quot;&quot;</span> <span class="o">&amp;&amp;</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span> !<span class="o">=</span> <span class="s2">&quot;#&quot;</span>* <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
            <span class="c1"># Empty and comment lines are skipped.</span>
            <span class="c1"># Other lines are normal tags, they are to be prefixed.</span>
            <span class="nv">TAGS</span><span class="o">+=(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">prefix</span><span class="si">}${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>
        <span class="k">fi</span>
    <span class="k">done</span>
    <span class="nb">set</span> -x
<span class="o">}</span>


<span class="k">function</span> select_topology <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Variables read:</span>
    <span class="c1"># - NODENESS - Node multiplicity of testbed, either &quot;2n&quot; or &quot;3n&quot;.</span>
    <span class="c1"># - FLAVOR - Node flavor string, currently either &quot;hsw&quot; or &quot;skx&quot;.</span>
    <span class="c1"># - CSIT_DIR - Path to existing root of local CSIT git repository.</span>
    <span class="c1"># - TOPOLOGIES_DIR - Path to existing directory with available topologies.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - TOPOLOGIES - Array of paths to suitable topology yaml files.</span>
    <span class="c1"># - TOPOLOGIES_TAGS - Tag expression selecting tests for the topology.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nv">case_text</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">NODENESS</span><span class="si">}</span><span class="s2">_</span><span class="si">${</span><span class="nv">FLAVOR</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">case_text</span><span class="si">}</span><span class="s2">&quot;</span> in
        <span class="c1"># TODO: Move tags to &quot;# Blacklisting certain tags per topology&quot; section.</span>
        <span class="c1"># TODO: Double link availability depends on NIC used.</span>
        <span class="s2">&quot;1n_vbox&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*vpp_device*.template <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;2_node_single_link_topo&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;1n_skx&quot;</span> <span class="p">|</span> <span class="s2">&quot;1n_tx2&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*vpp_device*.template <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;2_node_single_link_topo&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;2n_skx&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*2n_skx*.yaml <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;2_node_*_link_topo&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;3n_skx&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*3n_skx*.yaml <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;3_node_*_link_topo&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;2n_clx&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*2n_clx*.yaml <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;2_node_*_link_topo&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;2n_dnv&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*2n_dnv*.yaml <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;2_node_single_link_topo&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;3n_dnv&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*3n_dnv*.yaml <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;3_node_single_link_topo&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;3n_hsw&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*3n_hsw*.yaml <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;3_node_single_link_topo&quot;</span>
            <span class="p">;;</span>
        <span class="s2">&quot;3n_tsh&quot;</span><span class="o">)</span>
            <span class="nv">TOPOLOGIES</span><span class="o">=(</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES_DIR</span><span class="si">}</span><span class="s2">&quot;</span>/*3n_tsh*.yaml <span class="o">)</span>
            <span class="nv">TOPOLOGIES_TAGS</span><span class="o">=</span><span class="s2">&quot;3_node_single_link_topo&quot;</span>
            <span class="p">;;</span>
        *<span class="o">)</span>
            <span class="c1"># No falling back to 3n_hsw default, that should have been done</span>
            <span class="c1"># by the function which has set NODENESS and FLAVOR.</span>
            die <span class="s2">&quot;Unknown specification: </span><span class="si">${</span><span class="nv">case_text</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="k">esac</span>

    <span class="k">if</span> <span class="o">[[</span> -z <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TOPOLOGIES</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        die <span class="s2">&quot;No applicable topology found!&quot;</span>
    <span class="k">fi</span>
<span class="o">}</span>


<span class="k">function</span> select_vpp_device_tags <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Variables read:</span>
    <span class="c1"># - TEST_CODE - String affecting test selection, usually jenkins job name.</span>
    <span class="c1"># - TEST_TAG_STRING - String selecting tags, from gerrit comment.</span>
    <span class="c1">#   Can be unset.</span>
    <span class="c1"># Variables set:</span>
    <span class="c1"># - TAGS - Array of processed tag boolean expressions.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> in
        <span class="c1"># Select specific device tests based on jenkins job type variable.</span>
        * <span class="o">)</span>
            <span class="k">if</span> <span class="o">[[</span> -z <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_TAG_STRING</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
                <span class="c1"># If nothing is specified, we will run pre-selected tests by</span>
                <span class="c1"># following tags. Items of array will be concatenated by OR</span>
                <span class="c1"># in Robot Framework.</span>
                <span class="nv">test_tag_array</span><span class="o">=()</span>
            <span class="k">else</span>
                <span class="c1"># If trigger contains tags, split them into array.</span>
                <span class="nv">test_tag_array</span><span class="o">=(</span><span class="si">${</span><span class="nv">TEST_TAG_STRING</span><span class="p">//:/ </span><span class="si">}</span><span class="o">)</span>
            <span class="k">fi</span>
            <span class="p">;;</span>
    <span class="k">esac</span>

    <span class="c1"># Blacklisting certain tags per topology.</span>
    <span class="c1">#</span>
    <span class="c1"># Reasons for blacklisting:</span>
    <span class="c1"># - avf - AVF is not possible to run on enic driver of VirtualBox.</span>
    <span class="c1"># - vhost - VirtualBox does not support nesting virtualization on Intel CPU.</span>
    <span class="k">case</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> in
        *<span class="s2">&quot;1n-vbox&quot;</span>*<span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!avf&quot;</span><span class="o">)</span>
            <span class="nv">test_tag_array</span><span class="o">+=(</span><span class="s2">&quot;!vhost&quot;</span><span class="o">)</span>
            <span class="p">;;</span>
        *<span class="o">)</span>
            <span class="p">;;</span>
    <span class="k">esac</span>

    <span class="nv">TAGS</span><span class="o">=()</span>

    <span class="c1"># We will prefix with devicetest to prevent running other tests</span>
    <span class="c1"># (e.g. Functional).</span>
    <span class="nv">prefix</span><span class="o">=</span><span class="s2">&quot;devicetestAND&quot;</span>
    <span class="k">if</span> <span class="o">[[</span> <span class="s2">&quot;</span><span class="si">${</span><span class="nv">TEST_CODE</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">==</span> <span class="s2">&quot;vpp-&quot;</span>* <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        <span class="c1"># Automatic prefixing for VPP jobs to limit testing.</span>
        <span class="nv">prefix</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">prefix</span><span class="si">}</span><span class="s2">&quot;</span>
    <span class="k">fi</span>
    <span class="k">for</span> tag in <span class="s2">&quot;</span><span class="si">${</span><span class="nv">test_tag_array</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">;</span> <span class="k">do</span>
        <span class="k">if</span> <span class="o">[[</span> <span class="si">${</span><span class="nv">tag</span><span class="si">}</span> <span class="o">==</span> <span class="s2">&quot;!&quot;</span>* <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
            <span class="c1"># Exclude tags are not prefixed.</span>
            <span class="nv">TAGS</span><span class="o">+=(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>
        <span class="k">else</span>
            <span class="nv">TAGS</span><span class="o">+=(</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">prefix</span><span class="si">}${</span><span class="nv">tag</span><span class="si">}</span><span class="s2">&quot;</span><span class="o">)</span>
        <span class="k">fi</span>
    <span class="k">done</span>
<span class="o">}</span>

<span class="k">function</span> untrap_and_unreserve_testbed <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Use this as a trap function to ensure testbed does not remain reserved.</span>
    <span class="c1"># Perhaps call directly before script exit, to free testbed for other jobs.</span>
    <span class="c1"># This function is smart enough to avoid multiple unreservations (so safe).</span>
    <span class="c1"># Topo cleanup is executed (call it best practice), ignoring failures.</span>
    <span class="c1">#</span>
    <span class="c1"># Hardcoded values:</span>
    <span class="c1"># - default message to die with if testbed might remain reserved.</span>
    <span class="c1"># Arguments:</span>
    <span class="c1"># - ${1} - Message to die with if unreservation fails. Default hardcoded.</span>
    <span class="c1"># Variables read (by inner function):</span>
    <span class="c1"># - WORKING_TOPOLOGY - Path to topology yaml file of the reserved testbed.</span>
    <span class="c1"># - PYTHON_SCRIPTS_DIR - Path to directory holding Python scripts.</span>
    <span class="c1"># Variables written:</span>
    <span class="c1"># - WORKING_TOPOLOGY - Set to empty string on successful unreservation.</span>
    <span class="c1"># Trap unregistered:</span>
    <span class="c1"># - EXIT - Failure to untrap is reported, but ignored otherwise.</span>
    <span class="c1"># Functions called:</span>
    <span class="c1"># - die - Print to stderr and exit.</span>
    <span class="c1"># - ansible_hosts - Perform an action using ansible, see ansible.sh</span>

    <span class="nb">set</span> -xo pipefail
    <span class="nb">set</span> +eu  <span class="c1"># We do not want to exit early in a &quot;teardown&quot; function.</span>
    <span class="nb">trap</span> - EXIT <span class="o">||</span> <span class="nb">echo</span> <span class="s2">&quot;Trap deactivation failed, continuing anyway.&quot;</span>
    <span class="nv">wt</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">WORKING_TOPOLOGY</span><span class="si">}</span><span class="s2">&quot;</span>  <span class="c1"># Just to avoid too long lines.</span>
    <span class="k">if</span> <span class="o">[[</span> -z <span class="s2">&quot;</span><span class="si">${</span><span class="nv">wt</span><span class="p">-</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
        <span class="nb">set</span> -eu
        warn <span class="s2">&quot;Testbed looks unreserved already. Trap removal failed before?&quot;</span>
    <span class="k">else</span>
        ansible_hosts <span class="s2">&quot;cleanup&quot;</span> <span class="o">||</span> <span class="nb">true</span>
        python3 <span class="s2">&quot;</span><span class="si">${</span><span class="nv">PYTHON_SCRIPTS_DIR</span><span class="si">}</span><span class="s2">/topo_reservation.py&quot;</span> -c -t <span class="s2">&quot;</span><span class="si">${</span><span class="nv">wt</span><span class="si">}</span><span class="s2">&quot;</span> <span class="o">||</span> <span class="o">{</span>
            die <span class="s2">&quot;</span><span class="si">${</span><span class="nv">1</span><span class="k">:-</span><span class="nv">FAILED</span><span class="p"> TO UNRESERVE, FIX MANUALLY.</span><span class="si">}</span><span class="s2">&quot;</span> <span class="m">2</span>
        <span class="o">}</span>
        <span class="nv">WORKING_TOPOLOGY</span><span class="o">=</span><span class="s2">&quot;&quot;</span>
        <span class="nb">set</span> -eu
    <span class="k">fi</span>
<span class="o">}</span>


<span class="k">function</span> warn <span class="o">()</span> <span class="o">{</span>

    <span class="c1"># Print the message to standard error.</span>
    <span class="c1">#</span>
    <span class="c1"># Arguments:</span>
    <span class="c1"># - ${@} - The text of the message.</span>

    <span class="nb">set</span> -exuo pipefail

    <span class="nb">echo</span> <span class="s2">&quot;</span><span class="nv">$@</span><span class="s2">&quot;</span> &gt;<span class="p">&amp;</span><span class="m">2</span>
<span class="o">}</span>
</pre></div>
</code></pre></td></tr></table>
</div> <!-- class=content -->
<div id="lfcollabprojects-footer">
  <div class="gray-diagonal">
    <div class="footer-inner">
      <p>
        &copy; 2016 <a href="https://www.fd.io/">FD.io</a> a Linux Foundation
        Collaborative Project. All Rights Reserved.
      </p>
      <p>
        Linux Foundation is a registered trademark of The Linux Foundation.
        Linux is a registered
        <a
          href="http://www.linuxfoundation.org/programs/legal/trademark"
          title="Linux Mark Institute"
          >trademark</a
        >
        of Linus Torvalds.
      </p>
      <p>
        Please see our
        <a href="http://www.linuxfoundation.org/privacy">privacy policy</a> and
        <a href="http://www.linuxfoundation.org/terms">terms of use</a>
      </p>
    </div>
  </div>
</div>
</div> <!-- id=cgit -->
</body>
</html>
