aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authort3sserakt <t3ss@posteo.de>2023-06-29 18:26:18 +0200
committert3sserakt <t3ss@posteo.de>2023-06-29 18:26:18 +0200
commit18bc7ff237cfc62935e292a3a662f3e115aad018 (patch)
tree06a50458d70033812ab5f0b44e74f6c82dd140de
parent18a77c57310ffa6f95c6fcafc6d2315e65974dcc (diff)
downloadwww-18bc7ff237cfc62935e292a3a662f3e115aad018.tar.gz
www-18bc7ff237cfc62935e292a3a662f3e115aad018.zip
Added new milestones for L2O project, a detail page for finished milestone 7 and corrected the description of the configuration syntax for test ng test cases.
-rw-r--r--template/l2o/index.html.j257
-rw-r--r--template/l2o/mile7.html.j252
-rw-r--r--template/l2o/testng.html.j217
3 files changed, 118 insertions, 8 deletions
diff --git a/template/l2o/index.html.j2 b/template/l2o/index.html.j2
index 17644fde..e859f70f 100644
--- a/template/l2o/index.html.j2
+++ b/template/l2o/index.html.j2
@@ -19,6 +19,9 @@
19 <a class="nav-link" href="#milestone4">{{ _("Milestone 4") }}</a> 19 <a class="nav-link" href="#milestone4">{{ _("Milestone 4") }}</a>
20 <a class="nav-link" href="#milestone5">{{ _("Milestone 5") }}</a> 20 <a class="nav-link" href="#milestone5">{{ _("Milestone 5") }}</a>
21 <a class="nav-link" href="#milestone6">{{ _("Milestone 6") }}</a> 21 <a class="nav-link" href="#milestone6">{{ _("Milestone 6") }}</a>
22 <a class="nav-link" href="#milestone7">{{ _("Milestone 7") }}</a>
23 <a class="nav-link" href="#milestone8">{{ _("Milestone 8") }}</a>
24 <a class="nav-link" href="#milestone9">{{ _("Milestone 9") }}</a>
22 </nav> 25 </nav>
23 </div> 26 </div>
24 <div class="col"> 27 <div class="col">
@@ -208,7 +211,59 @@ I will finish the project with a performance analysis to optimize the selection
208 </p><br/> 211 </p><br/>
209 </section> 212 </section>
210 213
211 214 <h3><a name="milestone7" class="subnav-anchor"></a>{{ _("Milestone 7 Removing deprecated code") }}</h3><br/>
215 <section>
216 <p>
217 {% trans %}
218 The code of the old transport API and of the ATS API will be removed from the code base. This is
219mainly the use of the API in the Core layer, and suggesting addresses to connect to other peers in
220all kinds of other GNUnet layers. Additionally all tests which rely on the removed code will be set
221inactive. All usages of the old APIs will be removed. If it is not much work to replace the old with the
222new API this will be done directly, otherwise there will be a TODO comment what needs to be doneto make that part of the code working again with the new code. Documentation of code that will be
223deleted without replacement, because the functionality is missing in the new API.
224 {% endtrans %}
225 </p><br/>
226 <h4>Deliverable</h4><br/>
227 <p>
228 {% trans %}
229 Removed APIs from code base, deactivated dependent tests and either documentation of what is
230necessary for the integration of the new API, or if the effort for this is as high as the documentation
231directly the implementation. More <a href="mile7.html">Details</a>.
232 {% endtrans %}
233 </p><br/>
234 </section>
235
236 <h3><a name="milestone8" class="subnav-anchor"></a>{{ _("Milestone 8 Make GNUnet start again") }}</h3><br/>
237 <section>
238 <p>
239 {% trans %}
240 All missing implementations of the new API will be finished, necessary to make GNUnet start and
241being usable for its basic functionality (DHT, GNS, CADET, FS, Messenger …).
242 {% endtrans %}
243 </p><br/>
244 <h4>Deliverable</h4><br/>
245 <p>
246 {% trans %}
247 GNUnet running with new API.
248 {% endtrans %}
249 </p><br/>
250 </section>
251
252 <h3><a name="milestone9" class="subnav-anchor"></a>{{ _("Milestone 9 Testing and Fixing") }}</h3><br/>
253 <section>
254 <p>
255 {% trans %}
256 Because all integration tests are deactivated, and there are no resources to rewrite them at the
257time being, extensive manual testing and certainly bug fixing is necessary.
258 {% endtrans %}
259 </p><br/>
260 <h4>Deliverable</h4><br/>
261 <p>
262 {% trans %}
263 GNUnet release running with new API.
264 {% endtrans %}
265 </p><br/>
266 </section>
212 267
213 </div> 268 </div>
214 </div> 269 </div>
diff --git a/template/l2o/mile7.html.j2 b/template/l2o/mile7.html.j2
new file mode 100644
index 00000000..4009f1f4
--- /dev/null
+++ b/template/l2o/mile7.html.j2
@@ -0,0 +1,52 @@
1 {% extends "common/base.j2" %}
2{% block body_content %}
3<main id="maincontent">
4<article class="container">
5
6 <header>
7 <h1>{{ _("NGI Assure project: Layer-2-Overlay") }}</h1>
8 </header>
9
10 <div class="row">
11 <div class="col-2 d-none d-lg-block"><!-- for large viewports show menu for better orientation -->
12 <nav class="nav subnav position-fixed flex-column border-right" style="position:fixed">
13 <a class="nav-link" href="index.html#idea">{{ _("Project main page") }}</a>
14 </nav>
15 </div>
16 <div class="col">
17
18 <h2>Implementation details milestone 7</h2><br/>
19
20 <section>
21 <h4>{{ _("Marked old transport API as deprecated") }}</h4><br/>
22 <p>
23 {% trans %}
24 To make the search for the old API methods easier, those methods were marked as deprecated in their header files.</br></br>
25
26 See branch l20integration revision 664286d.
27 {% endtrans %}
28 </p>
29 </section>
30 <section>
31 <h4>{{ _("Removed usage of old transport API methods") }}</h4><br/>
32 <p>
33 {% trans %}
34 Removed usage of old transport API methods and exchanged them with API methods of L2O or deleted without replacement, if there is no corresponding functionality in L2O.</br></br>
35
36 In the process, the subsystems cadet, core, dhtu, fs and topology were touched.</br></br>
37
38 The blacklist and friend functionality in subsystem topology was deleted without replacement, as well as the bandwith allocation in the fs (file sharing) subsystem.</br></br>
39
40 In the transport subsystem itself, old API methods are still used until the code is finally removed in Milestone 9. There is a cli tool gnunet-transport in the transport subsystem which needs be rewritten partially to get infromation from L2O which can not retrieved via the old API anymore.</br></br>
41
42 Additionally there is a peerinfo cli tool gnunet-peerinfo, which needs to be rewritten partially too.</br></br>
43
44 See branch l20integration revision b78f993.
45 {% endtrans %}
46 </p>
47 </section>
48 </div>
49 </div>
50
51</article>
52{% endblock body_content %}
diff --git a/template/l2o/testng.html.j2 b/template/l2o/testng.html.j2
index 4509b756..69905711 100644
--- a/template/l2o/testng.html.j2
+++ b/template/l2o/testng.html.j2
@@ -84,28 +84,31 @@ GlobalPluginName = "libgnunet_test_transport_plugin_cmd_", PluginName ;<br/><br/
84GlobalPeer = "K", ":", IndexOfGlobalNode ;<br/><br/> 84GlobalPeer = "K", ":", IndexOfGlobalNode ;<br/><br/>
85KValue = EstablishConnectionToPeerViaProtocol ;<br/><br/> 85KValue = EstablishConnectionToPeerViaProtocol ;<br/><br/>
86IndexOfSubnetRouter = Zero | NaturalNumber ;<br/><br/> 86IndexOfSubnetRouter = Zero | NaturalNumber ;<br/><br/>
87RValue = "{", ProtocolPortToOpen, ":", switch, "}" ;<br/><br/> 87RValue = OpenTCP, "|", OpenUDP ;<br/><br/>
88SubnetPeer = "P:", SubnetIndex, ":", NodeIndexInSubnet ;<br/><br/> 88SubnetPeer = "P:", SubnetIndex, ":", NodeIndexInSubnet ;<br/><br/>
89PValue = EstablishConnectionToPeerViaProtocol, "|", { "{", NumberOfAdditionalConnections, "}" } ;<br/><br/> 89PValue = EstablishConnectionToPeerViaProtocol, { "|", "{", NumberOfAdditionalConnections, "}" } ;<br/><br/>
90Zero = "0" ;<br/><br/> 90Zero = "0" ;<br/><br/>
91NaturalNumber = NumeralWithoutZero, { Numeral } ;<br/><br/> 91NaturalNumber = NumeralWithoutZero, { Numeral } ;<br/><br/>
92PluginName = Letter , { ( Letter | "_" ) } ;<br/><br/> 92PluginName = Letter , { ( Letter | "_" ) } ;<br/><br/>
93IndexOfGlobalNode = Zero | NaturalNumber ;<br/><br/> 93IndexOfGlobalNode = Zero | NaturalNumber ;<br/><br/>
94EstablishConnectionToPeerViaProtocol = "{" "connect", ":" EstablishConnectionToPeerViaProtocolValues "}" ;<br/><br/> 94EstablishConnectionToPeerViaProtocol = "{" "connect", ":" EstablishConnectionToPeerViaProtocolValues "}" ;<br/><br/>
95ProtocolPortToOpen = "tcp_port" | "udp_port" ;<br/><br/> 95OpenTCP = OpenTCPNoSource | OpenTCPWithSource ;<br/><br/>
96switch = On | Off ;<br/><br/> 96OpenUDP = OpenUDPNoSource | OpenUDPWithSource ;<br/><br/>
97SubnetIndex = NaturalNumber ;<br/><br/> 97SubnetIndex = NaturalNumber ;<br/><br/>
98NodeIndexInSubnet = NaturalNumber ;<br/><br/> 98NodeIndexInSubnet = NaturalNumber ;<br/><br/>
99NumeralWithoutZero = "0" | Numeral ;<br/><br/> 99NumeralWithoutZero = "0" | Numeral ;<br/><br/>
100Numeral = "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" ;<br/><br/> 100Numeral = "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" ;<br/><br/>
101Letter = "A" | "B" | ... | "Z" | "a" | ... | "z";<br/><br/> 101Letter = "A" | "B" | ... | "Z" | "a" | ... | "z";<br/><br/>
102EstablishConnectionToPeerViaProtocolValues = EstablishConnectionToPeerViaProtocolValue { "|", EstablishConnectionToPeerViaProtocolValue } 102EstablishConnectionToPeerViaProtocolValues = EstablishConnectionToPeerViaProtocolValue { "|", EstablishConnectionToPeerViaProtocolValue }
103OpenTCPNoSource = "{tcp_port:", switch, "}" ;<br/><br/>
104OpenUDPNoSource = "{udp_port:", switch, "}" ;<br/><br/>
105OpenTCPWithSource = "{tcp_port:", SubnetPeer, { "tcp_port", SubnetPeer } ;<br/><br/>
106OpenTUDWithSource = "{udp_port:", SubnetPeer, { "udp_port", SubnetPeer } ;<br/><br/>
103EstablishConnectionToPeerViaProtocolValue = "{", ( GlobalPeer | SubnetPeer ), ":", Protocol, "}" ;<br/><br/> 107EstablishConnectionToPeerViaProtocolValue = "{", ( GlobalPeer | SubnetPeer ), ":", Protocol, "}" ;<br/><br/>
108switch = On | Off ;<br/><br/>
109Protocol = "tcp" | "udp" ;<br/><br/>
104On = 1 ;<br/><br/> 110On = 1 ;<br/><br/>
105Off = 0 ;<br/><br/> 111Off = 0 ;<br/><br/>
106Protocol = "tcp" | "udp" ;<br/><br/>
107on = "1" ;<br/><br/>
108off = "0" ;<br/><br/>
109 {% endtrans %} 112 {% endtrans %}
110 </p> 113 </p>
111 </section> 114 </section>