--- a/src/ltp-protocol/doc/figures/ltp-protocol-structure.eps Mon Aug 11 01:28:34 2014 +0200
+++ b/src/ltp-protocol/doc/figures/ltp-protocol-structure.eps Mon Aug 11 12:48:44 2014 +0200
@@ -1,11 +1,11 @@
%!PS-Adobe-2.0 EPSF-2.0
%%Title: /home/administrador/GSOC/Specification/block.dia
%%Creator: Dia v0.97.1
-%%CreationDate: Sat Jun 21 21:30:52 2014
+%%CreationDate: Mon Aug 11 12:43:01 2014
%%For: administrador
%%Orientation: Portrait
%%Magnification: 1.0000
-%%BoundingBox: 0 0 1605 1546
+%%BoundingBox: 0 0 1571 1546
%%BeginSetup
%%EndSetup
%%EndComments
@@ -118,7 +118,7 @@
/start_ol { gsave 1.1 dpi_x div dup scale} bind def
/end_ol { closepath fill grestore } bind def
28.346000 -28.346000 scale
-15.649900 -44.600000 translate
+14.449800 -44.600000 translate
%%EndProlog
@@ -875,10 +875,10 @@
[] 0 sd
0 slj
1.000000 1.000000 1.000000 srgb
-n 8.687500 34.750000 m 8.687500 37.500000 l 20.787500 37.500000 l 20.787500 34.750000 l f
+n 4.600100 34.750000 m 4.600100 37.500000 l 26.750100 37.500000 l 26.750100 34.750000 l f
0.000000 0.000000 0.000000 srgb
-n 8.687500 34.750000 m 8.687500 37.500000 l 20.787500 37.500000 l 20.787500 34.750000 l cp s
-gsave 11.537500 36.550000 translate 0.035278 -0.035278 scale
+n 4.600100 34.750000 m 4.600100 37.500000 l 26.750100 37.500000 l 26.750100 34.750000 l cp s
+gsave 7.337500 36.450000 translate 0.035278 -0.035278 scale
start_ol
832 6208 moveto
1664 6208 lineto
@@ -888,7 +888,7 @@
832 0 lineto
832 6208 lineto
end_ol grestore
-gsave 12.166911 36.550000 translate 0.035278 -0.035278 scale
+gsave 7.966911 36.450000 translate 0.035278 -0.035278 scale
start_ol
1536 6016 moveto
1536 4672 lineto
@@ -910,7 +910,7 @@
768 6016 lineto
1536 6016 lineto
end_ol grestore
-gsave 12.608996 36.550000 translate 0.035278 -0.035278 scale
+gsave 8.408996 36.450000 translate 0.035278 -0.035278 scale
start_ol
1536 704 moveto
1536 -1792 lineto
@@ -936,81 +936,260 @@
3413 512 3754 997 conicto
4096 1483 4096 2336 conicto
end_ol grestore
-gsave 13.325819 36.550000 translate 0.035278 -0.035278 scale
-start_ol
-1664 5504 moveto
+gsave 9.125819 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+5440 5760 moveto
+5440 4864 lineto
+5018 5250 4541 5441 conicto
+4064 5632 3526 5632 conicto
+2468 5632 1906 4982 conicto
+1344 4332 1344 3102 conicto
+1344 1876 1906 1226 conicto
+2468 576 3526 576 conicto
+4064 576 4541 767 conicto
+5018 958 5440 1344 conicto
+5440 448 lineto
+5001 160 4509 16 conicto
+4018 -128 3471 -128 conicto
+2065 -128 1256 738 conicto
+448 1604 448 3102 conicto
+448 4604 1256 5470 conicto
+2065 6336 3471 6336 conicto
+4026 6336 4517 6192 conicto
+5009 6048 5440 5760 conicto
+end_ol grestore
+gsave 9.912582 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+2594 4160 moveto
+1986 4160 1633 3672 conicto
+1280 3185 1280 2336 conicto
+1280 1487 1631 999 conicto
+1982 512 2594 512 conicto
+3198 512 3551 1002 conicto
+3904 1492 3904 2336 conicto
+3904 3176 3551 3668 conicto
+3198 4160 2594 4160 conicto
+2592 4800 moveto
+3593 4800 4164 4146 conicto
+4736 3493 4736 2336 conicto
+4736 1184 4164 528 conicto
+3593 -128 2592 -128 conicto
+1587 -128 1017 528 conicto
+448 1184 448 2336 conicto
+448 3493 1017 4146 conicto
+1587 4800 2592 4800 conicto
+end_ol grestore
+gsave 10.601937 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+4672 2835 moveto
+4672 0 lineto
+3904 0 lineto
+3904 2810 lineto
+3904 3487 3646 3823 conicto
+3388 4160 2872 4160 conicto
+2252 4160 1894 3756 conicto
+1536 3352 1536 2655 conicto
+1536 0 lineto
+768 0 lineto
+768 4672 lineto
+1536 4672 lineto
+1536 3968 lineto
+1811 4386 2183 4593 conicto
+2556 4800 3044 4800 conicto
+3847 4800 4259 4301 conicto
+4672 3803 4672 2835 conicto
+end_ol grestore
+gsave 11.316263 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+256 4672 moveto
+1069 4672 lineto
+2528 751 lineto
+3987 4672 lineto
+4800 4672 lineto
+3049 0 lineto
+2007 0 lineto
+256 4672 lineto
+end_ol grestore
+gsave 11.983137 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+4736 2536 moveto
+4736 2176 lineto
+1280 2176 lineto
+1329 1363 1745 937 conicto
+2162 512 2906 512 conicto
+3337 512 3741 624 conicto
+4146 736 4544 960 conicto
+4544 256 lineto
+4136 68 3708 -30 conicto
+3280 -128 2840 -128 conicto
+1736 -128 1092 525 conicto
+448 1179 448 2294 conicto
+448 3446 1061 4123 conicto
+1675 4800 2716 4800 conicto
+3650 4800 4193 4191 conicto
+4736 3582 4736 2536 conicto
+3968 2752 moveto
+3960 3394 3625 3777 conicto
+3290 4160 2738 4160 conicto
+2112 4160 1736 3790 conicto
+1361 3420 1304 2748 conicto
+3968 2752 lineto
+end_ol grestore
+gsave 12.677486 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+3520 3968 moveto
+3389 4034 3235 4065 conicto
+3082 4096 2897 4096 conicto
+2239 4096 1887 3677 conicto
+1536 3259 1536 2475 conicto
+1536 0 lineto
+768 0 lineto
+768 4672 lineto
+1536 4672 lineto
+1536 3968 lineto
+1780 4390 2172 4595 conicto
+2564 4800 3124 4800 conicto
+3204 4800 3301 4784 conicto
+3398 4768 3516 4736 conicto
+3520 3968 lineto
+end_ol grestore
+gsave 13.122069 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+3840 2398 moveto
+3840 3237 3503 3698 conicto
+3166 4160 2558 4160 conicto
+1954 4160 1617 3698 conicto
+1280 3237 1280 2398 conicto
+1280 1563 1617 1101 conicto
+1954 640 2558 640 conicto
+3166 640 3503 1101 conicto
+3840 1563 3840 2398 conicto
+4608 578 moveto
+4608 -622 4082 -1207 conicto
+3557 -1792 2472 -1792 conicto
+2071 -1792 1715 -1729 conicto
+1359 -1666 1024 -1536 conicto
+1024 -768 lineto
+1358 -964 1684 -1058 conicto
+2011 -1152 2349 -1152 conicto
+3097 -1152 3468 -756 conicto
+3840 -360 3840 441 conicto
+3840 832 lineto
+3603 414 3233 207 conicto
+2864 0 2350 0 conicto
+1494 0 971 657 conicto
+448 1314 448 2398 conicto
+448 3486 971 4143 conicto
+1494 4800 2350 4800 conicto
+2864 4800 3233 4593 conicto
+3603 4386 3840 3968 conicto
+3840 4672 lineto
+4608 4672 lineto
+4608 578 lineto
+end_ol grestore
+gsave 13.838891 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+4736 2536 moveto
+4736 2176 lineto
+1280 2176 lineto
+1329 1363 1745 937 conicto
+2162 512 2906 512 conicto
+3337 512 3741 624 conicto
+4146 736 4544 960 conicto
+4544 256 lineto
+4136 68 3708 -30 conicto
+3280 -128 2840 -128 conicto
+1736 -128 1092 525 conicto
+448 1179 448 2294 conicto
+448 3446 1061 4123 conicto
+1675 4800 2716 4800 conicto
+3650 4800 4193 4191 conicto
+4736 3582 4736 2536 conicto
+3968 2752 moveto
+3960 3394 3625 3777 conicto
+3290 4160 2738 4160 conicto
+2112 4160 1736 3790 conicto
+1361 3420 1304 2748 conicto
+3968 2752 lineto
+end_ol grestore
+gsave 14.533241 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+4672 2835 moveto
+4672 0 lineto
+3904 0 lineto
+3904 2810 lineto
+3904 3487 3646 3823 conicto
+3388 4160 2872 4160 conicto
+2252 4160 1894 3756 conicto
+1536 3352 1536 2655 conicto
+1536 0 lineto
+768 0 lineto
+768 4672 lineto
+1536 4672 lineto
+1536 3968 lineto
+1811 4386 2183 4593 conicto
+2556 4800 3044 4800 conicto
+3847 4800 4259 4301 conicto
+4672 3803 4672 2835 conicto
+end_ol grestore
+gsave 15.247566 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+4160 4480 moveto
+4160 3776 lineto
+3835 3968 3508 4064 conicto
+3182 4160 2849 4160 conicto
+2104 4160 1692 3681 conicto
+1280 3202 1280 2336 conicto
+1280 1470 1692 991 conicto
+2104 512 2849 512 conicto
+3182 512 3508 608 conicto
+3835 704 4160 896 conicto
+4160 192 lineto
+3837 32 3491 -48 conicto
+3146 -128 2756 -128 conicto
+1697 -128 1072 538 conicto
+448 1205 448 2336 conicto
+448 3484 1078 4142 conicto
+1709 4800 2807 4800 conicto
+3163 4800 3502 4720 conicto
+3842 4640 4160 4480 conicto
+end_ol grestore
+gsave 15.866980 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+4736 2536 moveto
+4736 2176 lineto
+1280 2176 lineto
+1329 1363 1745 937 conicto
+2162 512 2906 512 conicto
+3337 512 3741 624 conicto
+4146 736 4544 960 conicto
+4544 256 lineto
+4136 68 3708 -30 conicto
+3280 -128 2840 -128 conicto
+1736 -128 1092 525 conicto
+448 1179 448 2294 conicto
+448 3446 1061 4123 conicto
+1675 4800 2716 4800 conicto
+3650 4800 4193 4191 conicto
+4736 3582 4736 2536 conicto
+3968 2752 moveto
+3960 3394 3625 3777 conicto
+3290 4160 2738 4160 conicto
+2112 4160 1736 3790 conicto
+1361 3420 1304 2748 conicto
+3968 2752 lineto
+end_ol grestore
+gsave 16.561330 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+832 6208 moveto
+1664 6208 lineto
1664 704 lineto
-2686 704 lineto
-3981 704 4582 1283 conicto
-5184 1862 5184 3110 conicto
-5184 4351 4582 4927 conicto
-3981 5504 2686 5504 conicto
-1664 5504 lineto
-832 6208 moveto
-2557 6208 lineto
-4377 6208 5228 5457 conicto
-6080 4707 6080 3110 conicto
-6080 1505 5224 752 conicto
-4369 0 2557 0 conicto
+4672 704 lineto
+4672 0 lineto
832 0 lineto
832 6208 lineto
end_ol grestore
-gsave 14.195000 36.550000 translate 0.035278 -0.035278 scale
-start_ol
-2834 2368 moveto
-1921 2368 1568 2152 conicto
-1216 1936 1216 1415 conicto
-1216 999 1480 755 conicto
-1744 512 2199 512 conicto
-2826 512 3205 971 conicto
-3584 1431 3584 2194 conicto
-3584 2368 lineto
-2834 2368 lineto
-4352 2672 moveto
-4352 0 lineto
-3584 0 lineto
-3584 704 lineto
-3325 278 2938 75 conicto
-2551 -128 1991 -128 conicto
-1283 -128 865 275 conicto
-448 678 448 1354 conicto
-448 2143 970 2543 conicto
-1492 2944 2527 2944 conicto
-3584 2944 lineto
-3584 3022 lineto
-3584 3565 3238 3862 conicto
-2892 4160 2267 4160 conicto
-1870 4160 1493 4064 conicto
-1116 3968 768 3776 conicto
-768 4480 lineto
-1187 4640 1581 4720 conicto
-1975 4800 2348 4800 conicto
-3356 4800 3854 4272 conicto
-4352 3744 4352 2672 conicto
-end_ol grestore
-gsave 14.886852 36.550000 translate 0.035278 -0.035278 scale
-start_ol
-1536 6016 moveto
-1536 4672 lineto
-3136 4672 lineto
-3136 4096 lineto
-1536 4096 lineto
-1536 1543 lineto
-1536 968 1694 804 conicto
-1853 640 2338 640 conicto
-3136 640 lineto
-3136 0 lineto
-2338 0 lineto
-1446 0 1107 332 conicto
-768 665 768 1543 conicto
-768 4096 lineto
-192 4096 lineto
-192 4672 lineto
-768 4672 lineto
-768 6016 lineto
-1536 6016 lineto
-end_ol grestore
-gsave 15.328938 36.550000 translate 0.035278 -0.035278 scale
+gsave 17.190740 36.450000 translate 0.035278 -0.035278 scale
start_ol
2834 2368 moveto
1921 2368 1568 2152 conicto
@@ -1043,183 +1222,110 @@
3356 4800 3854 4272 conicto
4352 3744 4352 2672 conicto
end_ol grestore
-gsave 16.020790 36.550000 translate 0.035278 -0.035278 scale
-start_ol
-768 6464 moveto
-1536 6464 lineto
-1536 0 lineto
-768 0 lineto
-768 6464 lineto
-end_ol grestore
-gsave 16.332999 36.550000 translate 0.035278 -0.035278 scale
-start_ol
-768 4672 moveto
-1536 4672 lineto
-1536 0 lineto
-768 0 lineto
-768 4672 lineto
-768 6464 moveto
-1536 6464 lineto
-1536 5504 lineto
-768 5504 lineto
-768 6464 lineto
-end_ol grestore
-gsave 16.645207 36.550000 translate 0.035278 -0.035278 scale
-start_ol
-4672 2835 moveto
-4672 0 lineto
-3904 0 lineto
-3904 2810 lineto
-3904 3487 3646 3823 conicto
-3388 4160 2872 4160 conicto
-2252 4160 1894 3756 conicto
-1536 3352 1536 2655 conicto
+gsave 17.882593 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+2762 -449 moveto
+2439 -1283 2132 -1537 conicto
+1826 -1792 1313 -1792 conicto
+704 -1792 lineto
+704 -1152 lineto
+1151 -1152 lineto
+1466 -1152 1640 -999 conicto
+1814 -847 2025 -280 conicto
+2162 71 lineto
+256 4672 lineto
+1093 4672 lineto
+2543 1018 lineto
+3992 4672 lineto
+4800 4672 lineto
+2762 -449 lineto
+end_ol grestore
+gsave 18.549467 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+4736 2536 moveto
+4736 2176 lineto
+1280 2176 lineto
+1329 1363 1745 937 conicto
+2162 512 2906 512 conicto
+3337 512 3741 624 conicto
+4146 736 4544 960 conicto
+4544 256 lineto
+4136 68 3708 -30 conicto
+3280 -128 2840 -128 conicto
+1736 -128 1092 525 conicto
+448 1179 448 2294 conicto
+448 3446 1061 4123 conicto
+1675 4800 2716 4800 conicto
+3650 4800 4193 4191 conicto
+4736 3582 4736 2536 conicto
+3968 2752 moveto
+3960 3394 3625 3777 conicto
+3290 4160 2738 4160 conicto
+2112 4160 1736 3790 conicto
+1361 3420 1304 2748 conicto
+3968 2752 lineto
+end_ol grestore
+gsave 19.243816 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+3520 3968 moveto
+3389 4034 3235 4065 conicto
+3082 4096 2897 4096 conicto
+2239 4096 1887 3677 conicto
+1536 3259 1536 2475 conicto
1536 0 lineto
768 0 lineto
768 4672 lineto
1536 4672 lineto
1536 3968 lineto
-1811 4386 2183 4593 conicto
-2556 4800 3044 4800 conicto
-3847 4800 4259 4301 conicto
-4672 3803 4672 2835 conicto
-end_ol grestore
-gsave 17.359532 36.550000 translate 0.035278 -0.035278 scale
-start_ol
-768 6464 moveto
-1536 6464 lineto
-1536 2657 lineto
-3822 4672 lineto
-4800 4672 lineto
-2327 2486 lineto
-4928 0 lineto
-3922 0 lineto
-1536 2282 lineto
-1536 0 lineto
-768 0 lineto
-768 6464 lineto
-end_ol grestore
-0.100000 slw
-[] 0 sd
-[] 0 sd
-0 slj
-1.000000 1.000000 1.000000 srgb
-n -15.599900 19.150000 m -15.599900 21.850000 l -3.449900 21.850000 l -3.449900 19.150000 l f
-0.000000 0.000000 0.000000 srgb
-n -15.599900 19.150000 m -15.599900 21.850000 l -3.449900 21.850000 l -3.449900 19.150000 l cp s
-gsave -12.999900 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-832 6208 moveto
-1664 6208 lineto
-1664 704 lineto
-4672 704 lineto
-4672 0 lineto
-832 0 lineto
-832 6208 lineto
-end_ol grestore
-gsave -12.370489 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-768 4672 moveto
-1536 4672 lineto
-1536 0 lineto
-768 0 lineto
-768 4672 lineto
-768 6464 moveto
-1536 6464 lineto
-1536 5504 lineto
-768 5504 lineto
-768 6464 lineto
-end_ol grestore
-gsave -12.058281 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-4672 2835 moveto
-4672 0 lineto
-3904 0 lineto
-3904 2810 lineto
-3904 3487 3646 3823 conicto
-3388 4160 2872 4160 conicto
-2252 4160 1894 3756 conicto
-1536 3352 1536 2655 conicto
-1536 0 lineto
-768 0 lineto
-768 4672 lineto
-1536 4672 lineto
-1536 3968 lineto
-1811 4386 2183 4593 conicto
-2556 4800 3044 4800 conicto
-3847 4800 4259 4301 conicto
-4672 3803 4672 2835 conicto
-end_ol grestore
-gsave -11.343956 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-768 6464 moveto
-1536 6464 lineto
-1536 2657 lineto
-3822 4672 lineto
-4800 4672 lineto
-2327 2486 lineto
-4928 0 lineto
-3922 0 lineto
-1536 2282 lineto
-1536 0 lineto
-768 0 lineto
-768 6464 lineto
-end_ol grestore
-gsave -10.689575 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-4544 6016 moveto
-4544 5184 lineto
-4078 5410 3664 5521 conicto
-3251 5632 2866 5632 conicto
-2197 5632 1834 5367 conicto
-1472 5103 1472 4614 conicto
-1472 4205 1711 3996 conicto
-1950 3787 2617 3659 conicto
-3108 3555 lineto
-4041 3376 4484 2923 conicto
-4928 2471 4928 1711 conicto
-4928 806 4322 339 conicto
-3716 -128 2546 -128 conicto
-2104 -128 1606 -31 conicto
-1109 66 576 256 conicto
-576 1152 lineto
-1086 866 1575 721 conicto
-2064 576 2536 576 conicto
-3253 576 3642 858 conicto
-4032 1140 4032 1662 conicto
-4032 2118 3761 2375 conicto
-3490 2632 2871 2760 conicto
-2376 2859 lineto
-1426 3047 1001 3447 conicto
-576 3847 576 4560 conicto
-576 5385 1152 5860 conicto
-1728 6336 2740 6336 conicto
-3173 6336 3623 6256 conicto
-4073 6176 4544 6016 conicto
-end_ol grestore
-gsave -9.972752 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-1536 6016 moveto
-1536 4672 lineto
-3136 4672 lineto
-3136 4096 lineto
-1536 4096 lineto
-1536 1543 lineto
-1536 968 1694 804 conicto
-1853 640 2338 640 conicto
-3136 640 lineto
-3136 0 lineto
-2338 0 lineto
-1446 0 1107 332 conicto
-768 665 768 1543 conicto
-768 4096 lineto
-192 4096 lineto
-192 4672 lineto
-768 4672 lineto
-768 6016 lineto
-1536 6016 lineto
-end_ol grestore
-gsave -9.530667 20.850000 translate 0.035278 -0.035278 scale
+1780 4390 2172 4595 conicto
+2564 4800 3124 4800 conicto
+3204 4800 3301 4784 conicto
+3398 4768 3516 4736 conicto
+3520 3968 lineto
+end_ol grestore
+gsave 19.708375 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+2912 5383 moveto
+1771 2304 lineto
+4057 2304 lineto
+2912 5383 lineto
+2437 6208 moveto
+3391 6208 lineto
+5760 0 lineto
+4886 0 lineto
+4319 1600 lineto
+1517 1600 lineto
+951 0 lineto
+64 0 lineto
+2437 6208 lineto
+end_ol grestore
+gsave 20.460172 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+3840 3968 moveto
+3840 6464 lineto
+4608 6464 lineto
+4608 0 lineto
+3840 0 lineto
+3840 704 lineto
+3599 282 3231 77 conicto
+2864 -128 2350 -128 conicto
+1507 -128 977 551 conicto
+448 1230 448 2336 conicto
+448 3442 977 4121 conicto
+1507 4800 2350 4800 conicto
+2864 4800 3231 4595 conicto
+3599 4390 3840 3968 conicto
+1280 2336 moveto
+1280 1483 1621 997 conicto
+1962 512 2558 512 conicto
+3154 512 3497 997 conicto
+3840 1483 3840 2336 conicto
+3840 3189 3497 3674 conicto
+3154 4160 2558 4160 conicto
+1962 4160 1621 3674 conicto
+1280 3189 1280 2336 conicto
+end_ol grestore
+gsave 21.176994 36.450000 translate 0.035278 -0.035278 scale
start_ol
2834 2368 moveto
1921 2368 1568 2152 conicto
@@ -1252,7 +1358,33 @@
3356 4800 3854 4272 conicto
4352 3744 4352 2672 conicto
end_ol grestore
-gsave -8.838814 20.850000 translate 0.035278 -0.035278 scale
+gsave 21.868847 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+1536 704 moveto
+1536 -1792 lineto
+768 -1792 lineto
+768 4672 lineto
+1536 4672 lineto
+1536 3968 lineto
+1777 4390 2144 4595 conicto
+2512 4800 3022 4800 conicto
+3869 4800 4398 4121 conicto
+4928 3442 4928 2336 conicto
+4928 1230 4398 551 conicto
+3869 -128 3022 -128 conicto
+2512 -128 2144 77 conicto
+1777 282 1536 704 conicto
+4096 2336 moveto
+4096 3189 3754 3674 conicto
+3413 4160 2816 4160 conicto
+2219 4160 1877 3674 conicto
+1536 3189 1536 2336 conicto
+1536 1483 1877 997 conicto
+2219 512 2816 512 conicto
+3413 512 3754 997 conicto
+4096 1483 4096 2336 conicto
+end_ol grestore
+gsave 22.585669 36.450000 translate 0.035278 -0.035278 scale
start_ol
1536 6016 moveto
1536 4672 lineto
@@ -1274,7 +1406,7 @@
768 6016 lineto
1536 6016 lineto
end_ol grestore
-gsave -8.396729 20.850000 translate 0.035278 -0.035278 scale
+gsave 23.027755 36.450000 translate 0.035278 -0.035278 scale
start_ol
4736 2536 moveto
4736 2176 lineto
@@ -1299,74 +1431,23 @@
1361 3420 1304 2748 conicto
3968 2752 lineto
end_ol grestore
-gsave -7.702379 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-5440 5760 moveto
-5440 4864 lineto
-5018 5250 4541 5441 conicto
-4064 5632 3526 5632 conicto
-2468 5632 1906 4982 conicto
-1344 4332 1344 3102 conicto
-1344 1876 1906 1226 conicto
-2468 576 3526 576 conicto
-4064 576 4541 767 conicto
-5018 958 5440 1344 conicto
-5440 448 lineto
-5001 160 4509 16 conicto
-4018 -128 3471 -128 conicto
-2065 -128 1256 738 conicto
-448 1604 448 3102 conicto
-448 4604 1256 5470 conicto
-2065 6336 3471 6336 conicto
-4026 6336 4517 6192 conicto
-5009 6048 5440 5760 conicto
-end_ol grestore
-gsave -6.915616 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-768 1834 moveto
+gsave 23.722104 36.450000 translate 0.035278 -0.035278 scale
+start_ol
+3520 3968 moveto
+3389 4034 3235 4065 conicto
+3082 4096 2897 4096 conicto
+2239 4096 1887 3677 conicto
+1536 3259 1536 2475 conicto
+1536 0 lineto
+768 0 lineto
768 4672 lineto
1536 4672 lineto
-1536 1863 lineto
-1536 1188 1793 850 conicto
-2051 512 2566 512 conicto
-3185 512 3544 915 conicto
-3904 1318 3904 2014 conicto
-3904 4672 lineto
-4672 4672 lineto
-4672 0 lineto
-3904 0 lineto
-3904 704 lineto
-3625 282 3257 77 conicto
-2889 -128 2403 -128 conicto
-1600 -128 1184 372 conicto
-768 872 768 1834 conicto
-2695 4800 moveto
-2695 4800 lineto
-end_ol grestore
-gsave -6.201291 20.850000 translate 0.035278 -0.035278 scale
-start_ol
-4736 2536 moveto
-4736 2176 lineto
-1280 2176 lineto
-1329 1363 1745 937 conicto
-2162 512 2906 512 conicto
-3337 512 3741 624 conicto
-4146 736 4544 960 conicto
-4544 256 lineto
-4136 68 3708 -30 conicto
-3280 -128 2840 -128 conicto
-1736 -128 1092 525 conicto
-448 1179 448 2294 conicto
-448 3446 1061 4123 conicto
-1675 4800 2716 4800 conicto
-3650 4800 4193 4191 conicto
-4736 3582 4736 2536 conicto
-3968 2752 moveto
-3960 3394 3625 3777 conicto
-3290 4160 2738 4160 conicto
-2112 4160 1736 3790 conicto
-1361 3420 1304 2748 conicto
-3968 2752 lineto
+1536 3968 lineto
+1780 4390 2172 4595 conicto
+2564 4800 3124 4800 conicto
+3204 4800 3301 4784 conicto
+3398 4768 3516 4736 conicto
+3520 3968 lineto
end_ol grestore
0.100000 slw
[] 0 sd
@@ -1777,16 +1858,6 @@
n 17.681900 37.486103 m 17.931900 37.986103 l 17.681900 37.861103 l 17.431900 37.986103 l ef
n 17.681900 37.486103 m 17.931900 37.986103 l 17.681900 37.861103 l 17.431900 37.986103 l cp s
0.100000 slw
-[] 0 sd
-[] 0 sd
-0 slc
-n -3.449900 20.500000 m 6.400997 20.500000 l s
-[] 0 sd
-0 slj
-0 slc
-n 6.775997 20.500000 m 6.275997 20.750000 l 6.400997 20.500000 l 6.275997 20.250000 l ef
-n 6.775997 20.500000 m 6.275997 20.750000 l 6.400997 20.500000 l 6.275997 20.250000 l cp s
-0.100000 slw
[1.000000] 0 sd
[1.000000] 0 sd
0 slj
@@ -1803,12 +1874,12 @@
[0.200000] 0 sd
0 slj
0 slc
-n 8.687500 36.125000 m -9.524900 36.125000 l -9.524900 22.336803 l s
+n 4.600100 36.125000 m -5.049900 36.125000 l -5.049900 20.500000 l 6.400997 20.500000 l s
[] 0 sd
0 slj
0 slc
-n -9.524900 21.961803 m -9.274900 22.461803 l -9.524900 22.336803 l -9.774900 22.461803 l ef
-n -9.524900 21.961803 m -9.274900 22.461803 l -9.524900 22.336803 l -9.774900 22.461803 l cp s
+n 6.775997 20.500000 m 6.275997 20.750000 l 6.400997 20.500000 l 6.275997 20.250000 l ef
+n 6.775997 20.500000 m 6.275997 20.750000 l 6.400997 20.500000 l 6.275997 20.250000 l cp s
gsave 3.300200 7.962500 translate 0.035278 -0.035278 scale
start_ol
-64 3520 moveto
@@ -6932,6 +7003,250 @@
end_ol grestore
gsave -1.377709 35.650000 translate 0.035278 -0.035278 scale
start_ol
+2688 1646 moveto
+2688 0 lineto
+2240 0 lineto
+2240 1632 lineto
+2240 2001 2093 2184 conicto
+1947 2368 1654 2368 conicto
+1302 2368 1099 2146 conicto
+896 1925 896 1542 conicto
+896 0 lineto
+448 0 lineto
+448 2688 lineto
+896 2688 lineto
+896 2304 lineto
+1053 2529 1266 2640 conicto
+1479 2752 1757 2752 conicto
+2217 2752 2452 2471 conicto
+2688 2191 2688 1646 conicto
+end_ol grestore
+gsave -0.973095 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+448 3712 moveto
+896 3712 lineto
+896 1529 lineto
+2196 2688 lineto
+2752 2688 lineto
+1346 1430 lineto
+2816 0 lineto
+2246 0 lineto
+896 1313 lineto
+896 0 lineto
+448 0 lineto
+448 3712 lineto
+end_ol grestore
+gsave -0.603447 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+end_ol grestore
+gsave -0.401140 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+2624 3392 moveto
+2624 2944 lineto
+2352 3073 2111 3136 conicto
+1870 3200 1645 3200 conicto
+1255 3200 1043 3052 conicto
+832 2904 832 2631 conicto
+832 2402 969 2285 conicto
+1107 2169 1491 2097 conicto
+1773 2039 lineto
+2308 1937 2562 1678 conicto
+2816 1420 2816 986 conicto
+2816 469 2468 202 conicto
+2121 -64 1450 -64 conicto
+1197 -64 911 0 conicto
+626 65 320 192 conicto
+320 704 lineto
+613 513 893 416 conicto
+1174 320 1445 320 conicto
+1857 320 2080 485 conicto
+2304 650 2304 955 conicto
+2304 1221 2148 1371 conicto
+1992 1522 1636 1597 conicto
+1352 1652 lineto
+807 1756 563 1978 conicto
+320 2201 320 2597 conicto
+320 3056 654 3320 conicto
+989 3584 1576 3584 conicto
+1828 3584 2089 3536 conicto
+2351 3488 2624 3392 conicto
+end_ol grestore
+gsave 0.005980 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+896 3456 moveto
+896 2688 lineto
+1792 2688 lineto
+1792 2368 lineto
+896 2368 lineto
+896 902 lineto
+896 572 984 478 conicto
+1073 384 1345 384 conicto
+1792 384 lineto
+1792 0 lineto
+1345 0 lineto
+836 0 642 194 conicto
+448 389 448 902 conicto
+448 2368 lineto
+128 2368 lineto
+128 2688 lineto
+448 2688 lineto
+448 3456 lineto
+896 3456 lineto
+end_ol grestore
+gsave 0.255746 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+1622 1344 moveto
+1104 1344 904 1225 conicto
+704 1106 704 818 conicto
+704 589 854 454 conicto
+1004 320 1262 320 conicto
+1618 320 1833 572 conicto
+2048 825 2048 1244 conicto
+2048 1344 lineto
+1622 1344 lineto
+2496 1513 moveto
+2496 0 lineto
+2048 0 lineto
+2048 384 lineto
+1900 154 1679 45 conicto
+1458 -64 1138 -64 conicto
+733 -64 494 162 conicto
+256 389 256 769 conicto
+256 1213 555 1438 conicto
+854 1664 1448 1664 conicto
+2048 1664 lineto
+2048 1712 lineto
+2048 2025 1851 2196 conicto
+1655 2368 1300 2368 conicto
+1074 2368 860 2320 conicto
+646 2272 448 2176 conicto
+448 2560 lineto
+687 2656 912 2704 conicto
+1138 2752 1351 2752 conicto
+1927 2752 2211 2444 conicto
+2496 2137 2496 1513 conicto
+end_ol grestore
+gsave 0.647875 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+896 3456 moveto
+896 2688 lineto
+1792 2688 lineto
+1792 2368 lineto
+896 2368 lineto
+896 902 lineto
+896 572 984 478 conicto
+1073 384 1345 384 conicto
+1792 384 lineto
+1792 0 lineto
+1345 0 lineto
+836 0 642 194 conicto
+448 389 448 902 conicto
+448 2368 lineto
+128 2368 lineto
+128 2688 lineto
+448 2688 lineto
+448 3456 lineto
+896 3456 lineto
+end_ol grestore
+gsave 0.897642 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+2752 1480 moveto
+2752 1280 lineto
+704 1280 lineto
+733 811 978 565 conicto
+1223 320 1660 320 conicto
+1914 320 2152 384 conicto
+2390 448 2624 576 conicto
+2624 192 lineto
+2388 67 2140 1 conicto
+1893 -64 1639 -64 conicto
+1001 -64 628 309 conicto
+256 683 256 1320 conicto
+256 1979 613 2365 conicto
+970 2752 1576 2752 conicto
+2120 2752 2436 2410 conicto
+2752 2068 2752 1480 conicto
+2304 1600 moveto
+2299 1950 2099 2159 conicto
+1900 2368 1572 2368 conicto
+1200 2368 976 2166 conicto
+753 1964 719 1597 conicto
+2304 1600 lineto
+end_ol grestore
+gsave 1.292268 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+end_ol grestore
+gsave 1.494575 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+3136 3264 moveto
+3136 2752 lineto
+2892 2977 2616 3088 conicto
+2340 3200 2030 3200 conicto
+1418 3200 1093 2829 conicto
+768 2459 768 1759 conicto
+768 1061 1093 690 conicto
+1418 320 2030 320 conicto
+2340 320 2616 431 conicto
+2892 543 3136 768 conicto
+3136 256 lineto
+2882 96 2599 16 conicto
+2316 -64 2000 -64 conicto
+1189 -64 722 424 conicto
+256 913 256 1759 conicto
+256 2607 722 3095 conicto
+1189 3584 2000 3584 conicto
+2320 3584 2603 3504 conicto
+2887 3424 3136 3264 conicto
+end_ol grestore
+gsave 1.941655 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+448 1040 moveto
+448 2688 lineto
+896 2688 lineto
+896 1057 lineto
+896 689 1042 504 conicto
+1188 320 1481 320 conicto
+1832 320 2036 541 conicto
+2240 763 2240 1145 conicto
+2240 2688 lineto
+2688 2688 lineto
+2688 0 lineto
+2240 0 lineto
+2240 384 lineto
+2081 157 1870 46 conicto
+1660 -64 1382 -64 conicto
+923 -64 685 217 conicto
+448 499 448 1040 conicto
+1554 2752 moveto
+1554 2752 lineto
+end_ol grestore
+gsave 2.346269 35.650000 translate 0.035278 -0.035278 scale
+start_ol
+2752 1480 moveto
+2752 1280 lineto
+704 1280 lineto
+733 811 978 565 conicto
+1223 320 1660 320 conicto
+1914 320 2152 384 conicto
+2390 448 2624 576 conicto
+2624 192 lineto
+2388 67 2140 1 conicto
+1893 -64 1639 -64 conicto
+1001 -64 628 309 conicto
+256 683 256 1320 conicto
+256 1979 613 2365 conicto
+970 2752 1576 2752 conicto
+2120 2752 2436 2410 conicto
+2752 2068 2752 1480 conicto
+2304 1600 moveto
+2299 1950 2099 2159 conicto
+1900 2368 1572 2368 conicto
+1200 2368 976 2166 conicto
+753 1964 719 1597 conicto
+2304 1600 lineto
+end_ol grestore
+gsave 2.740895 35.650000 translate 0.035278 -0.035278 scale
+start_ol
2112 2560 moveto
2112 2176 lineto
1932 2272 1738 2320 conicto
@@ -6962,116 +7277,6 @@
1509 2752 1721 2704 conicto
1933 2656 2112 2560 conicto
end_ol grestore
-gsave -1.045524 35.650000 translate 0.035278 -0.035278 scale
-start_ol
-896 3456 moveto
-896 2688 lineto
-1792 2688 lineto
-1792 2368 lineto
-896 2368 lineto
-896 902 lineto
-896 572 984 478 conicto
-1073 384 1345 384 conicto
-1792 384 lineto
-1792 0 lineto
-1345 0 lineto
-836 0 642 194 conicto
-448 389 448 902 conicto
-448 2368 lineto
-128 2368 lineto
-128 2688 lineto
-448 2688 lineto
-448 3456 lineto
-896 3456 lineto
-end_ol grestore
-gsave -0.795758 35.650000 translate 0.035278 -0.035278 scale
-start_ol
-2752 1480 moveto
-2752 1280 lineto
-704 1280 lineto
-733 811 978 565 conicto
-1223 320 1660 320 conicto
-1914 320 2152 384 conicto
-2390 448 2624 576 conicto
-2624 192 lineto
-2388 67 2140 1 conicto
-1893 -64 1639 -64 conicto
-1001 -64 628 309 conicto
-256 683 256 1320 conicto
-256 1979 613 2365 conicto
-970 2752 1576 2752 conicto
-2120 2752 2436 2410 conicto
-2752 2068 2752 1480 conicto
-2304 1600 moveto
-2299 1950 2099 2159 conicto
-1900 2368 1572 2368 conicto
-1200 2368 976 2166 conicto
-753 1964 719 1597 conicto
-2304 1600 lineto
-end_ol grestore
-gsave -0.401132 35.650000 translate 0.035278 -0.035278 scale
-start_ol
-2688 1646 moveto
-2688 0 lineto
-2240 0 lineto
-2240 1632 lineto
-2240 2001 2093 2184 conicto
-1947 2368 1654 2368 conicto
-1302 2368 1099 2146 conicto
-896 1925 896 1542 conicto
-896 0 lineto
-448 0 lineto
-448 2688 lineto
-896 2688 lineto
-896 2304 lineto
-1053 2529 1266 2640 conicto
-1479 2752 1757 2752 conicto
-2217 2752 2452 2471 conicto
-2688 2191 2688 1646 conicto
-end_ol grestore
-gsave 0.003483 35.650000 translate 0.035278 -0.035278 scale
-start_ol
-2752 1480 moveto
-2752 1280 lineto
-704 1280 lineto
-733 811 978 565 conicto
-1223 320 1660 320 conicto
-1914 320 2152 384 conicto
-2390 448 2624 576 conicto
-2624 192 lineto
-2388 67 2140 1 conicto
-1893 -64 1639 -64 conicto
-1001 -64 628 309 conicto
-256 683 256 1320 conicto
-256 1979 613 2365 conicto
-970 2752 1576 2752 conicto
-2120 2752 2436 2410 conicto
-2752 2068 2752 1480 conicto
-2304 1600 moveto
-2299 1950 2099 2159 conicto
-1900 2368 1572 2368 conicto
-1200 2368 976 2166 conicto
-753 1964 719 1597 conicto
-2304 1600 lineto
-end_ol grestore
-gsave 0.398109 35.650000 translate 0.035278 -0.035278 scale
-start_ol
-1984 2304 moveto
-1912 2337 1828 2352 conicto
-1744 2368 1642 2368 conicto
-1282 2368 1089 2127 conicto
-896 1887 896 1437 conicto
-896 0 lineto
-448 0 lineto
-448 2688 lineto
-896 2688 lineto
-896 2304 lineto
-1030 2531 1245 2641 conicto
-1460 2752 1767 2752 conicto
-1811 2752 1864 2752 conicto
-1917 2752 1982 2752 conicto
-1984 2304 lineto
-end_ol grestore
gsave 1.237800 20.150000 translate 0.035278 -0.035278 scale
start_ol
448 3520 moveto
--- a/src/ltp-protocol/doc/ltp-protocol.rst Mon Aug 11 01:28:34 2014 +0200
+++ b/src/ltp-protocol/doc/ltp-protocol.rst Mon Aug 11 12:48:44 2014 +0200
@@ -1,29 +1,19 @@
LTP Protocol
----------------------------
-This model implements the base specification of Licklider Transmission Protocol (LTP). The
+This model implements the base specification of Licklider Transmission Protocol (LTP). The
implementation is based on [rfc5325]_[rfc5326]_.
-.. include:: replace.txt
-.. highlight:: cpp
-
-.. heading hierarchy:
- ------------- Chapter
- ************* Section (#.#)
- ============= Subsection (#.#.#)
- ############# Paragraph (no number)
-
-
Model Description
-=====================
+******************
The source code for the new module lives in the directory ``src/ltp-protocol``.
-The Licklider Transmission Protocol (LTP) is a tranport protocol designed to
+The Licklider Transmission Protocol (LTP) is a transport protocol designed to
provide retransmission-based reliability over links with extremely long message round-trip times
-and frequent disconnections. This is achieved through Automatic Repeat reQuest (ARQ) of data
-transmissions by soliciting selective-acknowledgment reception reports. LTP is intended to serve as a reliable
-"convergence layer" protocol, underlying the Bundle protocol [BP], and single-hop deep-space radio frequency (RF) links.
+and frequent disconnections. This is achieved through Automatic Repeat reQuest (ARQ) of data
+transmissions by soliciting selective-acknowledgment reception reports. LTP is intended to serve as a reliable
+"convergence layer" protocol, underlying the Bundle protocol [BP], and single-hop deep-space radio frequency (RF) links.
Terminology
============
@@ -49,28 +39,37 @@
The area inside the box represents the main classes of LTP in |ns3|.
-* Class ``ns3::LtpProtocol`` implements several LTP APIs to Client Service Instance, such as
- RegisterClientService (), UnregisterClientService (), StartTransmission () and CancelTransmission().
- Client Service Instance can use these APIs to register within the LTP for reception
+* Class ``ns3::ltp::LtpProtocol`` implements several LTP APIs to Client Service Instance, such as
+ RegisterClientService (), UnregisterClientService (), StartTransmission () and CancelTransmission().
+ Client Service Instance can use these APIs to register within the LTP for reception
and transmission of Blocks between LTP engines.
-* Class ``ns3::LtpSessionStateRecord`` is a class to keep track of the state of an LTP transmission session,
+* Class ``ns3::ltp::LtpSessionStateRecord`` is a class to keep track of the state of an LTP transmission session,
this class is basically a wrapper that handles several flags, counters, timers and lists. This is a base
class that contains member variables common in both a sender and receiver session, two more specific classes
- extend this: SenderSessionStateRecord and ReceiverSessionStateRecord.
+ extend this: ``ns3::ltp::SenderSessionStateRecord`` and ``ns3::ltp::ReceiverSessionStateRecord``.
-* Class ``ns3::LtpQueueSet`` a class that contains the dual queue structure (internal operations and application data) used for LTP
+* Class ``ns3::ltp::LtpQueueSet`` is a class that contains the dual queue structure (internal operations and application data) used for LTP
outbound traffic.
-* Class ``ns3::LtpDatalink`` this is a convergence layer with the lower layer datalink.
+* Class ``ns3::ltp::LtpIpResolutionTable`` is a class responsible for resolution of Ltp engine Ids to Internet addresses, supporting both
+Ipv4 and Ipv6 formats. It provides a public API for managing bindings and perform conversions.
-In addition to the classes used in the protocol core structure, the [ns3] LTP also includes:
+* Class ``ns3::ltp::LtpConvergenceLayerAdapter`` abstract base class that defines the APIs for convergence layers between lower layer
+datalinks and the LTP protocol.
-* Class ``ns3::LtpHeader`` implements the primary LTP segment header common for all types of segments.
+* Class ``ns3::ltp::LtpUdpConvergenceLayerAdapter`` this is the default convergence layer used in the [ns3] LTP protocol implementation. This class defines a
+convergence layer adapter between LTP and UDP. This class is responsible for the following operations: mapping LTP generated segments
+into UDP socket send() operations, mapping received UDP segments to the LTP receiver, opening a port on the IANA-assigned listening
+port 1113, providing the LTP a way to determine the MTU to avoid fragmentation.
-* Class ``ns3::LtpTrailer`` implements the LTP segment trailer, this is primarily used for extensions.
+In addition to the classes used in the protocol core structures, the [ns3] LTP also includes several packet header and trailer structures:
+
+* Class ``ns3::ltp::LtpHeader`` implements the primary LTP segment header common for all types of segments.
-* Class ``ns3::LtpContentHeader`` implements the LTP segment content header with specific field for each type of segment.
+* Class ``ns3::ltp::LtpTrailer`` implements the LTP segment trailer, this is primarily used for extensions.
+
+* Class ``ns3::ltp::LtpContentHeader`` implements the LTP segment content header with specific field for each type of segment.
Several other classes representing internal data structures (SessionIDs, LtpConfigParameters, etc. ) are also included
but they are not described here due to their low relevance.
@@ -78,75 +77,201 @@
Scope and Limitations
=====================
-What can the model do? What can it not do? Please use this section to
-describe the scope and limitations of the model.
+The current ltp protocol |ns3| implementation supports the following features:
-The LTP model DOES NOT support the following functions:
+* Basic data transmission between two nodes.
+* Retransmission based reliability.
+* Notices to client service instance.
+* Udp Convergence layer adapter with link state cue support.
+* Static Ltp engine id to IP address conversion.
+* All types of Ltp Headers and Content Headers.
+* Self-Delimiting Numeric Values (SDNV) support in headers [rfc6250];
-* LTP security extensions .. [rfc5327]
-
+The LTP model DOES NOT support the following features:
-Usage
-==========
+* Asynchronous checkpoints.
+* Cancellation Requests.
+* LTP security extensions .. [rfc5327]
+* LTP authentication extensions .. [rfc5327]
+* Handle System Error conditions.
+* Management Information Base, containing times of operation of remote ltp engines.
+
+The current implementation has the following limitations:
-LTP APIs
-********
+* Only supports one concurrent transmission session per destination.
+* Only a single timer of each type can be run concurrently in a single session (only a checkpoint or report can be handled at the same time).
+* Segment reception offsets are assumed to be ordered.
+* Upon loss of a red data segment, the whole red part is retransmitted, not just the specific segment.
+* Checkpoint and Red Data Segment retransmission are handled together.
-The LTP offers several APIs:
+Future developments (ordered by priority):
+
+* Allow specific segment retransmission.
+* Handle CP and Data retransmission independently.
+* Allow reception of unordered data.
+* Add Cancellation request support.
+* Add support for multiple timers running simultaneously and asynchronous checkpoint support.
-1. RegisterClientService(): method ``ns3::LtpProtocol::RegisterClientService ()`` registers a Client Service Instance into
+APIs
+*****
+
+The most relevant API provided in this model are:
+
+Ltp Protocol
+============
+
+The ``ns3::ltp::LtpProtocol``
+
+1. RegisterClientService(): method ``ns3::ltp::LtpProtocol::RegisterClientService ()`` registers a Client Service Instance into
the ``ns3::LtpProtocol``. This method should always be the first method to call before using the other methods (StartTransmission).
- In the case of receivers, clients must always register so they can be valid destinations for the LTP engine to deliver received data.
+ In the case of receivers, clients must always register so they can be valid destinations for the LTP engine to deliver received data,
+ This function takes a callback as one of its parameters, this callback is used to connect to a TraceSource that notifies session status
+ changes to the registered client service.
-2. UnregisterClientService(): method ``ns3::LtpProtocol::UnregisterClientService ()`` removes the registered Client Service
+2. UnregisterClientService(): method ``ns3::ltp::LtpProtocol::UnregisterClientService ()`` removes the registered Client Service
so it can no longer use the LTP services.
-3. StartTransmission(): method ``ns3::LtpProtocol::StartTransmission ()`` requests the transmission of a block of client service data.
+3. StartTransmission(): method ``ns3::ltp::LtpProtocol::StartTransmission ()`` requests the transmission of a block of client service data.
This method creates a new transmission session, unically identified by a session ID, and session state record to keep track
-of the session status. If the block is bigger than the MTU of the lower datalink layer, the block is split into several segments and
-queued for transmissionninto the LtpQueueSet of the corresponding session state record.
+of the session status. If the block is bigger than the MTU of the lower datalink layer, the block is split into several segments and
+queued for transmission into the LtpQueueSet of the corresponding session state record.
4. CancelTransmission(): method ``ns3::LtpProtocol::CancelTransmission ()`` cancels the transmission session and notifies the remote
LTP peer, starting the LTP cancellation procedure and freeing resources afterwards.
+Ltp to Ip resolution table
+==========================
-Helpers
-=======
+The `ns3::ltp::LtpIpResolutionTable`` class offers several public APIs:
+
+1. AddBinding(): ``ns3::ltp::LtpIpResolutionTable::AddBinding ()`` method adds a binding between Ip Address and a LTP Engine,
+there are multiple versions allowing both ipv4 and ipv6.
+
+2. RemoveBinding(): ``ns3::ltp::LtpIpResolutionTable::RemoveBinding ()`` method removes a binding between Ip Address and a LTP Engine,
+there are multiple versions allowing both ipv4 and ipv6.
+
+3. GetRoute(): ``ns3::ltp::LtpIpResolutionTable::GetRoute (uint64_t ltpEngineId)`` acquire the corresponding Ip ddress binded to a LTP
+engine id. If there are multiple bindings, internal flag m_adddressMode controls whether the IPv4 or Ipv6 binding map is searched first,
+the first entry that matches the requested EngineId will be used.
+
+4. PrintRoute(): ``ns3::ltp::LtpIpResolutionTable::GetRoute (uint64_t ltpEngineId)`` prints bindings.
+
+Convergence Layer Adapter
+=========================
-What helper API will users typically use? Describe it here.
+The ``ns3::ltp::LtpConvergenceLayerAdapter`` is an abstract base class that offers several
+functions that must be implemented by specific convergence layer adapter classes, the main
+methods defined are:
+
+1. Send(): ``ns3::ltp::LtpConvergenceLayerAdapter::Send()`` method to send a packet using the underlying layer.
+
+2. Receive(): ``ns3::ltp::LtpConvergenceLayerAdapter::Send()`` method to receive a packet from the underlying layer.
+
+3. GetMtu(): ``ns3::ltp::LtpConvergenceLayerAdapter::GetMtu()`` Get the maximum transmission unit (MTU) associated with this destination Engine ID. This is implemented by resolving the
+Engine ID to an IP address, then opening a connected UDP socket to the destination IP address and checking it for its MTU.
+
+Link State Cues are implemented as callbacks, the API provides several functions to set them:
+
+* SetLinkUpCallback ();
+* SetLinkDownCallback ();
+* SetCheckPointSentCallback ();
+* SetReportSentCallback ();
+* SetEndOfBlockSentCallback ();
+* SetCancellationCallback ();
+
Attributes
-==========
+***********
+
+LtpProtocol most relevant attributes:
-What classes hold attributes, and what are the key ones worth mentioning?
+* "LocalEngineId" : Defines the engine id used by this object.
+* "CheckPointRtxLimit": Defines the maximum number of checkpoint retransmissions allowed per session.
+* "ReportSegmentRtxLimit": Defines the maximum number of report retransmissions allowed per session.
+* "LocalProcessingDelays": Define the interval of time required for processing operations (queueing/dequeing).
+* "OneWayLightTime": Defines the time required for transmitted data to reach the destination.
+
+LtpConvergenceLayerAdapter most relevant attribute:
+
+* "RemotePeer" : Defines the ltp engine id of the remote peer to which this CLA links.
+
+LtpIpResolutionTable most relevant attribute:
-Output
-======
+* "Addressing" : flag that defines whether ipv4 or ipv6 is used.
+
+Helpers
+*******
+
+A ``LtpProtocolHelper`` object is used to setup simulations and configure the
+various components. This class helps create Ltp Protocol objects
+and configures their attributes according to a preset configuration.
-What kind of data does the model generate? What are the key trace
-sources? What kind of logging output can be enabled?
+It provides two main methods:
+
+1. Install (NodeContainer): This method creates ltp objects and install them on the nodes
+of the node container.
+
+2. InstallAndLink (NodeContainer): This method creates ltp objects and install them on
+nodes, but it additionally creates links between the nodes and the correspondent
+convergence layer adapters.
Examples
-========
+********
+
+An example script in ``src/ltp-protocol/examples`` is provided to show the usage of the ltp protocol helper
+to set up a network topology.
-What examples using this new code are available? Describe them here.
+The example defines a two node scenario, a data transmission using ltp protocol, and two functions acting
+as client service instances which receive status notifications.
+
+Output
+******
-Troubleshooting
-===============
+Trace Sources are provided in the form of Client Service Notice. The callback
+is implicitly set up when a client service instance is registered using the
+``ns3::ltp::LtpProtocol::RegisterClientService ()``, this trace source
+provides session status notification changes and provides the following parameters:
-Add any tips for avoiding pitfalls, etc.
+ * Session Id which originated the notification.
+ * StatusNotificationCode reason for this notification.
+ * Data in the case in which data reception is reported.
+ * Data length.
+ * Source Ltp Engine: the ltp engine id of the data source.
+ * Offset of this data within a whole block of data.
+
+Several debug level logging output can be enabled to observe the type and contents
+of received segments during the transmission session.
+
+NS_LOG_FUNCTION() is also available for debugging purposes.
+
Validation
**********
-Describe how the model has been tested/validated. What tests run in the
-test suite? How much API and code is covered by the tests? Again,
-references to outside published work may help here.
+The model provides two main test-suites:
+
+- ltp-protocol: This test suite contains unit tests for the auxiliary data structures of the protocol.
+Each test creates objects assigning different values and uses its functions with extensive combinations and use cases.
+The following classes are tested in this suite:
+
+* SessionId
+* LtpHeader
+* LtpTrailer
+* LtpContentHeader
+* LtpQueueSet
+* SessionStateRecord,
+* LtpProtocol public API.
+
+- ltp-channel-loss: This test-suite builds a network topology and uses the protocol to transmit
+data, while forces data corruption using an ErrorModel. The different test-cases check the
+retransmission capabilities of the protocol by providing different patterns for these
+data-losses.
References
-==========
+**********
.. [rfc5325] S. Burleigh, M. Ramadas, S. Farrell, "Licklider Transmission Protocol - Motivation" RFC 5326, Sept. 2008
.. [rfc5326] M. Ramadas, S. Burleigh, S. Farrell, "Licklider Transmission Protocol - Specification" RFC 5326, Sept. 2008
.. [rfc5327] S. Farrell, M. Ramadas, S. Burleigh, "Licklider Transmission Protocol - Security Extensions" RFC 5327, Sept. 2008
+
--- a/src/ltp-protocol/helper/ltp-protocol-helper.cc Mon Aug 11 01:28:34 2014 +0200
+++ b/src/ltp-protocol/helper/ltp-protocol-helper.cc Mon Aug 11 12:48:44 2014 +0200
@@ -222,7 +222,7 @@
m_ltpid = id;
}
-void SetLtpEngineId (Ptr<Node> node, uint64_t id)
+void LtpProtocolHelper::SetLtpEngineId (Ptr<Node> node, uint64_t id)
{
NS_LOG_FUNCTION (this << node << id);
Ptr<LtpProtocol> ltpProtocol = node->GetObject<LtpProtocol> ();
--- a/src/ltp-protocol/model/ltp-convergence-layer-adapter.h Mon Aug 11 01:28:34 2014 +0200
+++ b/src/ltp-protocol/model/ltp-convergence-layer-adapter.h Mon Aug 11 12:48:44 2014 +0200
@@ -22,6 +22,7 @@
#define LTP_CONVERGENCE_LAYER_ADAPTER_H_
#include "ns3/object.h"
+#include "ns3/socket.h"
#include "ltp-header.h"
#include "ltp-session-state-record.h"
@@ -34,6 +35,7 @@
class LtpIpResolutionTable;
class SessionId;
+
/**
* \ingroup dtn
*
@@ -63,6 +65,11 @@
*/
virtual uint32_t Send (Ptr<Packet> p) = 0;
+ /* \brief Receive a data packet from the lower layer.
+ * \return 0 if there are no available datagrams to deliver
+ */
+ virtual void Receive (Ptr<Socket> socket) = 0;
+
/**
* Get the maximum transmission unit (MTU) associated with this
* destination Engine ID.
--- a/src/ltp-protocol/model/ltp-protocol.h Mon Aug 11 01:28:34 2014 +0200
+++ b/src/ltp-protocol/model/ltp-protocol.h Mon Aug 11 12:48:44 2014 +0200
@@ -207,25 +207,6 @@
*/
void CancelSession (SessionId id);
- /*
- * \brief Closes a session and frees resources.
- * \param id Session Id of the session to close.
- */
- void CloseSession (SessionId id);
-
- /*
- * \brief Signals the reception of the full red part.
- * \param id Session id.
- */
- void SignifyRedPartReception (SessionId id);
-
- /*
- * \brief Signals the reception of a green segment.
- * \param id Session id.
- */
- void SignifyGreenPartSegmentArrival (SessionId id);
-
-
/* Engines Interaction */
/*
@@ -314,16 +295,35 @@
private:
-/*
- * \brief Given a destination and a block of data, splits the block
- * into N segments of mtu size and enqeueues them for transmission
- * into the outbound transmission queue of the provided session state record.
- * \param dstClientService Destination client service id.
- * \param ssr session state record into which enqueue segments.
- * \param data Block of client service data to transmit
- * \param rdSize Size of red part (data that needs to be sent in a reliable manner).
- * \param rtx called for a retransmission ( this flags is used internally).
- */
+
+ /*
+ * \brief Closes a session and frees resources.
+ * \param id Session Id of the session to close.
+ */
+ void CloseSession (SessionId id);
+
+ /*
+ * \brief Signals the reception of the full red part.
+ * \param id Session id.
+ */
+ void SignifyRedPartReception (SessionId id);
+
+ /*
+ * \brief Signals the reception of a green segment.
+ * \param id Session id.
+ */
+ void SignifyGreenPartSegmentArrival (SessionId id);
+
+ /*
+ * \brief Given a destination and a block of data, splits the block
+ * into N segments of mtu size and enqeueues them for transmission
+ * into the outbound transmission queue of the provided session state record.
+ * \param dstClientService Destination client service id.
+ * \param ssr session state record into which enqueue segments.
+ * \param data Block of client service data to transmit
+ * \param rdSize Size of red part (data that needs to be sent in a reliable manner).
+ * \param rtx called for a retransmission ( this flags is used internally).
+ */
void EncapsulateBlockData (uint64_t dstClientService, Ptr<SessionStateRecord> ssr, std::vector<uint8_t> data, uint64_t rdSize, bool rtx = false);
/*
--- a/src/ltp-protocol/model/ltp-udp-convergence-layer-adapter.cc Mon Aug 11 01:28:34 2014 +0200
+++ b/src/ltp-protocol/model/ltp-udp-convergence-layer-adapter.cc Mon Aug 11 12:48:44 2014 +0200
@@ -69,10 +69,10 @@
m_rcvSocket6 = Socket::CreateSocket (m_ltp->GetNode (), tid);
m_rcvSocket->Bind ( InetSocketAddress (Ipv4Address::GetAny (),m_serverPort));
- m_rcvSocket->SetRecvCallback (MakeCallback (&LtpUdpConvergenceLayerAdapter::DataRecv, this));
+ m_rcvSocket->SetRecvCallback (MakeCallback (&LtpUdpConvergenceLayerAdapter::Receive, this));
m_rcvSocket6->Bind6 ();
- m_rcvSocket6->SetRecvCallback (MakeCallback (&LtpUdpConvergenceLayerAdapter::DataRecv, this));
+ m_rcvSocket6->SetRecvCallback (MakeCallback (&LtpUdpConvergenceLayerAdapter::Receive, this));
return true;
}
@@ -195,7 +195,7 @@
}
-void LtpUdpConvergenceLayerAdapter::DataRecv (Ptr<Socket> socket)
+void LtpUdpConvergenceLayerAdapter::Receive (Ptr<Socket> socket)
{
NS_LOG_FUNCTION (this << " " << socket);
--- a/src/ltp-protocol/model/ltp-udp-convergence-layer-adapter.h Mon Aug 11 01:28:34 2014 +0200
+++ b/src/ltp-protocol/model/ltp-udp-convergence-layer-adapter.h Mon Aug 11 12:48:44 2014 +0200
@@ -96,13 +96,13 @@
/* \brief Receive a data packet from the lower layer.
* \return 0 if there are no available datagrams to deliver
*/
- void DataRecv (Ptr<Socket> socket);
+ void Receive (Ptr<Socket> socket);
/* public API to get the MTU */
/**
* Get the maximum transmission unit (MTU) associated with this
- * destination Engine ID. This will typically be implemented
+ * destination Engine ID. This is implemented
* by resolving the Engine ID to an IP address, then opening a
* connected UDP socket to the destination IP address and
* checking it for its MTU.