1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
|
Internet Engineering Task Force (IETF) S. Burleigh
Request for Comments: 9171 IPNGROUP
Category: Standards Track K. Fall
ISSN: 2070-1721 Roland Computing Services
E. Birrane, III
APL, Johns Hopkins University
January 2022
Bundle Protocol Version 7
Abstract
This document presents a specification for the Bundle Protocol,
adapted from the experimental Bundle Protocol specification developed
by the Delay-Tolerant Networking Research Group of the Internet
Research Task Force and documented in RFC 5050.
Status of This Memo
This is an Internet Standards Track document.
This document is a product of the Internet Engineering Task Force
(IETF). It represents the consensus of the IETF community. It has
received public review and has been approved for publication by the
Internet Engineering Steering Group (IESG). Further information on
Internet Standards is available in Section 2 of RFC 7841.
Information about the current status of this document, any errata,
and how to provide feedback on it may be obtained at
https://www.rfc-editor.org/info/rfc9171.
Copyright Notice
Copyright (c) 2022 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include Revised BSD License text as described in Section 4.e of the
Trust Legal Provisions and are provided without warranty as described
in the Revised BSD License.
Table of Contents
1. Introduction
2. Conventions Used in This Document
3. Service Description
3.1. Definitions
3.2. Discussion of BP Concepts
3.3. Services Offered by Bundle Protocol Agents
4. Bundle Format
4.1. Bundle Structure
4.2. BP Fundamental Data Structures
4.2.1. CRC Type
4.2.2. CRC
4.2.3. Bundle Processing Control Flags
4.2.4. Block Processing Control Flags
4.2.5. Identifiers
4.2.5.1. Endpoint ID
4.2.5.1.1. The dtn URI Scheme
4.2.5.1.2. The ipn URI Scheme
4.2.5.2. Node ID
4.2.6. DTN Time
4.2.7. Creation Timestamp
4.2.8. Block-Type-Specific Data
4.3. Block Structures
4.3.1. Primary Bundle Block
4.3.2. Canonical Bundle Block Format
4.4. Extension Blocks
4.4.1. Previous Node
4.4.2. Bundle Age
4.4.3. Hop Count
5. Bundle Processing
5.1. Generation of Administrative Records
5.2. Bundle Transmission
5.3. Bundle Dispatching
5.4. Bundle Forwarding
5.4.1. Forwarding Contraindicated
5.4.2. Forwarding Failed
5.5. Bundle Expiration
5.6. Bundle Reception
5.7. Local Bundle Delivery
5.8. Bundle Fragmentation
5.9. Application Data Unit Reassembly
5.10. Bundle Deletion
5.11. Discarding a Bundle
5.12. Canceling a Transmission
6. Administrative Record Processing
6.1. Administrative Records
6.1.1. Bundle Status Reports
6.2. Generation of Administrative Records
7. Services Required of the Convergence Layer
7.1. The Convergence Layer
7.2. Summary of Convergence-Layer Services
8. Security Considerations
9. IANA Considerations
9.1. Bundle Block Types
9.2. Primary Bundle Protocol Version
9.3. Bundle Processing Control Flags
9.4. Block Processing Control Flags
9.5. Bundle Status Report Reason Codes
9.6. Bundle Protocol URI Scheme Types
9.7. dtn URI Scheme
9.8. ipn URI Scheme
10. References
10.1. Normative References
10.2. Informative References
Appendix A. Significant Changes from RFC 5050
Appendix B. CDDL Expression
Acknowledgments
Authors' Addresses
1. Introduction
Since the publication of the Bundle Protocol specification
(Experimental RFC 5050 [RFC5050]) in 2007, the Delay-Tolerant
Networking (DTN) Bundle Protocol (BP) has been implemented in
multiple programming languages and deployed to a wide variety of
computing platforms. This implementation and deployment experience
has identified opportunities for making the protocol simpler, more
capable, and easier to use. The present document, standardizing the
Bundle Protocol, is adapted from RFC 5050 in that context, reflecting
lessons learned. Significant changes from the Bundle Protocol
specification defined in RFC 5050 are listed in Appendix A.
This document describes BP version 7 (BPv7).
Delay-Tolerant Networking is a network architecture providing
communications in and/or through highly stressed environments.
Stressed networking environments include those with intermittent
connectivity, large and/or variable delays, and high bit error rates.
To provide its services, BP may be viewed as sitting at the
application layer of some number of constituent networks, forming a
store-carry-forward overlay network. Key capabilities of BP include:
* Ability to use physical motility for the movement of data.
* Ability to move the responsibility for error control from one node
to another.
* Ability to cope with intermittent connectivity, including cases
where the sender and receiver are not concurrently present in the
network.
* Ability to take advantage of scheduled, predicted, and
opportunistic connectivity, whether bidirectional or
unidirectional, in addition to continuous connectivity.
* Late binding of overlay-network endpoint identifiers to underlying
constituent network addresses.
For descriptions of these capabilities and the rationale for the DTN
architecture, see [ARCH] and [SIGC].
BP's location within the standard protocol stack is as shown in
Figure 1. BP uses underlying "integrated" transport and/or network
protocols for communications within a given constituent network. The
layer at which those underlying protocols are located is here termed
the "convergence layer", and the interface between the Bundle
Protocol and a specific underlying protocol is termed a "convergence-
layer adapter".
Figure 1 shows three distinct transport and network protocols
(denoted T1/N1, T2/N2, and T3/N3).
+-----------+ +-----------+
| BP app | | BP app |
+---------v-| +->>>>>>>>>>v-+ +->>>>>>>>>>v-+ +-^---------+
| BP v | | ^ BP v | | ^ BP v | | ^ BP |
+---------v-+ +-^---------v-+ +-^---------v-+ +-^---------+
| T1 v | + ^ T1/T2 v | + ^ T2/T3 v | | ^ T3 |
+---------v-+ +-^---------v-+ +-^---------v + +-^---------+
| N1 v | | ^ N1/N2 v | | ^ N2/N3 v | | ^ N3 |
+---------v-+ +-^---------v + +-^---------v-+ +-^---------+
| >>>>>>>>^ >>>>>>>>>>^ >>>>>>>>^ |
+-----------+ +-------------+ +-------------+ +-----------+
| | | |
|<---- A network ---->| |<---- A network ---->|
| | | |
Figure 1: The Bundle Protocol in the Protocol Stack Model
This document describes the format of the protocol data units (PDUs)
(called "bundles") passed between entities participating in BP
communications.
The entities are referred to as "bundle nodes". This document does
not address:
* Operations in the convergence-layer adapters that bundle nodes use
to transport data through specific types of internets. (However,
the document does discuss the services that must be provided by
each adapter at the convergence layer.)
* The bundle route computation algorithm.
* Mechanisms for populating the routing or forwarding information
bases of bundle nodes.
* The mechanisms for securing bundles en route.
* The mechanisms for managing bundle nodes.
Note that implementations of the specification presented in this
document will not be interoperable with implementations of RFC 5050.
2. Conventions Used in This Document
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in
BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all
capitals, as shown here.
3. Service Description
3.1. Definitions
Bundle: A bundle is a PDU of BP, so named because negotiation of the
parameters of a data exchange may be impractical in a delay-
tolerant network: it is often better practice to "bundle" with a
unit of application data all metadata that might be needed in
order to make the data immediately usable when delivered to the
application. Each bundle comprises a sequence of two or more
"blocks" of protocol data, which serve various purposes.
Block: A Bundle Protocol block is one of the protocol data
structures that together constitute a well-formed bundle.
Application Data Unit: An application data unit (ADU) is the unit of
data whose conveyance to the bundle's destination is the purpose
for the transmission of some bundle that is not a fragment (as
defined below).
Bundle payload: A bundle payload (or simply "payload") is the
content of the bundle's payload block. The terms "bundle
content", "bundle payload", and "payload" are used interchangeably
in this document. For a bundle that is not a fragment (as defined
below), the payload is an ADU.
Partial payload: A partial payload is a payload that comprises
either the first N bytes or the last N bytes of some other payload
of length M, such that 0 < N < M. Note that every partial payload
is a payload and therefore can be further subdivided into partial
payloads.
Fragment: A fragment, a.k.a. "fragmentary bundle", is a bundle whose
payload block contains a partial payload.
Bundle node: A bundle node (or, in the context of this document,
simply a "node") is any entity that can send and/or receive
bundles. Each bundle node has three conceptual components,
defined below, as shown in Figure 2: a "Bundle Protocol Agent", a
set of zero or more "convergence-layer adapters", and an
"application agent". ("CL1 PDUs" are the PDUs of the convergence-
layer protocol used in network 1.)
+-----------------------------------------------------------+
|Node |
| |
| +-------------------------------------------------------+ |
| |Application Agent | |
| | | |
| | +--------------------------+ +----------------------+ | |
| | |Administrative element | |Application-specific | | |
| | | | |element | | |
| | | | | | | |
| | +--------------------------+ +----------------------+ | |
| | ^ ^ | |
| | Admin|records Application|data | |
| | | | | |
| +----------------v--------------------------v-----------+ |
| ^ |
| | ADUs |
| | |
| +-----------------------------v-------------------------+ |
| |Bundle Protocol Agent | |
| | | |
| | | |
| +-------------------------------------------------------+ |
| ^ ^ ^ |
| | Bundles | Bundles Bundles | |
| | | | |
| +------v-----+ +-----v------+ +-----v-----+ |
| |CLA 1 | |CLA 2 | |CLA n | |
| | | | | . . . | | |
| | | | | | | |
+-+------------+-----+------------+-----------+-----------+-+
^ ^ ^
CL1|PDUs CL2|PDUs CLn|PDUs
| | |
+------v-----+ +-----v------+ +-----v-----+
Network 1 Network 2 Network n
Figure 2: Components of a Bundle Node
Bundle Protocol Agent: The Bundle Protocol Agent (BPA) of a node is
the node component that offers the BP services and executes the
procedures of the Bundle Protocol.
Convergence-layer adapter: A convergence-layer adapter (CLA) is a
node component that sends and receives bundles on behalf of the
BPA, utilizing the services of some "integrated" protocol stack
that is supported in one of the networks within which the node is
functionally located.
Application agent: The application agent (AA) of a node is the node
component that utilizes the BP services to effect communication
for some user purpose. The application agent in turn has two
elements: an administrative element and an application-specific
element.
Application-specific element: The application-specific element of an
AA is the node component that constructs, requests transmission
of, accepts delivery of, and processes units of user application
data.
Administrative element: The administrative element of an AA is the
node component that constructs and requests transmission of
administrative records (defined below), including status reports,
and accepts delivery of and processes any administrative records
that the node receives.
Administrative record: A BP administrative record is an ADU that is
exchanged between the administrative elements of nodes'
application agents for some BP administrative purpose. The only
administrative record defined in this specification is the status
report, discussed later.
Bundle endpoint: A bundle endpoint (or simply "endpoint") is a set
of zero or more bundle nodes that all identify themselves for BP
purposes by some common identifier, called a "bundle endpoint ID"
(or, in this document, simply "endpoint ID"); endpoint IDs are
described in detail in Section 4.2.5.1.
Singleton endpoint: A singleton endpoint is an endpoint that always
contains exactly one member.
Registration: A registration is the state machine characterizing a
given node's membership in a given endpoint. Any single
registration has an associated delivery failure action as defined
below and must at any time be in one of two states: Active or
Passive. Registrations are local; information about a node's
registrations is not expected to be available at other nodes, and
the Bundle Protocol does not include a mechanism for distributing
information about registrations.
Delivery: A bundle is considered to have been delivered at a node
subject to a registration as soon as the ADU that is the payload
of the bundle, together with any relevant metadata (an
implementation matter), has been presented to the node's
application agent in a manner consistent with the state of that
registration.
Deliverability: A bundle is considered "deliverable" subject to a
registration if and only if (a) the bundle's destination endpoint
is the endpoint with which the registration is associated, (b) the
bundle has not yet been delivered subject to this registration,
and (c) the bundle has not yet been "abandoned" (as defined below)
subject to this registration.
Abandonment: To abandon a bundle subject to some registration is to
assert that the bundle is not deliverable subject to that
registration.
Delivery failure action: The delivery failure action of a
registration is the action that is to be taken when a bundle that
is "deliverable" subject to that registration is received at a
time when the registration is in the Passive state.
Destination: The destination of a bundle is the endpoint comprising
the node(s) at which the bundle is to be delivered (as defined
above).
Transmission: A transmission is an attempt by a node's BPA to cause
copies of a bundle to be delivered to one or more of the nodes
that are members of some endpoint (the bundle's destination) in
response to a transmission request issued by the node's
application agent.
Forwarding: To forward a bundle to a node is to invoke the services
of one or more CLAs in a sustained effort to cause a copy of the
bundle to be received by that node.
Discarding: To discard a bundle is to cease all operations on the
bundle and functionally erase all references to it. The specific
procedures by which this is accomplished are an implementation
matter.
Retention constraint: A retention constraint is an element of the
state of a bundle that prevents the bundle from being discarded.
That is, a bundle cannot be discarded while it has any retention
constraints.
Deletion: To delete a bundle is to remove unconditionally all of the
bundle's retention constraints, enabling the bundle to be
discarded.
3.2. Discussion of BP Concepts
Multiple instances of the same bundle (the same unit of DTN protocol
data) might exist concurrently in different parts of a network --
possibly differing in some blocks -- in the memory local to one or
more bundle nodes and/or in transit between nodes. In the context of
the operation of a bundle node, a bundle is an instance (copy), in
that node's local memory, of some bundle that is in the network.
The payload for a bundle forwarded in response to a bundle
transmission request is the ADU whose location is provided as a
parameter to that request. The payload for a bundle forwarded in
response to reception of a bundle is the payload of the received
bundle.
In the most familiar case, a bundle node is instantiated as a single
process running on a general-purpose computer, but in general the
definition is meant to be broader: a bundle node might alternatively
be a thread, an object in an object-oriented operating system, a
special-purpose hardware device, etc.
The manner in which the functions of the BPA are performed is wholly
an implementation matter. For example, BPA functionality might be
coded into each node individually; it might be implemented as a
shared library that is used in common by any number of bundle nodes
on a single computer; it might be implemented as a daemon whose
services are invoked via inter-process or network communication by
any number of bundle nodes on one or more computers; it might be
implemented in hardware.
Every CLA implements its own thin layer of protocol, interposed
between BP and the (usually "top") protocol(s) of the underlying
integrated protocol stack; this "CL protocol" may only serve to
multiplex and demultiplex bundles to and from the underlying
integrated protocol, or it may offer additional CL-specific
functionality. The manner in which a CLA sends and receives bundles,
as well as the definitions of CLAs and CL protocols, are beyond the
scope of this specification.
Note that the administrative element of a node's application agent
may itself, in some cases, function as a CLA. That is, outgoing
bundles may be "tunneled" through encapsulating bundles:
* An outgoing bundle constitutes a byte array. This byte array may,
like any other, be presented to the BPA as an ADU that is to be
transmitted to some endpoint.
* The original bundle thus forms the payload of an encapsulating
bundle that is forwarded using some other convergence-layer
protocol(s).
* When the encapsulating bundle is received, its payload is
delivered to the peer application agent administrative element,
which then instructs the BPA to dispatch that original bundle in
the usual way.
The purposes for which this technique may be useful (such as cross-
domain security) are beyond the scope of this specification.
The only interface between the BPA and the application-specific
element of the AA is the BP service interface. But between the BPA
and the administrative element of the AA there is a (conceptual)
private control interface in addition to the BP service interface.
This private control interface enables the BPA and the administrative
element of the AA to direct each other to take action under specific
circumstances.
In the case of a node that serves simply as a BP "router", the AA may
have no application-specific element at all. The application-
specific elements of other nodes' AAs may perform arbitrarily complex
application functions, perhaps even offering multiplexed DTN
communication services to a number of other applications. As with
the BPA, the manner in which the AA performs its functions is wholly
an implementation matter.
Singletons are the most familiar sort of endpoint, but in general the
endpoint notion is meant to be broader. For example, the nodes in a
sensor network might constitute a set of bundle nodes that are all
registered in a single common endpoint and will all receive any data
delivered at that endpoint. *Note* too that any given bundle node
might be registered in multiple bundle endpoints and receive all data
delivered at each of those endpoints.
Recall that every node, by definition, includes an application agent,
which in turn includes an administrative element, which exchanges
administrative records with the administrative elements of other
nodes. As such, every node is permanently, structurally registered
in the singleton endpoint at which administrative records received
from other nodes are delivered. Registration in no other endpoint
can ever be assumed to be permanent. This endpoint, termed the
node's "administrative endpoint", is therefore uniquely and
permanently associated with the node, and for this reason the ID of a
node's administrative endpoint may always serve as the "node ID" (see
Section 4.2.5.2) of the node.
The destination of every bundle is an endpoint, which may or may not
be singleton. The source of every bundle is a node, identified by
node ID. Note, though, that the source node ID asserted in a given
bundle may be the null endpoint ID (as described later) rather than
the ID of the source node; bundles for which the asserted source node
ID is the null endpoint ID are termed "anonymous" bundles.
Any number of transmissions may be concurrently undertaken by the BPA
of a given node.
When the BPA of a node determines that it must forward a bundle
either to a node that is a member of the bundle's destination
endpoint or to some intermediate forwarding node, the BPA invokes the
services of one or more CLAs in a sustained effort to cause a copy of
the bundle to be received by that node.
Upon reception, the processing of a bundle depends on whether or not
the receiving node is registered in the bundle's destination
endpoint. If it is, and if the payload of the bundle is non-
fragmentary (possibly as a result of successful payload reassembly
from fragmentary payloads, including the original payload of the
newly received bundle), then the bundle is normally delivered to the
node's application agent subject to the registration characterizing
the node's membership in the destination endpoint.
The Bundle Protocol itself does not ensure delivery of a bundle to
its destination. Data loss along the path to the destination node
can be minimized by utilizing reliable convergence-layer protocols
between neighbors on all segments of the end-to-end path; however,
for end-to-end bundle delivery assurance it will be necessary to
develop extensions to the Bundle Protocol and/or application-layer
mechanisms.
The Bundle Protocol is designed for extensibility. Bundle Protocol
extensions, documented elsewhere, may extend this specification by
defining additional:
* blocks
* administrative records
* bundle processing control flags
* block processing control flags
* types of bundle status reports
* bundle status report reason codes
* mandates and constraints on processing that conformant BPAs must
perform at specified points in the inbound and outbound bundle
processing cycles
3.3. Services Offered by Bundle Protocol Agents
The BPA of each node is expected to provide the following services to
the node's application agent:
* commencing a registration (registering the node in an endpoint).
* terminating a registration.
* switching a registration between Active and Passive states.
* transmitting a bundle to an identified bundle endpoint.
* canceling a transmission.
* polling a registration that is in the Passive state.
* delivering a received bundle.
Note that the details of registration functionality are an
implementation matter and are beyond the scope of this specification.
4. Bundle Format
4.1. Bundle Structure
The format of bundles SHALL conform to the Concise Binary Object
Representation (CBOR) [RFC8949].
Cryptographic verification of a block is possible only if the
sequence of octets on which the verifying node computes its hash --
the canonicalized representation of the block -- is identical to the
sequence of octets on which the hash declared for that block was
computed. To ensure that blocks are always in canonical
representation when they are transmitted and received, the CBOR
encodings of the values of all fields in all blocks MUST conform to
the core deterministic encoding requirements as specified in
[RFC8949], except that indefinite-length items are not prohibited.
Each bundle SHALL be a concatenated sequence of at least two blocks,
represented as a CBOR indefinite-length array. The first block in
the sequence (the first item of the array) MUST be a primary bundle
block in CBOR encoding as described below; the bundle MUST have
exactly one primary bundle block. The primary block MUST be followed
by one or more canonical bundle blocks (additional array items) in
CBOR encoding as described in Section 4.3.2. Every block following
the primary block SHALL be the CBOR encoding of a canonical block.
The last such block MUST be a payload block; the bundle MUST have
exactly one payload block. The payload block SHALL be followed by a
CBOR "break" stop code, terminating the array.
| (Note that, while CBOR permits considerable flexibility in the
| encoding of bundles, this flexibility must not be interpreted
| as inviting increased complexity in PDU structure.)
Associated with each block of a bundle is a block number. The block
number uniquely identifies the block within the bundle, enabling
blocks (notably Bundle Protocol Security blocks) to reference other
blocks in the same bundle without ambiguity. The block number of the
primary block is implicitly zero; the block numbers of all other
blocks are explicitly stated in block headers as noted below. Block
numbering is unrelated to the order in which blocks are sequenced in
the bundle. The block number of the payload block is always 1.
An implementation of the Bundle Protocol MAY discard any sequence of
bytes that does not conform to the Bundle Protocol specification.
An implementation of the Bundle Protocol MAY accept a sequence of
bytes that does not conform to the Bundle Protocol specification
(e.g., one that represents data elements in fixed-length arrays
rather than indefinite-length arrays) and transform it into
conformant BP structure before processing it. Procedures for
accomplishing such a transformation are beyond the scope of this
specification.
4.2. BP Fundamental Data Structures
4.2.1. CRC Type
CRC type is an unsigned integer type code for which the following
values (and no others) are valid:
* 0 indicates "no Cyclic Redundancy Check (CRC) is present."
* 1 indicates "a standard X-25 CRC-16 is present." [CRC16]
* 2 indicates "a standard CRC32C (Castagnoli) CRC-32 is present."
[RFC4960]
CRC type SHALL be represented as a CBOR unsigned integer.
For examples of CRC32C CRCs, see Appendix A.4 of [RFC7143].
Note that more robust protection of BP data integrity, as needed, may
be provided by means of Block Integrity Blocks (BIBs) as defined in
the Bundle Protocol Security specification [BPSEC].
4.2.2. CRC
The CRC SHALL be omitted from a block if and only if the block's CRC
type code is zero.
When not omitted, the CRC SHALL be represented as a CBOR byte string
of two bytes (that is, CBOR additional information 2, if CRC type is
1) or of four bytes (that is, CBOR additional information 4, if CRC
type is 2); in each case, the sequence of bytes SHALL constitute an
unsigned integer value (of 16 or 32 bits, respectively) in network
byte order.
4.2.3. Bundle Processing Control Flags
Bundle processing control flags assert properties of the bundle as a
whole rather than of any particular block of the bundle. They are
conveyed in the primary block of the bundle.
The following properties are asserted by the bundle processing
control flags:
* The bundle is a fragment. (Boolean)
* The bundle's payload is an administrative record. (Boolean)
* The bundle must not be fragmented. (Boolean)
* Acknowledgment by the user application is requested. (Boolean)
* Status time is requested in all status reports. (Boolean)
* Flags requesting types of status reports (all Boolean):
- Request reporting of bundle reception.
- Request reporting of bundle forwarding.
- Request reporting of bundle delivery.
- Request reporting of bundle deletion.
If the bundle processing control flags indicate that the bundle's ADU
is an administrative record, then all status report request flag
values MUST be zero.
If the bundle's source node is omitted (i.e., the source node ID is
the ID of the null endpoint, which has no members as discussed below;
this option enables anonymous bundle transmission), then the bundle
is not uniquely identifiable and all Bundle Protocol features that
rely on bundle identity must therefore be disabled: the "Bundle must
not be fragmented" flag value MUST be 1, and all status report
request flag values MUST be zero.
Bundle processing control flags that are unrecognized MUST be
ignored, as future definitions of additional flags might not be
integrated simultaneously into the Bundle Protocol implementations
operating at all nodes.
The bundle processing control flags SHALL be represented as a CBOR
unsigned integer item, the value of which SHALL be processed as a bit
field indicating the control flag values as follows (note that bit
numbering in this instance is reversed from the usual practice,
beginning with the low-order bit instead of the high-order bit, in
recognition of the potential definition of additional control flag
values in the future):
Bit 0 (the low-order bit, 0x000001): Bundle is a fragment.
Bit 1 (0x000002): ADU is an administrative record.
Bit 2 (0x000004): Bundle must not be fragmented.
Bit 3 (0x000008): Reserved.
Bit 4 (0x000010): Reserved.
Bit 5 (0x000020): Acknowledgement by application is requested.
Bit 6 (0x000040): Status time requested in reports.
Bit 7 (0x000080): Reserved.
Bit 8 (0x000100): Reserved.
Bit 9 (0x000200): Reserved.
Bit 10 (0x000400): Reserved.
Bit 11 (0x000800): Reserved.
Bit 12 (0x001000): Reserved.
Bit 13 (0x002000): Reserved.
Bit 14 (0x004000): Request reporting of bundle reception.
Bit 15 (0x008000): Reserved.
Bit 16 (0x010000): Request reporting of bundle forwarding.
Bit 17 (0x020000): Request reporting of bundle delivery.
Bit 18 (0x040000): Request reporting of bundle deletion.
Bits 19-20: Reserved.
Bits 21-63: Unassigned.
4.2.4. Block Processing Control Flags
The block processing control flags assert properties of canonical
bundle blocks. They are conveyed in the header of the block to which
they pertain.
Block processing control flags that are unrecognized MUST be ignored,
as future definitions of additional flags might not be integrated
simultaneously into the Bundle Protocol implementations operating at
all nodes.
The block processing control flags SHALL be represented as a CBOR
unsigned integer item, the value of which SHALL be processed as a bit
field indicating the control flag values as follows (note that bit
numbering in this instance is reversed from the usual practice,
beginning with the low-order bit instead of the high-order bit, for
agreement with the bit numbering of the bundle processing control
flags):
Bit 0 (the low-order bit, 0x01): Block must be replicated in every
fragment.
Bit 1 (0x02): Transmit status report if block can't be processed.
Bit 2 (0x04): Delete bundle if block can't be processed.
Bit 3 (0x08): Reserved.
Bit 4 (0x10): Discard block if it can't be processed.
Bit 5 (0x20): Reserved.
Bit 6 (0x40): Reserved.
Bits 7-63: Unassigned.
For each bundle whose bundle processing control flags indicate that
the bundle's ADU is an administrative record, or whose source node ID
is the null endpoint ID as defined below, the value of the "Transmit
status report if block can't be processed" flag in every canonical
block of the bundle MUST be zero.
4.2.5. Identifiers
4.2.5.1. Endpoint ID
The destinations of bundles are bundle endpoints, identified by text
strings termed "endpoint IDs" (see Section 3.1). Each endpoint ID
(EID) is a Uniform Resource Identifier [URI]. As such, each endpoint
ID can be characterized as having this general structure:
< scheme name > : < scheme-specific part, or "SSP" >
The scheme identified by the < scheme name > in an endpoint ID is a
set of syntactic and semantic rules that fully explain how to parse
and interpret the scheme-specific part (SSP). Each scheme that may
be used to form a BP endpoint ID must be added to the "Bundle
Protocol URI Scheme Types" registry, maintained by IANA as described
in Section 9.6; association of a unique URI scheme code number with
each scheme name in this registry helps to enable compact
representation of endpoint IDs in bundle blocks. Note that the set
of allowable schemes is effectively unlimited. Any scheme conforming
to [URIREG] may be added to the registry of URI scheme code numbers
and thereupon used in a Bundle Protocol endpoint ID.
Each entry in the registry of URI scheme code numbers MUST contain a
reference to a scheme code number definition document, which defines
the manner in which the scheme-specific part of any URI formed in
that scheme is parsed and interpreted and MUST be CBOR encoded for
transmission as a BP endpoint ID. The scheme code number definition
document may also contain information as to (a) which convergence-
layer protocol(s) may be used to forward a bundle to a BP destination
endpoint identified by such an ID and (b) how the ID of the
convergence-layer protocol endpoint to use for that purpose can be
inferred from that destination endpoint ID.
Note that, although endpoint IDs are URIs, implementations of the BP
service interface may support expression of endpoint IDs in some
internationalized manner (e.g., Internationalized Resource
Identifiers (IRIs); see [RFC3987]).
Each BP endpoint ID (EID) SHALL be represented as a CBOR array
comprising two items.
The first item of the array SHALL be the code number identifying the
endpoint ID's URI scheme, as defined in the registry of URI scheme
code numbers for the Bundle Protocol. Each URI scheme code number
SHALL be represented as a CBOR unsigned integer.
The second item of the array SHALL be the applicable CBOR encoding of
the scheme-specific part of the EID, defined as noted in the
references(s) for the URI scheme code number registry entry for the
EID's URI scheme.
4.2.5.1.1. The dtn URI Scheme
The "dtn" scheme supports the identification of BP endpoints by
arbitrarily expressive character strings. It is specified as
follows:
Scheme syntax: This specification uses the Augmented Backus-Naur
Form (ABNF) notation of [RFC5234].
dtn-uri = "dtn:" ("none" / dtn-hier-part)
dtn-hier-part = "//" node-name name-delim demux ; a path-rootless
node-name = reg-name
name-delim = "/"
demux = *VCHAR
Scheme semantics: URIs of the dtn scheme are used as endpoint
identifiers in the Delay-Tolerant Networking (DTN) Bundle Protocol
(BP) as described in the present document.
The endpoint ID "dtn:none" identifies the "null endpoint", the
endpoint that by definition never has any members.
All BP endpoints identified by all other dtn-scheme endpoint IDs for
which the first character of demux is a character other than '~'
(tilde) are singleton endpoints. All BP endpoints identified by dtn-
scheme endpoint IDs for which the first character *is* '~' (tilde)
are *not* singleton endpoints.
A dtn-scheme endpoint ID for which the demux is of length zero MAY
identify the administrative endpoint for the node identified by node-
name, and as such may serve as a node ID. No dtn-scheme endpoint ID
for which the demux is of non-zero length may do so.
Note that these syntactic rules impose constraints on dtn-scheme
endpoint IDs that were not imposed by the original specification of
the dtn scheme as provided in [RFC5050]. It is believed that the
dtn-scheme endpoint IDs employed by BP applications conforming to
[RFC5050] are in most cases unlikely to be in violation of these
rules, but the developers of such applications are advised of the
potential for compromised interoperation.
Encoding considerations: For transmission as a BP endpoint ID, the
scheme-specific part of a URI of the dtn scheme SHALL be
represented as a CBOR text string unless the EID's SSP is "none",
in which case the SSP SHALL be represented as a CBOR unsigned
integer with the value zero. For all other purposes, URIs of the
dtn scheme are encoded exclusively in US-ASCII characters.
Interoperability considerations: None.
Security considerations:
Reliability and consistency: None of the BP endpoints identified
by the URIs of the dtn scheme are guaranteed to be reachable at
any time, and the identity of the processing entities operating
on those endpoints is never guaranteed by the Bundle Protocol
itself. Verification of the signature provided by the Block
Integrity Block targeting the bundle's primary block, as
defined by Bundle Protocol Security [BPSEC], is required for
this purpose.
Malicious construction: Malicious construction of a conformant
dtn-scheme URI is limited to the malicious selection of node
names and the malicious selection of demux strings. That is, a
maliciously constructed dtn-scheme URI could be used to direct
a bundle to an endpoint that might be damaged by the arrival of
that bundle or, alternatively, to declare a false source for a
bundle and thereby cause incorrect processing at a node that
receives the bundle. In both cases (and indeed in all bundle
processing), the node that receives a bundle should verify its
authenticity and validity before operating on it in any way.
Back-end transcoding: The limited expressiveness of URIs of the
dtn scheme effectively eliminates the possibility of threat due
to errors in back-end transcoding.
Rare IP address formats: Not relevant, as IP addresses do not
appear anywhere in conformant dtn-scheme URIs.
Sensitive information: Because dtn-scheme URIs are used only to
represent the identities of Bundle Protocol endpoints, the risk
of disclosure of sensitive information due to interception of
these URIs is minimal. Examination of dtn-scheme URIs could be
used to support traffic analysis; where traffic analysis is a
plausible danger, bundles should be conveyed by secure
convergence-layer protocols that do not expose endpoint IDs.
Semantic attacks: The simplicity of dtn-scheme URI syntax
minimizes the possibility of misinterpretation of a URI by a
human user.
4.2.5.1.2. The ipn URI Scheme
The "ipn" scheme supports the identification of BP endpoints by pairs
of unsigned integers, for compact representation in bundle blocks.
It is specified as follows:
Scheme syntax: This specification uses the Augmented Backus-Naur
Form (ABNF) notation of [RFC5234], including the core ABNF syntax
rule for DIGIT defined by that specification.
ipn-uri = "ipn:" ipn-hier-part
ipn-hier-part = node-nbr nbr-delim service-nbr ; a path-rootless
node-nbr = 1*DIGIT
nbr-delim = "."
service-nbr = 1*DIGIT
Scheme semantics: URIs of the ipn scheme are used as endpoint
identifiers in the Delay-Tolerant Networking (DTN) Bundle Protocol
(BP) as described in the present document.
All BP endpoints identified by ipn-scheme endpoint IDs are singleton
endpoints.
An ipn-scheme endpoint ID for which service-nbr is zero MAY identify
the administrative endpoint for the node identified by node-nbr, and
as such may serve as a node ID. No ipn-scheme endpoint ID for which
service-nbr is non-zero may do so.
Encoding considerations: For transmission as a BP endpoint ID, the
scheme-specific part of a URI of the ipn scheme SHALL be
represented as a CBOR array comprising two items. The first item
of this array SHALL be the EID's node number (a number that
identifies the node) represented as a CBOR unsigned integer. The
second item of this array SHALL be the EID's service number (a
number that identifies some application service) represented as a
CBOR unsigned integer. For all other purposes, URIs of the ipn
scheme are encoded exclusively in US-ASCII characters.
Interoperability considerations: None.
Security considerations:
Reliability and consistency: None of the BP endpoints identified
by the URIs of the ipn scheme are guaranteed to be reachable at
any time, and the identity of the processing entities operating
on those endpoints is never guaranteed by the Bundle Protocol
itself. Verification of the signature provided by the Block
Integrity Block targeting the bundle's primary block, as
defined by Bundle Protocol Security [BPSEC], is required for
this purpose.
Malicious construction: Malicious construction of a conformant
ipn-scheme URI is limited to the malicious selection of node
numbers and the malicious selection of service numbers. That
is, a maliciously constructed ipn-scheme URI could be used to
direct a bundle to an endpoint that might be damaged by the
arrival of that bundle or, alternatively, to declare a false
source for a bundle and thereby cause incorrect processing at a
node that receives the bundle. In both cases (and indeed in
all bundle processing), the node that receives a bundle should
verify its authenticity and validity before operating on it in
any way.
Back-end transcoding: The limited expressiveness of URIs of the
ipn scheme effectively eliminates the possibility of threat due
to errors in back-end transcoding.
Rare IP address formats: Not relevant, as IP addresses do not
appear anywhere in conformant ipn-scheme URIs.
Sensitive information: Because ipn-scheme URIs are used only to
represent the identities of Bundle Protocol endpoints, the risk
of disclosure of sensitive information due to interception of
these URIs is minimal. Examination of ipn-scheme URIs could be
used to support traffic analysis; where traffic analysis is a
plausible danger, bundles should be conveyed by secure
convergence-layer protocols that do not expose endpoint IDs.
Semantic attacks: The simplicity of ipn-scheme URI syntax
minimizes the possibility of misinterpretation of a URI by a
human user.
4.2.5.2. Node ID
For many purposes of the Bundle Protocol, it is important to identify
the node that is operative in some context.
As discussed in Section 3.1, nodes are distinct from endpoints;
specifically, an endpoint is a set of zero or more nodes. But rather
than define a separate namespace for node identifiers, we instead use
endpoint identifiers to identify nodes as discussed in Section 3.2.
Formally:
* Every node is, by definition, permanently registered in the
singleton endpoint at which administrative records are delivered
to its application agent's administrative element, termed the
node's "administrative endpoint".
* As such, the EID of a node's administrative endpoint SHALL
uniquely identify that node.
* The EID of any singleton endpoint is allowed to serve as a "node
ID" identifying the node that is the sole member of that endpoint.
4.2.6. DTN Time
A DTN time is an unsigned integer indicating the number of
milliseconds that have elapsed since the DTN Epoch, 2000-01-01
00:00:00 +0000 (UTC). DTN time is not affected by leap seconds.
Each DTN time SHALL be represented as a CBOR unsigned integer item.
Implementers need to be aware that DTN time values conveyed in CBOR
encoding in bundles will nearly always exceed (2^32 - 1); the manner
in which a DTN time value is represented in memory is an
implementation matter. The DTN time value zero indicates that the
time is unknown.
4.2.7. Creation Timestamp
Each bundle's creation timestamp SHALL be represented as a CBOR array
comprising two items.
The first item of the array, termed "bundle creation time", SHALL be
the DTN time at which the transmission request was received that
resulted in the creation of the bundle, represented as a CBOR
unsigned integer.
The second item of the array, termed the creation timestamp's
"sequence number", SHALL be the latest value (as of the time at which
the transmission request was received) of a monotonically increasing
positive integer counter managed by the source node's BPA,
represented as a CBOR unsigned integer. The sequence counter MAY be
reset to zero whenever the current time advances by one millisecond.
For nodes that lack accurate clocks, it is recommended that bundle
creation time be set to zero and that the counter used as the source
of the bundle sequence count never be reset to zero.
Note that, in general, the creation of two distinct bundles with the
same source node ID and bundle creation timestamp may result in
unexpected network behavior and/or suboptimal performance. The
combination of source node ID and bundle creation timestamp serves to
identify a single transmission request, enabling it to be
acknowledged by the receiving application (provided the source node
ID is not the null endpoint ID).
4.2.8. Block-Type-Specific Data
Block-type-specific data in each block (other than the primary block)
SHALL be the applicable CBOR encoding of the content of the block.
Details of this representation are included in the specification
defining the block type.
4.3. Block Structures
This section describes the primary block in detail and non-primary
blocks in general. Rules for processing these blocks appear in
Section 5.
Note that supplementary DTN protocol specifications (including, but
not restricted to, Bundle Protocol Security [BPSEC]) may require that
BP implementations conforming to those protocols construct and
process additional blocks.
4.3.1. Primary Bundle Block
The primary bundle block contains the basic information needed to
forward bundles to their destinations.
Each primary block SHALL be represented as a CBOR array; the number
of elements in the array SHALL be 8 (if the bundle is not a fragment
and the block has no CRC), 9 (if the block has a CRC and the bundle
is not a fragment), 10 (if the bundle is a fragment and the block has
no CRC), or 11 (if the bundle is a fragment and the block has a CRC).
The primary block of each bundle SHALL be immutable. The CBOR-
encoded values of all fields in the primary block MUST remain
unchanged from the time the block is created to the time it is
delivered.
The fields of the primary bundle block SHALL be as follows, listed in
the order in which they MUST appear:
Version: An unsigned integer value indicating the version of the
Bundle Protocol that constructed this block. The present document
describes BPv7. This version number SHALL be represented as a
CBOR unsigned integer item.
Bundle Processing Control Flags: The bundle processing control flags
are discussed in Section 4.2.3.
CRC Type: CRC type codes are discussed in Section 4.2.1. The CRC
type code for the primary block MAY be zero if the bundle contains
a BPSec Block Integrity Block [BPSEC] whose target is the primary
block; otherwise, the CRC type code for the primary block MUST be
non-zero.
Destination EID: The Destination EID field identifies the bundle
endpoint that is the bundle's destination, i.e., the endpoint that
contains the node(s) at which the bundle is to be delivered.
Source node ID: The Source node ID field identifies the bundle node
at which the bundle was initially transmitted, except that source
node ID may be the null endpoint ID in the event that the bundle's
source chooses to remain anonymous.
Report-to EID: The Report-to EID field identifies the bundle
endpoint to which status reports pertaining to the forwarding and
delivery of this bundle are to be transmitted.
Creation Timestamp: The creation timestamp comprises two unsigned
integers that, together with the source node ID and (if the bundle
is a fragment) the fragment offset and payload length, serve to
identify the bundle. See Section 4.2.7 for the definition of this
field.
Lifetime: The Lifetime field is an unsigned integer that indicates
the time at which the bundle's payload will no longer be useful,
encoded as a number of milliseconds past the creation time. (For
high-rate deployments with very brief disruptions, fine-grained
expression of bundle lifetime may be useful.) When a bundle's age
exceeds its lifetime, bundle nodes need no longer retain or
forward the bundle; the bundle SHOULD be deleted from the network.
If the asserted lifetime for a received bundle is so lengthy that
retention of the bundle until its expiration time might degrade
operation of the node at which the bundle is received, or if the
BPA of that node determines that the bundle must be deleted in
order to prevent network performance degradation (e.g., the bundle
appears to be part of a denial-of-service attack), then that BPA
MAY impose a temporary overriding lifetime of shorter duration;
such an overriding lifetime SHALL NOT replace the lifetime
asserted in the bundle but SHALL serve as the bundle's effective
lifetime while the bundle resides at that node. Procedures for
imposing lifetime overrides are beyond the scope of this
specification.
For bundles originating at nodes that lack accurate clocks, it is
recommended that bundle age be obtained from the Bundle Age
extension block (see Section 4.4.2) rather than from the
difference between current time and bundle creation time. Bundle
lifetime SHALL be represented as a CBOR unsigned integer item.
Fragment offset: If and only if the bundle processing control flags
of this primary block indicate that the bundle is a fragment,
fragment offset SHALL be present in the primary block. Fragment
offset SHALL be represented as a CBOR unsigned integer indicating
the offset from the start of the original ADU at which the bytes
comprising the payload of this bundle were located.
Total Application Data Unit Length: If and only if the bundle
processing control flags of this primary block indicate that the
bundle is a fragment, total application data unit length SHALL be
present in the primary block. Total application data unit length
SHALL be represented as a CBOR unsigned integer indicating the
total length of the original ADU of which this bundle's payload is
a part.
CRC: A CRC SHALL be present in the primary block unless the bundle
includes a BPSec Block Integrity Block [BPSEC] whose target is the
primary block, in which case a CRC MAY be present in the primary
block. The length and nature of the CRC SHALL be as indicated by
the CRC type. The CRC SHALL be computed over the concatenation of
all bytes (including CBOR "break" characters) of the primary block
including the CRC field itself, which, for this purpose, SHALL be
temporarily populated with all bytes set to zero.
4.3.2. Canonical Bundle Block Format
Every block other than the primary block (all such blocks are termed
"canonical" blocks) SHALL be represented as a CBOR array; the number
of elements in the array SHALL be 5 (if CRC type is zero) or 6
(otherwise).
The fields of every canonical block SHALL be as follows, listed in
the order in which they MUST appear:
Block type code: An unsigned integer. Bundle block type code 1
indicates that the block is a Bundle Payload Block. Other block
type codes are described in Section 9.1. Block type codes 192
through 255 are not reserved and are available for private and/or
experimental use. All other block type code values are reserved
for future use.
Block number: An unsigned integer as discussed in Section 4.1. The
block number SHALL be represented as a CBOR unsigned integer.
Block processing control flags: As discussed in Section 4.2.4.
CRC type: As discussed in Section 4.2.1.
Block-type-specific data: Represented as a single definite-length
CBOR byte string, i.e., a CBOR byte string that is not of
indefinite length. For each type of block, the block-type-
specific data byte string is the serialization, in a block-type-
specific manner, of the data conveyed by that type of block;
definitions of blocks are required to define the manner in which
block-type-specific data are serialized within the block-type-
specific data field. For the Bundle Payload Block in particular
(block type 1), the block-type-specific data field, termed the
"payload", SHALL be an ADU, or some contiguous extent thereof,
represented as a definite-length CBOR byte string.
If and only if the value of the CRC type field of this block is
non-zero: A CRC. If present, the length and nature of the CRC SHALL
be as indicated by the CRC type and the CRC SHALL be computed over
the concatenation of all bytes of the block (including CBOR
"break" characters) including the CRC field itself, which, for
this purpose, SHALL be temporarily populated with all bytes set to
zero.
4.4. Extension Blocks
"Extension blocks" are all blocks other than the primary and payload
blocks. Three types of extension blocks are defined below. All
implementations of the Bundle Protocol specification (the present
document) MUST include procedures for recognizing, parsing, and
acting on, but not necessarily producing, these types of extension
blocks.
The specifications for additional types of extension blocks must
indicate whether or not BP implementations conforming to those
specifications must recognize, parse, act on, and/or produce blocks
of those types. As not all nodes will necessarily instantiate BP
implementations that conform to those additional specifications, it
is possible for a node to receive a bundle that includes extension
blocks that the node cannot process. The values of the block
processing control flags indicate the action to be taken by the BPA
when this is the case.
No mandated procedure in this specification is unconditionally
dependent on the absence or presence of any extension block.
Therefore, any BPA MAY insert or remove any extension block in any
bundle, subject to all mandates in the Bundle Protocol specification
and all extension block specifications to which the node's BP
implementation conforms. Note that removal of an extension block
will probably disable one or more elements of bundle processing that
were intended by the BPA that inserted that block. In particular,
note that removal of an extension block that is one of the targets of
a BPSec security block may render the bundle unverifiable.
The following extension blocks are defined in the current document.
4.4.1. Previous Node
The Previous Node Block, block type 6, identifies the node that
forwarded this bundle to the local node (i.e., to the node at which
the bundle currently resides); its block-type-specific data is the
node ID of that forwarder node. That node ID SHALL conform to
Section 4.2.5.2. If the local node is the source of the bundle, then
the bundle MUST NOT contain any Previous Node Block. Otherwise, the
bundle SHOULD contain one (1) occurrence of this type of block and
MUST NOT contain more than one.
4.4.2. Bundle Age
The Bundle Age Block, block type 7, contains the number of
milliseconds that have elapsed between the time the bundle was
created and the time at which it was most recently forwarded. It is
intended for use by nodes lacking access to an accurate clock, to aid
in determining the time at which a bundle's lifetime expires. The
block-type-specific data of this block is an unsigned integer
containing the age of the bundle in milliseconds, which SHALL be
represented as a CBOR unsigned integer item. (The age of the bundle
is the sum of all known intervals of the bundle's residence at
forwarding nodes, up to the time at which the bundle was most
recently forwarded, plus the summation of signal propagation time
over all episodes of transmission between forwarding nodes.
Determination of these values is an implementation matter.) If the
bundle's creation time is zero, then the bundle MUST contain exactly
one (1) occurrence of this type of block; otherwise, the bundle MAY
contain at most one (1) occurrence of this type of block. A bundle
MUST NOT contain multiple occurrences of the Bundle Age Block, as
this could result in processing anomalies.
4.4.3. Hop Count
The Hop Count Block, block type 10, contains two unsigned integers:
hop limit and hop count. A "hop" is here defined as an occasion on
which a bundle was forwarded from one node to another node. The hop
limit MUST be in the range 1 through 255. The hop limit value SHOULD
NOT be changed at any time after creation of the Hop Count Block; the
hop count value SHOULD initially be zero and SHOULD be increased by 1
on each hop.
The Hop Count Block is mainly intended as a safety mechanism, a means
of identifying bundles for removal from the network that can never be
delivered due to a persistent forwarding error. The hop count is
particularly valuable as a defense against routing anomalies that
might cause a bundle to be forwarded in a cyclical "ping-pong"
fashion between two nodes. When a bundle's hop count exceeds its hop
limit, the bundle SHOULD be deleted for the reason "Hop limit
exceeded", following the Bundle Deletion procedure defined in
Section 5.10.
Procedures for determining the appropriate hop limit for a bundle are
beyond the scope of this specification.
The block-type-specific data in a Hop Count Block SHALL be
represented as a CBOR array comprising two items. The first item of
this array SHALL be the bundle's hop limit, represented as a CBOR
unsigned integer. The second item of this array SHALL be the
bundle's hop count, represented as a CBOR unsigned integer. A bundle
MAY contain one occurrence of this type of block but MUST NOT contain
more than one.
5. Bundle Processing
The bundle-processing procedures mandated in this section and in
Section 6 govern the operation of the BPA and the application agent
administrative element of each bundle node. They are neither
exhaustive nor exclusive. Supplementary DTN protocol specifications
(including, but not restricted to, Bundle Protocol Security [BPSEC])
may augment, override, or supersede the mandates of this document.
5.1. Generation of Administrative Records
All transmission of bundles is in response to bundle transmission
requests presented by nodes' application agents. When required to
"generate" an administrative record (such as a bundle status report),
the BPA itself is responsible for causing a new bundle to be
transmitted, conveying that record. In concept, the BPA discharges
this responsibility by directing the administrative element of the
node's application agent to construct the record and request its
transmission as detailed in Section 6. In practice, the manner in
which administrative record generation is accomplished is an
implementation matter, provided the constraints noted in Section 6
are observed.
Status reports are relatively small bundles. Moreover, even when the
generation of status reports is enabled, the decision on whether or
not to generate a requested status report is left to the discretion
of the BPA. Nonetheless, note that requesting status reports for any
single bundle might easily result in the generation of (1 + (2
*(N-1))) status report bundles, where N is the number of nodes on the
path from the bundle's source to its destination, inclusive. That
is, the requesting of status reports for large numbers of bundles
could result in an unacceptable increase in the bundle traffic in the
network. For this reason, the generation of status reports MUST be
disabled by default and enabled only when the risk of excessive
network traffic is deemed acceptable. Mechanisms that could assist
in assessing and mitigating this risk, such as pre-placed agreements
authorizing the generation of status reports under specified
circumstances, are beyond the scope of this specification.
Notes on administrative record terminology:
* A "bundle reception status report" is a bundle status report with
the "Reporting node received bundle" flag set to 1.
* A "bundle forwarding status report" is a bundle status report with
the "Reporting node forwarded the bundle" flag set to 1.
* A "bundle delivery status report" is a bundle status report with
the "Reporting node delivered the bundle" flag set to 1.
* A "bundle deletion status report" is a bundle status report with
the "Reporting node deleted the bundle" flag set to 1.
5.2. Bundle Transmission
The steps in processing a bundle transmission request are as follows:
Step 1: Transmission of the bundle is initiated. An outbound bundle
MUST be created per the parameters of the bundle
transmission request, with the retention constraint
"Dispatch pending". The source node ID of the bundle MUST
be either (a) the null endpoint ID, indicating that the
source of the bundle is anonymous or (b) the EID of a
singleton endpoint whose only member is the node of which
the BPA is a component.
Step 2: Processing proceeds from Step 1 of Section 5.4.
5.3. Bundle Dispatching
(Note that this procedure is initiated only following completion of
Step 4 of Section 5.6.)
The steps in dispatching a bundle are as follows:
Step 1: If the bundle's destination endpoint is an endpoint of which
the node is a member, the Bundle Delivery procedure defined
in Section 5.7 MUST be followed and, for the purposes of all
subsequent processing of this bundle at this node, the
node's membership in the bundle's destination endpoint SHALL
be disavowed; specifically, even though the node is a member
of the bundle's destination endpoint, the node SHALL NOT
undertake to forward the bundle to itself in the course of
performing the procedure described in Section 5.4.
Step 2: Processing proceeds from Step 1 of Section 5.4.
5.4. Bundle Forwarding
The steps in forwarding a bundle are as follows:
Step 1: The retention constraint "Forward pending" MUST be added to
the bundle, and the bundle's "Dispatch pending" retention
constraint MUST be removed.
Step 2: The BPA MUST determine whether or not forwarding is
contraindicated (that is, rendered inadvisable) for any of
the reasons listed in the IANA "Bundle Status Report Reason
Codes" registry (see Section 9.5), whose initial contents
are listed in Table 1. In particular:
* The BPA MAY choose to either forward the bundle directly
to its destination node(s) (if possible) or forward the
bundle to some other node(s) for further forwarding. The
manner in which this decision is made may depend on the
scheme name in the destination endpoint ID and/or on
other state but in any case is beyond the scope of this
document; one possible mechanism is described in [SABR].
If the BPA elects to forward the bundle to some other
node(s) for further forwarding but finds it impossible to
select any node(s) to forward the bundle to, then
forwarding is contraindicated.
* Provided the BPA succeeded in selecting the node or nodes
to forward the bundle to, the BPA MUST subsequently
select the CLA(s) whose services will enable the node to
send the bundle to those nodes. The manner in which
specific appropriate CLAs are selected is beyond the
scope of this document; the TCP CLA [TCPCL] MUST be
implemented when some or all of the bundles forwarded by
the BPA must be forwarded via the Internet but may not be
appropriate for the forwarding of any particular bundle.
If the agent finds it impossible to select any
appropriate CLA(s) to use in forwarding this bundle, then
forwarding is contraindicated.
Step 3: If forwarding of the bundle is determined to be
contraindicated for any of the reasons listed in the IANA
"Bundle Status Report Reason Codes" registry (see
Section 9.5), then the Forwarding Contraindicated procedure
defined in Section 5.4.1 MUST be followed; the remaining
steps of this Bundle Forwarding procedure are skipped at
this time.
Step 4: For each node selected for forwarding, the BPA MUST invoke
the services of the selected CLA(s) in order to effect the
sending of the bundle to that node. Determining the time at
which the BPA invokes CLA services is a BPA implementation
matter. Determining the time at which each CLA subsequently
responds to this service invocation by sending the bundle is
a CLA implementation matter. Note that:
* If the bundle has a Previous Node Block, as defined in
Section 4.4.1, then that block MUST be removed from the
bundle before the bundle is forwarded.
* If the BPA is configured to attach Previous Node Blocks
to forwarded bundles, then a Previous Node Block
containing the node ID of the forwarding node MUST be
inserted into the bundle before the bundle is forwarded.
* If the bundle has a Bundle Age Block, as defined in
Section 4.4.2, then at the last possible moment before
the CLA initiates conveyance of the bundle via the CL
protocol the bundle age value MUST be increased by the
difference between the current time and the time at which
the bundle was received (or, if the local node is the
source of the bundle, created).
Step 5: When all selected CLAs have informed the BPA that they have
concluded their data-sending procedures with regard to this
bundle, processing may depend on the results of those
procedures.
If completion of the data-sending procedures by all selected CLAs has
not resulted in successful forwarding of the bundle (an
implementation-specific determination that is beyond the scope of
this specification), then the BPA MAY choose (in an implementation-
specific manner, again beyond the scope of this specification) to
initiate another attempt to forward the bundle. In that event,
processing proceeds from Step 4. The minimum number of times a given
node will initiate another forwarding attempt for any single bundle
in this event (a number that may be zero) is a node configuration
parameter that must be exposed to other nodes in the network to the
extent that this is required by the operating environment.
If completion of the data-sending procedures by all selected CLAs
*HAS* resulted in successful forwarding of the bundle, or if it has
not but the BPA does not choose to initiate another attempt to
forward the bundle, then:
* If the "request reporting of bundle forwarding" flag in the
bundle's status report request field is set to 1 and status
reporting is enabled, then a bundle forwarding status report
SHOULD be generated, destined for the bundle's report-to endpoint
ID. The reason code on this bundle forwarding status report MUST
be "no additional information".
* If any applicable Bundle Protocol extensions mandate generation of
status reports upon conclusion of convergence-layer data-sending
procedures, all such status reports SHOULD be generated with
extension-mandated reason codes.
* The bundle's "Forward pending" retention constraint MUST be
removed.
5.4.1. Forwarding Contraindicated
The steps in responding to contraindication of forwarding are as
follows:
Step 1: The BPA MUST determine whether or not to declare failure in
forwarding the bundle. Note: This decision is likely to be
influenced by the reason for which forwarding is
contraindicated.
Step 2: If forwarding failure is declared, then the Forwarding
Failed procedure defined in Section 5.4.2 MUST be followed.
Otherwise, when -- at some future time -- the forwarding of this
bundle ceases to be contraindicated, processing proceeds from Step 4
of Section 5.4.
5.4.2. Forwarding Failed
The steps in responding to a declaration of forwarding failure are as
follows:
Step 1: The BPA MAY forward the bundle back to the node that sent
it, as identified by the Previous Node Block, if present.
This forwarding, if performed, SHALL be accomplished by
performing Step 4 and Step 5 of Section 5.4 where the sole
node selected for forwarding SHALL be the node that sent the
bundle.
Step 2: If the bundle's destination endpoint is an endpoint of which
the node is a member, then the bundle's "Forward pending"
retention constraint MUST be removed. Otherwise, the bundle
MUST be deleted: the Bundle Deletion procedure defined in
Section 5.10 MUST be followed, citing the reason for which
forwarding was determined to be contraindicated.
5.5. Bundle Expiration
A bundle expires when the bundle's age exceeds its lifetime as
specified in the primary bundle block or as overridden by the BPA.
Bundle age MAY be determined by subtracting the bundle's creation
timestamp time from the current time if (a) that timestamp time is
not zero and (b) the local node's clock is known to be accurate;
otherwise, bundle age MUST be obtained from the Bundle Age extension
block. Bundle expiration MAY occur at any point in the processing of
a bundle. When a bundle expires, the BPA MUST delete the bundle for
the reason "Lifetime expired" (when the expired lifetime is the
lifetime as specified in the primary block) or "Traffic pared" (when
the expired lifetime is a lifetime override as imposed by the BPA):
the Bundle Deletion procedure defined in Section 5.10 MUST be
followed.
5.6. Bundle Reception
The steps in processing a bundle that has been received from another
node are as follows:
Step 1: The retention constraint "Dispatch pending" MUST be added to
the bundle.
Step 2: If the "request reporting of bundle reception" flag in the
bundle's status report request field is set to 1 and status
reporting is enabled, then a bundle reception status report
with reason code "No additional information" SHOULD be
generated, destined for the bundle's report-to endpoint ID.
Step 3: CRCs SHOULD be computed for every block of the bundle that
has an attached CRC. If any block of the bundle is
malformed according to this specification (including
syntactically invalid CBOR), or if any block has an attached
CRC and the CRC computed for this block upon reception
differs from that attached CRC, then the BPA MUST delete the
bundle for the reason "Block unintelligible". The Bundle
Deletion procedure defined in Section 5.10 MUST be followed,
and all remaining steps of the Bundle Reception procedure
MUST be skipped.
Step 4: For each block in the bundle that is an extension block that
the BPA cannot process:
* If the block processing control flags in that block
indicate that a status report is requested in this event
and if status reporting is enabled, then a bundle
reception status report with reason code "Block
unsupported" SHOULD be generated, destined for the
bundle's report-to endpoint ID.
* If the block processing control flags in that block
indicate that the bundle must be deleted in this event,
then the BPA MUST delete the bundle for the reason "Block
unsupported"; the Bundle Deletion procedure defined in
Section 5.10 MUST be followed, and all remaining steps of
the Bundle Reception procedure MUST be skipped.
* If the block processing control flags in that block do
*NOT* indicate that the bundle must be deleted in this
event but do indicate that the block must be discarded,
then the BPA MUST remove this block from the bundle.
* If the block processing control flags in that block
neither indicate that the bundle must be deleted nor
indicate that the block must be discarded, then
processing continues with the next extension block that
the BPA cannot process, if any; otherwise, processing
proceeds from Step 5.
Step 5: Processing proceeds from Step 1 of Section 5.3.
5.7. Local Bundle Delivery
The steps in processing a bundle that is destined for an endpoint of
which this node is a member are as follows:
Step 1: If the received bundle is a fragment, the ADU Reassembly
procedure described in Section 5.9 MUST be followed. If
this procedure results in reassembly of the entire original
ADU, processing of the fragmentary bundle whose payload has
been replaced by the reassembled ADU (whether this bundle or
a previously received fragment) proceeds from Step 2;
otherwise, the retention constraint "Reassembly pending"
MUST be added to the bundle, and all remaining steps of this
procedure MUST be skipped.
Step 2: Delivery depends on the state of the registration whose
endpoint ID matches that of the destination of the bundle:
* An additional implementation-specific delivery deferral
procedure MAY optionally be associated with the
registration.
* If the registration is in the Active state, then the
bundle MUST be delivered automatically as soon as it is
the next bundle that is due for delivery according to the
BPA's bundle delivery scheduling policy (an
implementation matter).
* If the registration is in the Passive state, or if
delivery of the bundle fails for some implementation-
specific reason, then the registration's delivery failure
action MUST be taken. The delivery failure action MUST
be one of the following:
- Defer delivery of the bundle subject to this
registration until (a) this bundle is the least
recently received of all bundles currently deliverable
subject to this registration and (b) either the
registration is polled or the registration is in the
Active state, and also perform any additional delivery
deferral procedure associated with the registration,
or
- Abandon delivery of the bundle subject to this
registration (as defined in Section 3.1).
Step 3: As soon as the bundle has been delivered, if the "request
reporting of bundle delivery" flag in the bundle's status
report request field is set to 1 and bundle status reporting
is enabled, then a bundle delivery status report SHOULD be
generated, destined for the bundle's report-to endpoint ID.
Note that this status report only states that the payload
has been delivered to the application agent, not that the
application agent has processed that payload.
5.8. Bundle Fragmentation
It may at times be advantageous for BPAs to reduce the sizes of
bundles in order to forward them. This might be the case, for
example, if a node to which a bundle is to be forwarded is accessible
only via intermittent contacts and no upcoming contact is long enough
to enable the forwarding of the entire bundle.
The size of a bundle can be reduced by "fragmenting" the bundle. To
fragment a bundle whose payload is of size M is to replace it with
two "fragments" -- new bundles with the same source node ID and
creation timestamp as the original bundle -- whose payloads MUST be
the first N and the last (M - N) bytes of the original bundle's
payload, where 0 < N < M.
Note that fragments are bundles and therefore may themselves be
fragmented, so multiple episodes of fragmentation may in effect
replace the original bundle with more than two fragments. (However,
there is only one "level" of fragmentation, as in IP fragmentation.)
Any bundle whose primary block's bundle processing control flags do
*NOT* indicate that it must not be fragmented MAY be fragmented at
any time, for any purpose, at the discretion of the BPA. *NOTE*,
however, that some combinations of bundle fragmentation, replication,
and routing might result in unexpected traffic patterns.
Fragmentation SHALL be constrained as follows:
* The concatenation of the payloads of all fragments produced by
fragmentation MUST always be identical to the payload of the
fragmented bundle (that is, the bundle that is being fragmented).
Note that the payloads of fragments resulting from different
fragmentation episodes, in different parts of the network, may be
overlapping subsets of the fragmented bundle's payload.
* The primary block of each fragment MUST differ from that of the
fragmented bundle, in that the bundle processing control flags of
the fragment MUST indicate that the bundle is a fragment and both
fragment offset and total application data unit length must be
provided. Additionally, the CRC of the primary block of the
fragmented bundle, if any, MUST be replaced in each fragment by a
new CRC computed for the primary block of that fragment.
* The payload blocks of fragments will differ from that of the
fragmented bundle as noted above.
* If the fragmented bundle is not a fragment or is the fragment with
offset zero, then all extension blocks of the fragmented bundle
MUST be replicated in the fragment whose offset is zero.
* Each of the fragmented bundle's extension blocks whose "Block must
be replicated in every fragment" flag is set to 1 MUST be
replicated in every fragment.
* Beyond these rules, rules for the replication of extension blocks
in the fragments must be defined in the specifications for those
extension block types.
5.9. Application Data Unit Reassembly
Note that the Bundle Fragmentation procedure described in Section 5.8
may result in the replacement of a single original bundle with an
arbitrarily large number of fragmentary bundles. In order to be
delivered at a destination node, the original bundle's payload must
be reassembled from the payloads of those fragments.
The "material extents" of a received fragment's payload are all
continuous sequences of bytes in that payload that do not overlap
with the material extents of the payloads of any previously received
fragments with the same source node ID and creation timestamp. If
the concatenation -- as informed by fragment offsets and payload
lengths -- of the material extents of the payloads of this fragment
and all previously received fragments with the same source node ID
and creation timestamp as this fragment forms a continuous byte array
whose length is equal to the total application data unit length noted
in the fragment's primary block, then:
* This byte array -- the reassembled ADU -- MUST replace the payload
of that fragment whose material extents include the extent at
offset zero. Note that this will enable delivery of the
reconstituted original bundle as described in Step 1 of
Section 5.7.
* The "Reassembly pending" retention constraint MUST be removed from
every other fragment with the same source node ID and creation
timestamp as this fragment.
Note: Reassembly of ADUs from fragments occurs at the nodes that are
members of destination endpoints as necessary; an ADU MAY also be
reassembled at some other node on the path to the destination.
5.10. Bundle Deletion
The steps in deleting a bundle are as follows:
Step 1: If the "request reporting of bundle deletion" flag in the
bundle's status report request field is set to 1 and if
status reporting is enabled, then a bundle deletion status
report citing the reason for deletion SHOULD be generated,
destined for the bundle's report-to endpoint ID.
Step 2: All of the bundle's retention constraints MUST be removed.
5.11. Discarding a Bundle
As soon as a bundle has no remaining retention constraints, it MAY be
discarded, thereby releasing any persistent storage that may have
been allocated to it.
5.12. Canceling a Transmission
When requested to cancel a specified transmission, where the bundle
created upon initiation of the indicated transmission has not yet
been discarded, the BPA MUST delete that bundle for the reason
"Transmission canceled". For this purpose, the procedure defined in
Section 5.10 MUST be followed.
6. Administrative Record Processing
6.1. Administrative Records
Administrative records are standard ADUs that are used in providing
some of the features of the Bundle Protocol. Bundle Protocol
administrative record types are registered in the IANA "Bundle
Administrative Record Types" registry [RFC5050]; of these, only
administrative record type 1, "Bundle status report", is defined for
BPv7 at this time. Note that additional types of administrative
records may be defined by supplementary DTN protocol specification
documents.
Every administrative record consists of:
* A record type code (an unsigned integer for which valid values are
as defined below).
* Record content in type-specific format.
Each BP administrative record SHALL be represented as a CBOR array
comprising two items.
The first item of the array SHALL be a record type code, which SHALL
be represented as a CBOR unsigned integer.
The second element of this array SHALL be the applicable CBOR
encoding of the content of the record. Details of the CBOR encoding
of administrative record type 1 are provided below. Details of the
CBOR encoding of other types of administrative records are included
in the specifications defining those records.
6.1.1. Bundle Status Reports
The transmission of "bundle status reports" under specified
conditions is an option that can be invoked when transmission of a
bundle is requested. These reports are intended to provide
information about how bundles are progressing through the system,
including notices of receipt, forwarding, final delivery, and
deletion. They are transmitted to the report-to endpoints of
bundles.
Each bundle status report SHALL be represented as a CBOR array. The
number of elements in the array SHALL be either 6 (if the subject
bundle is a fragment) or 4 (otherwise).
The first element of the bundle status report SHALL be bundle status
information represented as a CBOR array of at least four elements.
The first four elements of the bundle status information shall
provide information on the following four status assertions, in this
order:
* Reporting node received bundle.
* Reporting node forwarded the bundle.
* Reporting node delivered the bundle.
* Reporting node deleted the bundle.
Each element of the bundle status information SHALL be a bundle
status item encoded as a CBOR array.
The number of elements in each bundle status item SHALL be either 2
(if the value of the first element of the bundle status item is 1 AND
the "Report status time" flag was set to 1 in the bundle processing
control flags of the bundle whose status is being reported) or 1
(otherwise).
The first element of each bundle status item SHALL be a status
indicator, a Boolean value indicating whether or not the
corresponding bundle status is asserted, encoded as a CBOR Boolean
value. If present, the second element of each bundle status item
SHALL indicate the time (as reported by the local system clock; this
is an implementation matter) at which the indicated status was
asserted for this bundle, represented as a DTN time as described in
Section 4.2.6.
The second element of the bundle status report SHALL be the bundle
status report reason code explaining the value of the status
indicator, represented as a CBOR unsigned integer. Valid status
report reason codes are registered in the IANA "Bundle Status Report
Reason Codes" subregistry in the "Bundle Protocol" registry (see
Section 9.5). The initial contents of that registry are listed in
Table 1, but the list of status report reason codes provided here is
neither exhaustive nor exclusive; supplementary DTN protocol
specifications (including, but not restricted to, Bundle Protocol
Security [BPSEC]) may define additional reason codes.
+========+============================================+
| Value | Meaning |
+========+============================================+
| 0 | No additional information. |
+--------+--------------------------------------------+
| 1 | Lifetime expired. |
+--------+--------------------------------------------+
| 2 | Forwarded over unidirectional link. |
+--------+--------------------------------------------+
| 3 | Transmission canceled. |
+--------+--------------------------------------------+
| 4 | Depleted storage. |
+--------+--------------------------------------------+
| 5 | Destination endpoint ID unavailable. |
+--------+--------------------------------------------+
| 6 | No known route to destination from here. |
+--------+--------------------------------------------+
| 7 | No timely contact with next node on route. |
+--------+--------------------------------------------+
| 8 | Block unintelligible. |
+--------+--------------------------------------------+
| 9 | Hop limit exceeded. |
+--------+--------------------------------------------+
| 10 | Traffic pared (e.g., status reports). |
+--------+--------------------------------------------+
| 11 | Block unsupported. |
+--------+--------------------------------------------+
| 17-254 | Unassigned |
+--------+--------------------------------------------+
| 255 | Reserved |
+--------+--------------------------------------------+
Table 1: Status Report Reason Codes
The third element of the bundle status report SHALL be the source
node ID identifying the source of the bundle whose status is being
reported, represented as described in Section 4.2.5.1.1.
The fourth element of the bundle status report SHALL be the creation
timestamp of the bundle whose status is being reported, represented
as described in Section 4.2.7.
The fifth element of the bundle status report SHALL be present if and
only if the bundle whose status is being reported contained a
fragment offset. If present, it SHALL be the subject bundle's
fragment offset represented as a CBOR unsigned integer item.
The sixth element of the bundle status report SHALL be present if and
only if the bundle whose status is being reported contained a
fragment offset. If present, it SHALL be the length of the subject
bundle's payload represented as a CBOR unsigned integer item.
Note that the forwarding parameters (such as lifetime, applicable
security measures, etc.) of the bundle whose status is being reported
MAY be reflected in the parameters governing the forwarding of the
bundle that conveys a status report, but this is an implementation
matter. Bundle Protocol deployment experience to date has not been
sufficient to suggest any clear guidance on this topic.
6.2. Generation of Administrative Records
Whenever the application agent's administrative element is directed
by the BPA to generate an administrative record, the following
procedure must be followed:
Step 1: The administrative record must be constructed. If the
administrative record references a bundle and the referenced
bundle is a fragment, the administrative record MUST contain
the fragment offset and fragment length.
Step 2: A request for transmission of a bundle whose payload is this
administrative record MUST be presented to the BPA.
7. Services Required of the Convergence Layer
7.1. The Convergence Layer
The successful operation of the end-to-end Bundle Protocol depends on
the operation of underlying protocols at what is termed the
"convergence layer"; these protocols accomplish communication between
nodes. A wide variety of protocols may serve this purpose, so long
as each CLA provides a defined minimal set of services to the BPA.
This convergence-layer service specification enumerates those
services.
7.2. Summary of Convergence-Layer Services
Each CLA is expected to provide the following services to the BPA:
* sending a bundle to a bundle node that is reachable via the
convergence-layer protocol.
* notifying the BPA of the disposition of its data-sending
procedures with regard to a bundle, upon concluding those
procedures.
* delivering to the BPA a bundle that was sent by a bundle node via
the convergence-layer protocol.
The convergence-layer service interface specified here is neither
exhaustive nor exclusive. That is, supplementary DTN protocol
specifications (including, but not restricted to, Bundle Protocol
Security [BPSEC]) may expect CLAs that serve BP implementations
conforming to those protocols to provide additional services such as
reporting on the transmission and/or reception progress of individual
bundles (at completion and/or incrementally), retransmitting data
that were lost in transit, discarding bundle-conveying data units
that the convergence-layer protocol determines are corrupt or
inauthentic, or reporting on the integrity and/or authenticity of
delivered bundles.
In addition, the Bundle Protocol relies on the capabilities of
protocols at the convergence layer to minimize congestion in the
store-carry-forward overlay network. The potentially long round-trip
times characterizing delay-tolerant networks are incompatible with
end-to-end, reactive congestion-control mechanisms, so convergence-
layer protocols MUST provide rate limiting or congestion control.
8. Security Considerations
The Bundle Protocol security architecture and the available security
services are specified in an accompanying document, the Bundle
Protocol Security (BPSec) specification [BPSEC]. Whenever Bundle
Protocol security services (as opposed to the security services
provided by overlying application protocols or underlying
convergence-layer protocols) are required, those services SHALL be
provided by BPSec rather than by some other mechanism with the same
or similar scope.
A Bundle Protocol Agent (BPA) that sources, cryptographically
verifies, and/or accepts a bundle MUST implement support for BPSec.
Use of BPSec for any single bundle is optional.
The BPSec extensions to the Bundle Protocol enable each block of a
bundle (other than a BPSec extension block) to be individually
authenticated by a signature block (Block Integrity Block, or BIB)
and also enable each block of a bundle other than the primary block
(and the BPSec extension blocks themselves) to be individually
encrypted by a Block Confidentiality Block (BCB).
Because the security mechanisms are extension blocks that are
themselves inserted into the bundle, the protections they afford
apply while the bundle is at rest, awaiting transmission at the next
forwarding opportunity, as well as in transit.
Additionally, convergence-layer protocols that ensure authenticity of
communication between adjacent nodes in a BP network topology SHOULD
be used where available, to minimize the ability of unauthenticated
nodes to introduce inauthentic traffic into the network.
Convergence-layer protocols that ensure confidentiality of
communication between adjacent nodes in a BP network topology SHOULD
also be used where available, to minimize exposure of the bundle's
primary block and other cleartext blocks, thereby offering some
defense against traffic analysis.
In order to provide authenticity and/or confidentiality of
communication between BP nodes, the convergence-layer protocol
requires as input the name or names of the expected communication
peer(s). These must be supplied by the CLA. Details of the means by
which the CLA determines which CL endpoint name(s) must be provided
to the CL protocol are out of scope for this specification. Note,
though, that when the CL endpoint names are a function of BP endpoint
IDs, the correctness and authenticity of that mapping will be vital
to the overall security properties that the CL provides to the
system.
Note that, while the primary block must remain in the clear for
routing purposes, the Bundle Protocol could be protected against
traffic analysis to some extent by using bundle-in-bundle
encapsulation [BIBE] to tunnel bundles to a safe forward distribution
point: the encapsulated bundle could form the payload of an
encapsulating bundle, and that payload block could be encrypted by a
BCB.
Note that the generation of bundle status reports is disabled by
default because malicious initiation of bundle status reporting could
result in the transmission of extremely large numbers of bundles,
effecting a denial-of-service attack. Imposing bundle lifetime
overrides would constitute one defense against such an attack.
Note also that the reception of large numbers of fragmentary bundles
with very long lifetimes could constitute a denial-of-service attack,
occupying storage while pending reassembly that will never occur.
Imposing bundle lifetime overrides would, again, constitute one
defense against such an attack.
This protocol makes use of absolute timestamps for several purposes.
Provisions are included for nodes without accurate clocks to retain
most of the protocol functionality, but nodes that are unaware that
their clock is inaccurate may exhibit unexpected behavior.
9. IANA Considerations
The Bundle Protocol includes fields requiring registries managed by
IANA.
9.1. Bundle Block Types
The "Bundle Block Types" subregistry in the "Bundle Protocol"
registry has been augmented by adding a column identifying the
version of the Bundle Protocol (Bundle Protocol Version) that applies
to the values. IANA has added the following values, as described in
Section 4.3.1, to the "Bundle Block Types" registry with a value of
"7" for the Bundle Protocol Version. IANA has set the Bundle
Protocol Version to "6" or "6,7" for preexisting values in the
"Bundle Block Types" registry, as shown below.
+=================+=========+=========================+===========+
| Bundle Protocol | Value | Description | Reference |
| Version | | | |
+=================+=========+=========================+===========+
| none | 0 | Reserved | [RFC6255] |
+-----------------+---------+-------------------------+-----------+
| 6,7 | 1 | Bundle Payload Block | [RFC5050] |
| | | | [RFC9171] |
+-----------------+---------+-------------------------+-----------+
| 6 | 2 | Bundle Authentication | [RFC6257] |
| | | Block | |
+-----------------+---------+-------------------------+-----------+
| 6 | 3 | Payload Integrity Block | [RFC6257] |
+-----------------+---------+-------------------------+-----------+
| 6 | 4 | Payload Confidentiality | [RFC6257] |
| | | Block | |
+-----------------+---------+-------------------------+-----------+
| 6 | 5 | Previous-Hop Insertion | [RFC6259] |
| | | Block | |
+-----------------+---------+-------------------------+-----------+
| 7 | 6 | Previous node | [RFC9171] |
| | | (proximate sender) | |
+-----------------+---------+-------------------------+-----------+
| 7 | 7 | Bundle age (in | [RFC9171] |
| | | milliseconds) | |
+-----------------+---------+-------------------------+-----------+
| 6 | 8 | Metadata Extension | [RFC6258] |
| | | Block | |
+-----------------+---------+-------------------------+-----------+
| 6 | 9 | Extension Security | [RFC6257] |
| | | Block | |
+-----------------+---------+-------------------------+-----------+
| 7 | 10 | Hop count (#prior xmit | [RFC9171] |
| | | attempts) | |
+-----------------+---------+-------------------------+-----------+
| 7 | 11-191 | Unassigned | |
+-----------------+---------+-------------------------+-----------+
| 6,7 | 192-255 | Reserved for Private | [RFC5050] |
| | | and/or Experimental Use | [RFC9171] |
+-----------------+---------+-------------------------+-----------+
Table 2: "Bundle Block Types" Registry
9.2. Primary Bundle Protocol Version
IANA has added the following value to the "Primary Bundle Protocol
Version" subregistry in the "Bundle Protocol" registry.
+=======+=============+===========+
| Value | Description | Reference |
+=======+=============+===========+
| 7 | Assigned | [RFC9171] |
+-------+-------------+-----------+
Table 3: "Primary Bundle
Protocol Version" Registry
Values 8-255 (rather than 7-255) are now Unassigned.
9.3. Bundle Processing Control Flags
The "Bundle Processing Control Flags" subregistry in the "Bundle
Protocol" registry has been augmented by adding a column identifying
the version of the Bundle Protocol (Bundle Protocol Version) that
applies to the new values. IANA has added the following values, as
described in Section 4.2.3, to the "Bundle Processing Control Flags"
registry with a value of "7" for the Bundle Protocol Version. IANA
has set the Bundle Protocol Version to the value "6" or "6,7" for
preexisting values in the "Bundle Processing Control Flags" registry,
as shown below.
+=================+=================+===================+===========+
| Bundle Protocol | Bit Position | Description | Reference |
| Version | (right to | | |
| | left) | | |
+=================+=================+===================+===========+
| 6,7 | 0 | Bundle is a | [RFC5050] |
| | | fragment | [RFC9171] |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 1 | ADU is an | [RFC5050] |
| | | administrative | [RFC9171] |
| | | record | |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 2 | Bundle must not | [RFC5050] |
| | | be fragmented | [RFC9171] |
+-----------------+-----------------+-------------------+-----------+
| 6 | 3 | Custody transfer | [RFC5050] |
| | | is requested | |
+-----------------+-----------------+-------------------+-----------+
| 6 | 4 | Destination | [RFC5050] |
| | | endpoint is a | |
| | | singleton | |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 5 | Acknowledgement | [RFC5050] |
| | | by application is | [RFC9171] |
| | | requested | |
+-----------------+-----------------+-------------------+-----------+
| 7 | 6 | Status time | [RFC9171] |
| | | requested in | |
| | | reports | |
+-----------------+-----------------+-------------------+-----------+
| 6 | 7-8 | Class of service: | [RFC5050] |
| | | priority | |
+-----------------+-----------------+-------------------+-----------+
| 6 | 9-13 | Class of service: | [RFC5050] |
| | | reserved | |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 14 | Request reporting | [RFC5050] |
| | | of bundle | [RFC9171] |
| | | reception | |
+-----------------+-----------------+-------------------+-----------+
| 6 | 15 | Request reporting | [RFC5050] |
| | | of custody | |
| | | acceptance | |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 16 | Request reporting | [RFC5050] |
| | | of bundle | [RFC9171] |
| | | forwarding | |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 17 | Request reporting | [RFC5050] |
| | | of bundle | [RFC9171] |
| | | delivery | |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 18 | Request reporting | [RFC5050] |
| | | of bundle | [RFC9171] |
| | | deletion | |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 19 | Reserved | [RFC5050] |
| | | | [RFC9171] |
+-----------------+-----------------+-------------------+-----------+
| 6,7 | 20 | Reserved | [RFC5050] |
| | | | [RFC9171] |
+-----------------+-----------------+-------------------+-----------+
| | 21-63 | Unassigned | |
+-----------------+-----------------+-------------------+-----------+
Table 4: "Bundle Processing Control Flags" Registry
9.4. Block Processing Control Flags
The "Block Processing Control Flags" subregistry in the "Bundle
Protocol" registry has been augmented by adding a column identifying
the version of the Bundle Protocol (Bundle Protocol Version) that
applies to the related BP version. IANA has set the Bundle Protocol
Version to the value "6" or "6,7" for preexisting values in the
"Bundle Processing Control Flags" registry, as shown below.
+=================+==============+====================+===========+
| Bundle Protocol | Bit Position | Description | Reference |
| Version | (right to | | |
| | left) | | |
+=================+==============+====================+===========+
| 6,7 | 0 | Block must be | [RFC5050] |
| | | replicated in | [RFC9171] |
| | | every fragment | |
+-----------------+--------------+--------------------+-----------+
| 6,7 | 1 | Transmit status | [RFC5050] |
| | | report if block | [RFC9171] |
| | | can't be processed | |
+-----------------+--------------+--------------------+-----------+
| 6,7 | 2 | Delete bundle if | [RFC5050] |
| | | block can't be | [RFC9171] |
| | | processed | |
+-----------------+--------------+--------------------+-----------+
| 6 | 3 | Last block | [RFC5050] |
+-----------------+--------------+--------------------+-----------+
| 6,7 | 4 | Discard block if | [RFC5050] |
| | | it can't be | [RFC9171] |
| | | processed | |
+-----------------+--------------+--------------------+-----------+
| 6 | 5 | Block was | [RFC5050] |
| | | forwarded without | |
| | | being processed | |
+-----------------+--------------+--------------------+-----------+
| 6 | 6 | Block contains an | [RFC5050] |
| | | EID-reference | |
| | | field | |
+-----------------+--------------+--------------------+-----------+
| | 7-63 | Unassigned | |
+-----------------+--------------+--------------------+-----------+
Table 5: "Block Processing Control Flags" Registry
9.5. Bundle Status Report Reason Codes
The "Bundle Status Report Reason Codes" subregistry in the "Bundle
Protocol" registry has been augmented by adding a column identifying
the version of the Bundle Protocol (Bundle Protocol Version) that
applies to the new values. IANA has added the following values, as
described in Section 6.1.1, to the "Bundle Status Report Reason
Codes" registry with a value of "7" for the Bundle Protocol Version.
IANA has set the Bundle Protocol Version to the value "6,7" for
preexisting values in the "Bundle Status Report Reason Codes"
registry, as shown below.
+=================+========+========================+===========+
| Bundle Protocol | Value | Description | Reference |
| Version | | | |
+=================+========+========================+===========+
| 6,7 | 0 | No additional | [RFC5050] |
| | | information | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 6,7 | 1 | Lifetime expired | [RFC5050] |
| | | | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 6,7 | 2 | Forwarded over | [RFC5050] |
| | | unidirectional link | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 6,7 | 3 | Transmission canceled | [RFC5050] |
| | | | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 6,7 | 4 | Depleted storage | [RFC5050] |
| | | | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 6,7 | 5 | Destination endpoint | [RFC5050] |
| | | ID unavailable | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 6,7 | 6 | No known route to | [RFC5050] |
| | | destination from here | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 6,7 | 7 | No timely contact with | [RFC5050] |
| | | next node on route | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 6,7 | 8 | Block unintelligible | [RFC5050] |
| | | | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 7 | 9 | Hop limit exceeded | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 7 | 10 | Traffic pared | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| 7 | 11 | Block unsupported | [RFC9171] |
+-----------------+--------+------------------------+-----------+
| | 17-254 | Unassigned | |
+-----------------+--------+------------------------+-----------+
| 6,7 | 255 | Reserved | [RFC6255] |
| | | | [RFC9171] |
+-----------------+--------+------------------------+-----------+
Table 6: "Bundle Status Report Reason Codes" Registry
9.6. Bundle Protocol URI Scheme Types
The Bundle Protocol has a URI scheme type field -- an unsigned
integer of indefinite length -- for which IANA has created, and will
maintain, a new "Bundle Protocol URI Scheme Types" subregistry in the
"Bundle Protocol" registry. The "Bundle Protocol URI Scheme Types"
registry governs a namespace of unsigned integers. Initial values
for the "Bundle Protocol URI Scheme Types" registry are given below.
The registration policy for this registry is Standards Action
[RFC8126]. The allocation should only be granted for a Standards
Track RFC approved by the IESG.
The range of values is provided as unsigned integers.
Each assignment consists of a URI scheme type name and its associated
description, a reference to the document that defines the URI scheme,
and a reference to the document that defines the use of this URI
scheme in BP endpoint IDs (including the CBOR encoding of those
endpoint IDs in transmitted bundles).
+===========+==============+================+================+
| Value | Description | BP Utilization | URI Definition |
| | | Reference | Reference |
+===========+==============+================+================+
| 0 | Reserved | n/a | |
+-----------+--------------+----------------+----------------+
| 1 | dtn | [RFC9171] | [RFC9171] |
+-----------+--------------+----------------+----------------+
| 2 | ipn | [RFC9171] | [RFC6260] |
| | | | [RFC9171] |
+-----------+--------------+----------------+----------------+
| 3-254 | Unassigned | n/a | |
+-----------+--------------+----------------+----------------+
| 255-65535 | Reserved | n/a | |
+-----------+--------------+----------------+----------------+
| >65535 | Reserved for | n/a | |
| | Private Use | | |
+-----------+--------------+----------------+----------------+
Table 7: "Bundle Protocol URI Scheme Types" Registry
9.7. dtn URI Scheme
In the "Uniform Resource Identifier (URI) Schemes" (uri-schemes)
registry, IANA has updated the registration of the URI scheme with
the string "dtn" as the scheme name, as follows:
URI scheme name: "dtn"
Status: Permanent
Applications and/or protocols that use this URI scheme name: The
Delay-Tolerant Networking (DTN) Bundle Protocol (BP).
Contact: Scott Burleigh <sburleig.sb@gmail.com>
Change controller: IETF (iesg@ietf.org)
Reference: [RFC9171]
9.8. ipn URI Scheme
In the "Uniform Resource Identifier (URI) Schemes" (uri-schemes)
registry, IANA has updated the registration of the URI scheme with
the string "ipn" as the scheme name, originally documented in RFC
6260 [RFC6260], as follows.
URI scheme name: "ipn"
Status: Permanent
Applications and/or protocols that use this URI scheme name: The
Delay-Tolerant Networking (DTN) Bundle Protocol (BP).
Contact: Scott Burleigh <sburleig.sb@gmail.com>
Change controller: IETF (iesg@ietf.org)
Reference: [RFC9171]
10. References
10.1. Normative References
[BPSEC] Birrane, III, E. and K. McKeever, "Bundle Protocol
Security (BPSec)", RFC 9172, DOI 10.17487/RFC9172, January
2022, <https://www.rfc-editor.org/info/rfc9172>.
[CRC16] ITU-T, "X.25: Interface between Data Terminal Equipment
(DTE) and Data Circuit-terminating Equipment (DCE) for
terminals operating in the packet mode and connected to
public data networks by dedicated circuit", p. 9,
Section 2.2.7.4, ITU-T Recommendation X.25, October 1996,
<https://www.itu.int/rec/T-REC-X.25-199610-I/>.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>.
[RFC4960] Stewart, R., Ed., "Stream Control Transmission Protocol",
RFC 4960, DOI 10.17487/RFC4960, September 2007,
<https://www.rfc-editor.org/info/rfc4960>.
[RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax
Specifications: ABNF", STD 68, RFC 5234,
DOI 10.17487/RFC5234, January 2008,
<https://www.rfc-editor.org/info/rfc5234>.
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC8949] Bormann, C. and P. Hoffman, "Concise Binary Object
Representation (CBOR)", STD 94, RFC 8949,
DOI 10.17487/RFC8949, December 2020,
<https://www.rfc-editor.org/info/rfc8949>.
[SABR] Consultative Committee for Space Data Systems, "Schedule-
Aware Bundle Routing", CCSDS Recommended
Standard 734.3-B-1, July 2019,
<https://public.ccsds.org/Pubs/734x3b1.pdf>.
[TCPCL] Sipos, B., Demmer, M., Ott, J., and S. Perreault, "Delay-
Tolerant Networking TCP Convergence-Layer Protocol Version
4", RFC 9174, DOI 10.17487/RFC9174, January 2022,
<https://www.rfc-editor.org/info/rfc9174>.
[URI] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform
Resource Identifier (URI): Generic Syntax", STD 66,
RFC 3986, DOI 10.17487/RFC3986, January 2005,
<https://www.rfc-editor.org/info/rfc3986>.
[URIREG] Thaler, D., Ed., Hansen, T., and T. Hardie, "Guidelines
and Registration Procedures for URI Schemes", BCP 35,
RFC 7595, DOI 10.17487/RFC7595, June 2015,
<https://www.rfc-editor.org/info/rfc7595>.
10.2. Informative References
[ARCH] Cerf, V., Burleigh, S., Hooke, A., Torgerson, L., Durst,
R., Scott, K., Fall, K., and H. Weiss, "Delay-Tolerant
Networking Architecture", RFC 4838, DOI 10.17487/RFC4838,
April 2007, <https://www.rfc-editor.org/info/rfc4838>.
[BIBE] Burleigh, S., "Bundle-in-Bundle Encapsulation", Work in
Progress, Internet-Draft, draft-ietf-dtn-bibect-03, 18
February 2020, <https://datatracker.ietf.org/doc/html/
draft-ietf-dtn-bibect-03>.
[RFC3987] Duerst, M. and M. Suignard, "Internationalized Resource
Identifiers (IRIs)", RFC 3987, DOI 10.17487/RFC3987,
January 2005, <https://www.rfc-editor.org/info/rfc3987>.
[RFC5050] Scott, K. and S. Burleigh, "Bundle Protocol
Specification", RFC 5050, DOI 10.17487/RFC5050, November
2007, <https://www.rfc-editor.org/info/rfc5050>.
[RFC6255] Blanchet, M., "Delay-Tolerant Networking Bundle Protocol
IANA Registries", RFC 6255, DOI 10.17487/RFC6255, May
2011, <https://www.rfc-editor.org/info/rfc6255>.
[RFC6257] Symington, S., Farrell, S., Weiss, H., and P. Lovell,
"Bundle Security Protocol Specification", RFC 6257,
DOI 10.17487/RFC6257, May 2011,
<https://www.rfc-editor.org/info/rfc6257>.
[RFC6258] Symington, S., "Delay-Tolerant Networking Metadata
Extension Block", RFC 6258, DOI 10.17487/RFC6258, May
2011, <https://www.rfc-editor.org/info/rfc6258>.
[RFC6259] Symington, S., "Delay-Tolerant Networking Previous-Hop
Insertion Block", RFC 6259, DOI 10.17487/RFC6259, May
2011, <https://www.rfc-editor.org/info/rfc6259>.
[RFC6260] Burleigh, S., "Compressed Bundle Header Encoding (CBHE)",
RFC 6260, DOI 10.17487/RFC6260, May 2011,
<https://www.rfc-editor.org/info/rfc6260>.
[RFC7143] Chadalapaka, M., Satran, J., Meth, K., and D. Black,
"Internet Small Computer System Interface (iSCSI) Protocol
(Consolidated)", RFC 7143, DOI 10.17487/RFC7143, April
2014, <https://www.rfc-editor.org/info/rfc7143>.
[RFC8126] Cotton, M., Leiba, B., and T. Narten, "Guidelines for
Writing an IANA Considerations Section in RFCs", BCP 26,
RFC 8126, DOI 10.17487/RFC8126, June 2017,
<https://www.rfc-editor.org/info/rfc8126>.
[SIGC] Fall, K., "A Delay-Tolerant Network Architecture for
Challenged Internets", SIGCOMM 2003,
DOI 10.1145/863955.863960, August 2003,
<https://dl.acm.org/doi/10.1145/863955.863960>.
Appendix A. Significant Changes from RFC 5050
This document makes the following significant changes from RFC 5050:
* Clarifies the difference between transmission and forwarding.
* Migrates custody transfer to the bundle-in-bundle encapsulation
specification [BIBE].
* Introduces the concept of "node ID" as functionally distinct from
endpoint ID, while having the same syntax.
* Restructures primary block, making it immutable. Adds optional
CRC.
* Adds optional CRCs to non-primary blocks.
* Adds block ID number to canonical block format (to support BPSec).
* Adds definition of Bundle Age extension block.
* Adds definition of Previous Node extension block.
* Adds definition of Hop Count extension block.
* Removes Quality of Service markings.
* Changes from Self-Delimiting Numeric Values (SDNVs) to CBOR
encoding.
* Adds lifetime overrides.
* Clarifies that time values are denominated in milliseconds, not
seconds.
Appendix B. CDDL Expression
For informational purposes, Carsten Bormann and Brian Sipos have
kindly provided an expression of the Bundle Protocol specification in
the Concise Data Definition Language (CDDL). That CDDL expression is
presented below. Note that wherever the CDDL expression is in
disagreement with the textual representation of the BP specification
presented in the earlier sections of this document, the textual
representation rules.
bpv7_start = bundle / #6.55799(bundle)
; Times before 2000 are invalid
dtn-time = uint
; CRC enumerated type
crc-type = &(
crc-none: 0,
crc-16bit: 1,
crc-32bit: 2
)
; Either 16-bit or 32-bit
crc-value = (bstr .size 2) / (bstr .size 4)
creation-timestamp = [
dtn-time, ; absolute time of creation
sequence: uint ; sequence within the time
]
eid = $eid .within eid-structure
eid-structure = [
uri-code: uint,
SSP: any
]
$eid /= [
uri-code: 1,
SSP: (tstr / 0)
]
$eid /= [
uri-code: 2,
SSP: [
nodenum: uint,
servicenum: uint
]
]
; The root bundle array
bundle = [primary-block, *extension-block, payload-block]
primary-block = [
version: 7,
bundle-control-flags,
crc-type,
destination: eid,
source-node: eid,
report-to: eid,
creation-timestamp,
lifetime: uint,
? (
fragment-offset: uint,
total-application-data-length: uint
),
? crc-value,
]
bundle-control-flags = uint .bits bundleflagbits
bundleflagbits = &(
reserved: 20,
reserved: 19,
bundle-deletion-status-reports-are-requested: 18,
bundle-delivery-status-reports-are-requested: 17,
bundle-forwarding-status-reports-are-requested: 16,
reserved: 15,
bundle-reception-status-reports-are-requested: 14,
reserved: 13,
reserved: 12,
reserved: 11,
reserved: 10,
reserved: 9,
reserved: 8,
reserved: 7,
status-time-is-requested-in-all-status-reports: 6,
user-application-acknowledgement-is-requested: 5,
reserved: 4,
reserved: 3,
bundle-must-not-be-fragmented: 2,
payload-is-an-administrative-record: 1,
bundle-is-a-fragment: 0
)
; Abstract shared structure of all non-primary blocks
canonical-block-structure = [
block-type-code: uint,
block-number: uint,
block-control-flags,
crc-type,
; Each block type defines the content within the byte string
block-type-specific-data,
? crc-value
]
block-control-flags = uint .bits blockflagbits
blockflagbits = &(
reserved: 7,
reserved: 6,
reserved: 5,
block-must-be-removed-from-bundle-if-it-cannot-be-processed: 4,
reserved: 3,
bundle-must-be-deleted-if-block-cannot-be-processed: 2,
status-report-must-be-transmitted-if-block-cannot-be-processed:
1,
block-must-be-replicated-in-every-fragment: 0
)
block-type-specific-data = bstr / #6.24(bstr)
; Actual CBOR data embedded in a byte string, with optional tag to
indicate so.
; Additional plain bstr allows ciphertext data.
embedded-cbor<Item> = (bstr .cbor Item) / #6.24(bstr .cbor Item) /
bstr
; Extension block type, which does not specialize other than the
code/number
extension-block =
$extension-block .within canonical-block-structure
; Generic shared structure of all non-primary blocks
extension-block-use<CodeValue, BlockData> = [
block-type-code: CodeValue,
block-number: (uint .gt 1),
block-control-flags,
crc-type,
BlockData,
? crc-value
]
; Payload block type
payload-block = payload-block-structure .within canonical-block-
structure
payload-block-structure = [
block-type-code: 1,
block-number: 1,
block-control-flags,
crc-type,
$payload-block-data,
? crc-value
]
; Arbitrary payload data, including non-CBOR byte string
$payload-block-data /= block-type-specific-data
; Administrative record as a payload data specialization
$payload-block-data /= embedded-cbor<admin-record>
admin-record = $admin-record .within admin-record-structure
admin-record-structure = [
record-type-code: uint,
record-content: any
]
; Only one defined record type
$admin-record /= [1, status-record-content]
status-record-content = [
bundle-status-information,
status-report-reason-code: uint,
source-node-eid: eid,
subject-creation-timestamp: creation-timestamp,
? (
subject-payload-offset: uint,
subject-payload-length: uint
)
]
bundle-status-information = [
reporting-node-received-bundle: status-info-content,
reporting-node-forwarded-bundle: status-info-content,
reporting-node-delivered-bundle: status-info-content,
reporting-node-deleted-bundle: status-info-content
]
status-info-content = [
status-indicator: bool,
? timestamp: dtn-time
]
; Previous Node extension block
$extension-block /=
extension-block-use<6, embedded-cbor<ext-data-previous-node>>
ext-data-previous-node = eid
; Bundle Age extension block
$extension-block /=
extension-block-use<7, embedded-cbor<ext-data-bundle-age>>
ext-data-bundle-age = uint
; Hop Count extension block
$extension-block /=
extension-block-use<10, embedded-cbor<ext-data-hop-count>>
ext-data-hop-count = [
hop-limit: uint,
hop-count: uint
]
Acknowledgments
This work is freely adapted from RFC 5050, which was an effort of the
Delay-Tolerant Networking Research Group. The following DTNRG
participants contributed significant technical material and/or inputs
to that document: Dr. Vinton Cerf of Google; Scott Burleigh, Adrian
Hooke, and Leigh Torgerson of the Jet Propulsion Laboratory; Michael
Demmer of the University of California at Berkeley; Robert Durst,
Keith Scott, and Susan Symington of The MITRE Corporation; Kevin Fall
of Carnegie Mellon University; Stephen Farrell of Trinity College
Dublin; Howard Weiss and Peter Lovell of SPARTA, Inc.; and Manikantan
Ramadas of Ohio University.
Scott Burleigh would like to thank the Jet Propulsion Laboratory,
California Institute of Technology, for its generous and sustained
support of this work.
Authors' Addresses
Scott Burleigh
IPNGROUP
1435 Woodhurst Blvd.
McLean, VA 22102
United States of America
Email: sburleig.sb@gmail.com
Kevin Fall
Roland Computing Services
3871 Piedmont Ave. Suite 8
Oakland, CA 94611
United States of America
Email: kfall+rcs@kfall.com
Edward J. Birrane, III
Johns Hopkins University Applied Physics Laboratory
11100 Johns Hopkins Rd
Laurel, MD 20723
United States of America
Phone: +1 443 778 7423
Email: Edward.Birrane@jhuapl.edu
|