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
2991
2992
2993
2994
|
Internet Engineering Task Force (IETF) A. Begen
Request for Comments: 8866 Networked Media
Obsoletes: 4566 P. Kyzivat
Category: Standards Track
ISSN: 2070-1721 C. Perkins
University of Glasgow
M. Handley
UCL
January 2021
SDP: Session Description Protocol
Abstract
This memo defines the Session Description Protocol (SDP). SDP is
intended for describing multimedia sessions for the purposes of
session announcement, session invitation, and other forms of
multimedia session initiation. This document obsoletes RFC 4566.
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/rfc8866.
Copyright Notice
Copyright (c) 2021 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 Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
This document may contain material from IETF Documents or IETF
Contributions published or made publicly available before November
10, 2008. The person(s) controlling the copyright in some of this
material may not have granted the IETF Trust the right to allow
modifications of such material outside the IETF Standards Process.
Without obtaining an adequate license from the person(s) controlling
the copyright in such materials, this document may not be modified
outside the IETF Standards Process, and derivative works of it may
not be created outside the IETF Standards Process, except to format
it for publication as an RFC or to translate it into languages other
than English.
Table of Contents
1. Introduction
2. Glossary of Terms
3. Examples of SDP Usage
3.1. Session Initiation
3.2. Streaming Media
3.3. Email and the World Wide Web
3.4. Multicast Session Announcement
4. Requirements and Recommendations
4.1. Media and Transport Information
4.2. Timing Information
4.3. Obtaining Further Information about a Session
4.4. Internationalization
5. SDP Specification
5.1. Protocol Version ("v=")
5.2. Origin ("o=")
5.3. Session Name ("s=")
5.4. Session Information ("i=")
5.5. URI ("u=")
5.6. Email Address and Phone Number ("e=" and "p=")
5.7. Connection Information ("c=")
5.8. Bandwidth Information ("b=")
5.9. Time Active ("t=")
5.10. Repeat Times ("r=")
5.11. Time Zone Adjustment ("z=")
5.12. Encryption Keys ("k=")
5.13. Attributes ("a=")
5.14. Media Descriptions ("m=")
6. SDP Attributes
6.1. cat (Category)
6.2. keywds (Keywords)
6.3. tool
6.4. ptime (Packet Time)
6.5. maxptime (Maximum Packet Time)
6.6. rtpmap
6.7. Media Direction Attributes
6.7.1. recvonly (Receive-Only)
6.7.2. sendrecv (Send-Receive)
6.7.3. sendonly (Send-Only)
6.7.4. inactive
6.8. orient (Orientation)
6.9. type (Conference Type)
6.10. charset (Character Set)
6.11. sdplang (SDP Language)
6.12. lang (Language)
6.13. framerate (Frame Rate)
6.14. quality
6.15. fmtp (Format Parameters)
7. Security Considerations
8. IANA Considerations
8.1. The "application/sdp" Media Type
8.2. Registration of SDP Parameters with IANA
8.2.1. Registration Procedure
8.2.2. Media Types (<media>)
8.2.3. Transport Protocols (<proto>)
8.2.4. Attribute Names (<attribute-name>)
8.2.5. Bandwidth Specifiers (<bwtype>)
8.2.6. Network Types (<nettype>)
8.2.7. Address Types (<addrtype>)
8.3. Encryption Key Access Methods (OBSOLETE)
9. SDP Grammar
10. Summary of Changes from RFC 4566
11. References
11.1. Normative References
11.2. Informative References
Acknowledgements
Authors' Addresses
1. Introduction
When initiating multimedia teleconferences, voice-over-IP calls,
streaming video, or other sessions, there is a requirement to convey
media details, transport addresses, and other session description
metadata to the participants.
SDP provides a standard representation for such information,
irrespective of how that information is transported. SDP is purely a
format for session description -- it does not incorporate a transport
protocol, and it is intended to use different transport protocols as
appropriate, including the Session Announcement Protocol (SAP)
[RFC2974], Session Initiation Protocol (SIP) [RFC3261], Real-Time
Streaming Protocol (RTSP) [RFC7826], electronic mail [RFC5322] using
the MIME extensions [RFC2045], and the Hypertext Transport Protocol
(HTTP) [RFC7230].
SDP is intended to be general purpose so that it can be used in a
wide range of network environments and applications. However, it is
not intended to support negotiation of session content or media
encodings: this is viewed as outside the scope of session
description.
This memo obsoletes [RFC4566]. The changes relative to [RFC4566] are
outlined in Section 10 of this memo.
2. Glossary of Terms
The following terms are used in this document and have specific
meaning within the context of this document.
Session Description: A well-defined format for conveying sufficient
information to discover and participate in a multimedia session.
Media Description: A Media Description contains the information
needed for one party to establish an application-layer network
protocol connection to another party. It starts with an "m=" line
and is terminated by either the next "m=" line or by the end of
the session description.
Session-Level Section: This refers to the parts that are not media
descriptions, whereas the session description refers to the whole
body that includes the session-level section and the media
description(s).
The terms "multimedia conference" and "multimedia session" are used
in this document as defined in [RFC7656]. The terms "session" and
"multimedia session" are used interchangeably 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. Examples of SDP Usage
3.1. Session Initiation
The Session Initiation Protocol (SIP) [RFC3261] is an application-
layer control protocol for creating, modifying, and terminating
sessions such as Internet multimedia conferences, Internet telephone
calls, and multimedia distribution. The SIP messages used to create
sessions carry session descriptions that allow participants to agree
on a set of compatible media types [RFC6838]. These session
descriptions are commonly formatted using SDP. When used with SIP,
the offer/answer model [RFC3264] provides a limited framework for
negotiation using SDP.
3.2. Streaming Media
The Real-Time Streaming Protocol (RTSP) [RFC7826], is an application-
level protocol for control over the delivery of data with real-time
properties. RTSP provides an extensible framework to enable
controlled, on-demand delivery of real-time data, such as audio and
video. An RTSP client and server negotiate an appropriate set of
parameters for media delivery, partially using SDP syntax to describe
those parameters.
3.3. Email and the World Wide Web
Alternative means of conveying session descriptions include
electronic mail and the World Wide Web (WWW). For both email and WWW
distribution, the media type "application/sdp" is used. This enables
the automatic launching of applications for participation in the
session from the WWW client or mail reader in a standard manner.
Note that descriptions of multicast sessions sent only via email or
the WWW do not have the property that the receiver of a session
description can necessarily receive the session because the multicast
sessions may be restricted in scope, and access to the WWW server or
reception of email is possibly outside this scope.
3.4. Multicast Session Announcement
In order to assist the advertisement of multicast multimedia
conferences and other multicast sessions, and to communicate the
relevant session setup information to prospective participants, a
distributed session directory may be used. An instance of such a
session directory periodically sends packets containing a description
of the session to a well-known multicast group. These advertisements
are received by other session directories such that potential remote
participants can use the session description to start the tools
required to participate in the session.
One protocol used to implement such a distributed directory is the
SAP [RFC2974]. SDP provides the recommended session description
format for such session announcements.
4. Requirements and Recommendations
The purpose of SDP is to convey information about media streams in
multimedia sessions to allow the recipients of a session description
to participate in the session. SDP is primarily intended for use
with Internet protocols, although it is sufficiently general that it
can describe multimedia conferences in other network environments.
Media streams can be many-to-many. Sessions need not be continually
active.
Thus far, multicast-based sessions on the Internet have differed from
many other forms of conferencing in that anyone receiving the traffic
can join the session (unless the session traffic is encrypted). In
such an environment, SDP serves two primary purposes. It is a means
to communicate the existence of a session, and it is a means to
convey sufficient information to enable joining and participating in
the session. In a unicast environment, only the latter purpose is
likely to be relevant.
An SDP description includes the following:
* Session name and purpose
* Time(s) the session is active
* The media comprising the session
* Information needed to receive those media (addresses, ports,
formats, etc.)
As resources necessary to participate in a session may be limited,
some additional information may also be desirable:
* Information about the bandwidth to be used by the session
* Contact information for the person responsible for the session
In general, SDP must convey sufficient information to enable
applications to join a session (with the possible exception of
encryption keys) and to announce the resources to be used to any
nonparticipants that may need to know. (This latter feature is
primarily useful when SDP is used with a multicast session
announcement protocol.)
4.1. Media and Transport Information
An SDP description includes the following media information:
* The type of media (video, audio, etc.)
* The media transport protocol (RTP/UDP/IP, H.320, etc.)
* The format of the media (H.261 video, MPEG video, etc.)
In addition to media format and transport protocol, SDP conveys
address and port details. For an IP multicast session, these
comprise:
* The multicast group address for media
* The transport port for media
This address and port are the destination address and destination
port of the multicast stream, whether being sent, received, or both.
For unicast IP sessions, the following are conveyed:
* The remote address for media
* The remote transport port for media
The semantics of the address and port depend on context. Typically,
this SHOULD be the remote address and remote port to which media is
to be sent or received. Details may differ based on the network
type, address type, protocol, and media specified, and whether the
SDP is being distributed as an advertisement or negotiated in an
offer/answer [RFC3264] exchange. (E.g., Some address types or
protocols may not have a notion of port.) Deviating from typical
behavior should be done cautiously since this complicates
implementations (including middleboxes that must parse the addresses
to open Network Address Translation (NAT) or firewall pinholes).
4.2. Timing Information
Sessions may be either bounded or unbounded in time. Whether or not
they are bounded, they may be only active at specific times. SDP can
convey:
* An arbitrary list of start and stop times bounding the session
* For each bound, repeat times such as "every Wednesday at 10am for
one hour"
This timing information is globally consistent, irrespective of local
time zone or daylight saving time (see Section 5.9).
4.3. Obtaining Further Information about a Session
A session description could convey enough information to decide
whether or not to participate in a session. SDP may include
additional pointers in the form of Uniform Resource Identifiers
(URIs) [RFC3986] for more information about the session. (Note that
use of URIs to indicate remote resources is subject to the security
considerations from [RFC3986].)
4.4. Internationalization
The SDP specification recommends the use of the ISO 10646 character
set in the UTF-8 encoding [RFC3629] to allow many different languages
to be represented. However, to assist in compact representations,
SDP also allows other character sets such as [ISO.8859-1.1998] to be
used when desired. Internationalization only applies to free-text
subfields (session name and background information), and not to SDP
as a whole.
5. SDP Specification
An SDP description is denoted by the media type "application/sdp"
(See Section 8).
An SDP description is entirely textual. SDP field names and
attribute names use only the US-ASCII subset of UTF-8 [RFC3629], but
textual fields and attribute values MAY use the full ISO 10646
character set in UTF-8 encoding, or some other character set defined
by the "a=charset:" attribute (Section 6.10). Field and attribute
values that use the full UTF-8 character set are never directly
compared, hence there is no requirement for UTF-8 normalization. The
textual form, as opposed to a binary encoding such as ASN.1 or XDR,
was chosen to enhance portability, to enable a variety of transports
to be used, and to allow flexible, text-based toolkits to be used to
generate and process session descriptions. However, since SDP may be
used in environments where the maximum permissible size of a session
description is limited, the encoding is deliberately compact. Also,
since descriptions may be transported via very unreliable means or
damaged by an intermediate caching server, the encoding was designed
with strict order and formatting rules so that most errors would
result in malformed session descriptions that could be detected
easily and discarded.
An SDP description consists of a number of lines of text of the form:
<type>=<value>
where <type> is exactly one case-significant character and <value> is
structured text whose format depends on <type>. In general, <value>
is either a number of subfields delimited by a single space character
or a free format string, and is case-significant unless a specific
field defines otherwise. Whitespace separators are not used on
either side of the "=" sign, however, the value can contain a leading
whitespace as part of its syntax, i.e., that whitespace is part of
the value.
An SDP description MUST conform to the syntax defined in Section 9.
The following is an overview of the syntax.
An SDP description consists of a session-level section followed by
zero or more media descriptions. The session-level section starts
with a "v=" line and continues to the first media description (or the
end of the whole description, whichever comes first). Each media
description starts with an "m=" line and continues to the next media
description or the end of the whole session description, whichever
comes first. In general, session-level values are the default for
all media unless overridden by an equivalent media-level value.
Some lines in each description are required and some are optional,
but when present, they must appear in exactly the order given here.
(The fixed order greatly enhances error detection and allows for a
simple parser). In the following overview, optional items are marked
with a "*".
Session description
v= (protocol version)
o= (originator and session identifier)
s= (session name)
i=* (session information)
u=* (URI of description)
e=* (email address)
p=* (phone number)
c=* (connection information -- not required if included in
all media descriptions)
b=* (zero or more bandwidth information lines)
One or more time descriptions:
("t=", "r=" and "z=" lines; see below)
k=* (obsolete)
a=* (zero or more session attribute lines)
Zero or more media descriptions
Time description
t= (time the session is active)
r=* (zero or more repeat times)
z=* (optional time zone offset line)
Media description, if present
m= (media name and transport address)
i=* (media title)
c=* (connection information -- optional if included at
session level)
b=* (zero or more bandwidth information lines)
k=* (obsolete)
a=* (zero or more media attribute lines)
The set of type letters is deliberately small and not intended to be
extensible -- an SDP parser MUST completely ignore or reject any
session description that contains a type letter that it does not
understand. The attribute mechanism ("a=", described in
Section 5.13) is the primary means for extending SDP and tailoring it
to particular applications or media. Some attributes (the ones
listed in Section 6) have a defined meaning, but others may be added
on a media- or session-specific basis. (Attribute scopes in addition
to media-specific and session-specific scopes may also be defined in
extensions to this document, e.g., [RFC5576] and [RFC8864].) An SDP
parser MUST ignore any attribute it doesn't understand.
An SDP description may contain URIs that reference external content
in the "u=", "k=", and "a=" lines. These URIs may be dereferenced in
some cases, making the session description non-self-contained.
The connection ("c=") information in the session-level section
applies to all the media descriptions of that session unless
overridden by connection information in the media description. For
instance, in the example below, each audio media description behaves
as if it were given a "c=IN IP4 198.51.100.1".
An example SDP description is:
v=0
o=jdoe 3724394400 3724394405 IN IP4 198.51.100.1
s=Call to John Smith
i=SDP Offer #1
u=http://www.jdoe.example.com/home.html
e=Jane Doe <jane@jdoe.example.com>
p=+1 617 555-6011
c=IN IP4 198.51.100.1
t=0 0
m=audio 49170 RTP/AVP 0
m=audio 49180 RTP/AVP 0
m=video 51372 RTP/AVP 99
c=IN IP6 2001:db8::2
a=rtpmap:99 h263-1998/90000
Text-containing fields such as the session-name-field and
information-field are octet strings that may contain any octet with
the exceptions of 0x00 (Nul), 0x0a (ASCII newline), and 0x0d (ASCII
carriage return). The sequence CRLF (0x0d0a) is used to end a line,
although parsers SHOULD be tolerant and also accept lines terminated
with a single newline character. If the "a=charset:" attribute is
not present, these octet strings MUST be interpreted as containing
ISO-10646 characters in UTF-8 encoding. When the "a=charset:"
attribute is present the session-name-field, information-field, and
some attribute fields are interpreted according to the selected
character set.
A session description can contain domain names in the "o=", "u=",
"e=", "c=", and "a=" lines. Any domain name used in SDP MUST comply
with [RFC1034] and [RFC1035]. Internationalized domain names (IDNs)
MUST be represented using the ASCII Compatible Encoding (ACE) form
defined in [RFC5890] and MUST NOT be directly represented in UTF-8 or
any other encoding (this requirement is for compatibility with
[RFC2327] and other early SDP-related standards, which predate the
development of internationalized domain names).
5.1. Protocol Version ("v=")
v=0
The "v=" line (version-field) gives the version of the Session
Description Protocol. This memo defines version 0. There is no
minor version number.
5.2. Origin ("o=")
o=<username> <sess-id> <sess-version> <nettype> <addrtype>
<unicast-address>
The "o=" line (origin-field) gives the originator of the session (her
username and the address of the user's host) plus a session
identifier and version number:
<username> is the user's login on the originating host, or it is "-"
if the originating host does not support the concept of user IDs.
The <username> MUST NOT contain spaces.
<sess-id> is a numeric string such that the tuple of <username>,
<sess-id>, <nettype>, <addrtype>, and <unicast-address> forms a
globally unique identifier for the session. The method of <sess-
id> allocation is up to the creating tool, but a timestamp, in
seconds since January 1, 1900 UTC, is recommended to ensure
uniqueness.
<sess-version> is a version number for this session description.
Its usage is up to the creating tool, so long as <sess-version> is
increased when a modification is made to the session description.
Again, as with <sess-id> it is RECOMMENDED that a timestamp be
used.
<nettype> is a text string giving the type of network. Initially,
"IN" is defined to have the meaning "Internet", but other values
MAY be registered in the future (see Section 8).
<addrtype> is a text string giving the type of the address that
follows. Initially, "IP4" and "IP6" are defined, but other values
MAY be registered in the future (see Section 8).
<unicast-address> is an address of the machine from which the
session was created. For an address type of "IP4", this is either
a fully qualified domain name of the machine or the dotted-decimal
representation of an IP version 4 address of the machine. For an
address type of "IP6", this is either a fully qualified domain
name of the machine or the address of the machine represented as
specified in Section 4 of [RFC5952]. For both "IP4" and "IP6",
the fully qualified domain name is the form that SHOULD be given
unless this is unavailable, in which case a globally unique
address MAY be substituted.
In general, the "o=" line serves as a globally unique identifier for
this version of the session description, and the subfields excepting
the version, taken together identify the session irrespective of any
modifications.
For privacy reasons, it is sometimes desirable to obfuscate the
username and IP address of the session originator. If this is a
concern, an arbitrary <username> and private <unicast-address> MAY be
chosen to populate the "o=" line, provided that these are selected in
a manner that does not affect the global uniqueness of the field.
5.3. Session Name ("s=")
s=<session name>
The "s=" line (session-name-field) is the textual session name.
There MUST be one and only one "s=" line per session description.
The "s=" line MUST NOT be empty. If a session has no meaningful
name, then "s= " or "s=-" (i.e., a single space or dash as the
session name) is RECOMMENDED. If a session-level "a=charset:"
attribute is present, it specifies the character set used in the "s="
field. If a session-level "a=charset:" attribute is not present, the
"s=" field MUST contain ISO 10646 characters in UTF-8 encoding.
5.4. Session Information ("i=")
i=<session information>
The "i=" line (information-field) provides textual information about
the session. There can be at most one session-level "i=" line per
session description, and at most one "i=" line in each media
description. Unless a media-level "i=" line is provided, the
session-level "i=" line applies to that media description. If the
"a=charset:" attribute is present, it specifies the character set
used in the "i=" line. If the "a=charset:" attribute is not present,
the "i=" line MUST contain ISO 10646 characters in UTF-8 encoding.
At most one "i=" line can be used for each media description. In
media definitions, "i=" lines are primarily intended for labeling
media streams. As such, they are most likely to be useful when a
single session has more than one distinct media stream of the same
media type. An example would be two different whiteboards, one for
slides and one for feedback and questions.
The "i=" line is intended to provide a free-form human-readable
description of the session or the purpose of a media stream. It is
not suitable for parsing by automata.
5.5. URI ("u=")
u=<uri>
The "u=" line (uri-field) provides a URI (Uniform Resource
Identifier) [RFC3986]. The URI should be a pointer to additional
human readable information about the session. This line is OPTIONAL.
No more than one "u=" line is allowed per session description.
5.6. Email Address and Phone Number ("e=" and "p=")
e=<email-address>
p=<phone-number>
The "e=" line (email-field) and "p=" line (phone-field) specify
contact information for the person responsible for the session. This
is not necessarily the same person that created the session
description.
Inclusion of an email address or phone number is OPTIONAL.
If an email address or phone number is present, it MUST be specified
before the first media description. More than one email or phone
line can be given for a session description.
Phone numbers SHOULD be given in the form of an international public
telecommunication number (see ITU-T Recommendation E.164 [E164])
preceded by a "+". Spaces and hyphens may be used to split up a
phone-field to aid readability if desired. For example:
p=+1 617 555-6011
Both email addresses and phone numbers can have an OPTIONAL free text
string associated with them, normally giving the name of the person
who may be contacted. This MUST be enclosed in parentheses if it is
present. For example:
e=j.doe@example.com (Jane Doe)
The alternative [RFC5322] name quoting convention is also allowed for
both email addresses and phone numbers. For example:
e=Jane Doe <j.doe@example.com>
The free text string SHOULD be in the ISO-10646 character set with
UTF-8 encoding, or alternatively in ISO-8859-1 or other encodings if
the appropriate session-level "a=charset:" attribute is set.
5.7. Connection Information ("c=")
c=<nettype> <addrtype> <connection-address>
The "c=" line (connection-field) contains information necessary to
establish a network connection.
A session description MUST contain either at least one "c=" line in
each media description or a single "c=" line at the session level.
It MAY contain a single session-level "c=" line and additional media-
level "c=" line(s) per-media-description, in which case the media-
level values override the session-level settings for the respective
media.
The first subfield (<nettype>) is the network type, which is a text
string giving the type of network. Initially, "IN" is defined to
have the meaning "Internet", but other values MAY be registered in
the future (see Section 8).
The second subfield (<addrtype>) is the address type. This allows
SDP to be used for sessions that are not IP based. This memo only
defines "IP4" and "IP6", but other values MAY be registered in the
future (see Section 8).
The third subfield (<connection-address>) is the connection address.
Additional subfields MAY be added after the connection address
depending on the value of the <addrtype> subfield.
When the <addrtype> is "IP4" or "IP6", the connection address is
defined as follows:
* If the session is multicast, the connection address will be an IP
multicast group address. If the session is not multicast, then
the connection address contains the unicast IP address of the
expected data source, data relay, or data sink as determined by
additional attribute-fields (Section 5.13). It is not expected
that unicast addresses will be given in a session description that
is communicated by a multicast announcement, though this is not
prohibited.
* Sessions using an "IP4" multicast connection address MUST also
have a time to live (TTL) value present in addition to the
multicast address. The TTL and the address together define the
scope with which multicast packets sent in this session will be
sent. TTL values MUST be in the range 0-255. Although the TTL
MUST be specified, its use to scope multicast traffic is
deprecated; applications SHOULD use an administratively scoped
address instead.
The TTL for the session is appended to the address using a slash as a
separator. An example is:
c=IN IP4 233.252.0.1/127
"IP6" multicast does not use TTL scoping, and hence the TTL value
MUST NOT be present for "IP6" multicast. It is expected that IPv6
scoped addresses will be used to limit the scope of multimedia
conferences.
Hierarchical or layered encoding schemes are data streams where the
encoding from a single media source is split into a number of layers.
The receiver can choose the desired quality (and hence bandwidth) by
only subscribing to a subset of these layers. Such layered encodings
are normally transmitted in multiple multicast groups to allow
multicast pruning. This technique keeps unwanted traffic from sites
only requiring certain levels of the hierarchy. For applications
requiring multiple multicast groups, we allow the following notation
to be used for the connection address:
<base multicast address>[/<ttl>]/<number of addresses>
If the number of addresses is not given, it is assumed to be one.
Multicast addresses so assigned are contiguously allocated above the
base address, so that, for example:
c=IN IP4 233.252.0.1/127/3
would state that addresses 233.252.0.1, 233.252.0.2, and 233.252.0.3
are to be used with a TTL of 127. This is semantically identical to
including multiple "c=" lines in a media description:
c=IN IP4 233.252.0.1/127
c=IN IP4 233.252.0.2/127
c=IN IP4 233.252.0.3/127
Similarly, an IPv6 example would be:
c=IN IP6 ff00::db8:0:101/3
which is semantically equivalent to:
c=IN IP6 ff00::db8:0:101
c=IN IP6 ff00::db8:0:102
c=IN IP6 ff00::db8:0:103
(remember that the TTL subfield is not present in "IP6" multicast).
Multiple addresses or "c=" lines MAY be specified on a per media
description basis only if they provide multicast addresses for
different layers in a hierarchical or layered encoding scheme.
Multiple addresses or "c=" lines MUST NOT be specified at session
level.
The slash notation for multiple addresses described above MUST NOT be
used for IP unicast addresses.
5.8. Bandwidth Information ("b=")
b=<bwtype>:<bandwidth>
The OPTIONAL "b=" line (bandwidth-field) denotes the proposed
bandwidth to be used by the session or media description. The
<bwtype> is an alphanumeric modifier that provides the meaning of the
<bandwidth> number. Two values are defined in this specification,
but other values MAY be registered in the future (see Section 8 and
[RFC3556], [RFC3890]):
CT If the bandwidth of a session is different from the bandwidth
implicit from the scope, a "b=CT:" line SHOULD be supplied for the
session giving the proposed upper limit to the bandwidth used (the
"conference total" bandwidth). Similarly, if the bandwidth of
bundled media streams [RFC8843] in an "m=" line is different from
the implicit value from the scope, a "b=CT:" line SHOULD be
supplied in the media level. The primary purpose of this is to
give an approximate idea as to whether two or more sessions (or
bundled media streams) can coexist simultaneously. Note that a
"b=CT:" line gives a total bandwidth figure for all the media at
all endpoints.
The Mux Category for "b=CT:" is NORMAL. This is discussed in
[RFC8859].
AS The bandwidth is interpreted to be application specific (it will
be the application's concept of maximum bandwidth). Normally,
this will coincide with what is set on the application's "maximum
bandwidth" control if applicable. For RTP-based applications, the
"b=AS:" line gives the RTP "session bandwidth" as defined in
Section 6.2 of [RFC3550]. Note that a "b=AS:" line gives a
bandwidth figure for a single media at a single endpoint, although
there may be many endpoints sending simultaneously.
The Mux Category for "b=AS:" is SUM. This is discussed in
[RFC8859].
[RFC4566] defined an "X-" prefix for <bwtype> names. This was
intended for experimental purposes only. For example:
b=X-YZ:128
Use of the "X-" prefix is NOT RECOMMENDED. Instead new (non "X-"
prefix) <bwtype> names SHOULD be defined, and then MUST be registered
with IANA in the standard namespace. SDP parsers MUST ignore
bandwidth-fields with unknown <bwtype> names. The <bwtype> names
MUST be alphanumeric and, although no length limit is given, it is
recommended that they be short.
The <bandwidth> is interpreted as kilobits per second by default
(including the transport and network-layer, but not the link-layer,
overhead). The definition of a new <bwtype> modifier MAY specify
that the bandwidth is to be interpreted in some alternative unit (the
"CT" and "AS" modifiers defined in this memo use the default units).
5.9. Time Active ("t=")
t=<start-time> <stop-time>
A "t=" line (time-field) begins a time description that specifies the
start and stop times for a session. Multiple time descriptions MAY
be used if a session is active at multiple irregularly spaced times;
each additional time description specifies additional periods of time
for which the session will be active. If the session is active at
regular repeat times, a repeat description, begun by an "r=" line
(see Section 5.10) can be included following the time-field -- in
which case the time-field specifies the start and stop times of the
entire repeat sequence.
The following example specifies two active intervals:
t=3724394400 3724398000 ; Mon 8-Jan-2018 10:00-11:00 UTC
t=3724484400 3724488000 ; Tue 9-Jan-2018 11:00-12:00 UTC
The first and second subfields of the time-field give the start and
stop times, respectively, for the session. These are the decimal
representation of time values in seconds since January 1, 1900 UTC.
To convert these values to Unix time (UTC), subtract decimal
2208988800.
Some time representations will wrap in the year 2036. Because SDP
uses an arbitrary length decimal representation, it does not have
this issue. Implementations of SDP need to be prepared to handle
these larger values.
If the <stop-time> is set to zero, then the session is not bounded,
though it will not become active until after the <start-time>. If
the <start-time> is also zero, the session is regarded as permanent.
User interfaces SHOULD strongly discourage the creation of unbounded
and permanent sessions as they give no information about when the
session is actually going to terminate, and so make scheduling
difficult.
The general assumption may be made, when displaying unbounded
sessions that have not timed out to the user, that an unbounded
session will only be active until half an hour from the current time
or the session start time, whichever is the later. If behavior other
than this is required, a <stop-time> SHOULD be given and modified as
appropriate when new information becomes available about when the
session should really end.
Permanent sessions may be shown to the user as never being active
unless there are associated repeat times that state precisely when
the session will be active.
5.10. Repeat Times ("r=")
r=<repeat interval> <active duration> <offsets from start-time>
An"r=" line (repeat-field) specifies repeat times for a session. If
needed to express complex schedules, multiple repeat-fields may be
included. For example, if a session is active at 10am on Monday and
11am on Tuesday for one hour each week for three months, then the
<start-time> in the corresponding "t=" line would be the
representation of 10am on the first Monday, the <repeat interval>
would be 1 week, the <active duration> would be 1 hour, and the
offsets would be zero and 25 hours. The corresponding "t=" line stop
time would be the representation of the end of the last session three
months later. By default, all subfields are in seconds, so the "r="
and "t=" lines might be the following:
t=3724394400 3730536000 ; Mon 8-Jan-2018 10:00-11:00 UTC
; Tues 20-Mar-2018 12:00 UTC
r=604800 3600 0 90000 ; 1 week, 1 hour, zero, 25 hours
To make the description more compact, times may also be given in
units of days, hours, or minutes. The syntax for these is a number
immediately followed by a single case-sensitive character.
Fractional units are not allowed -- a smaller unit should be used
instead. The following unit specification characters are allowed:
+---+------------------------------------+
| d | days (86400 seconds) |
+---+------------------------------------+
| h | hours (3600 seconds) |
+---+------------------------------------+
| m | minutes (60 seconds) |
+---+------------------------------------+
| s | seconds (allowed for completeness) |
+---+------------------------------------+
Table 1: Time Unit Specification
Characters
Thus, the above repeat-field could also have been written:
r=7d 1h 0 25h
Monthly and yearly repeats cannot be directly specified with a single
SDP repeat time; instead, separate time-descriptions should be used
to explicitly list the session times.
5.11. Time Zone Adjustment ("z=")
z=<adjustment time> <offset> <adjustment time> <offset> ....
A "z=" line (zone-field) is an optional modifier to the repeat-fields
it immediately follows. It does not apply to any other fields.
To schedule a repeated session that spans a change from daylight
saving time to standard time or vice versa, it is necessary to
specify offsets from the base time. This is required because
different time zones change time at different times of day, different
countries change to or from daylight saving time on different dates,
and some countries do not have daylight saving time at all.
Thus, in order to schedule a session that is at the same time winter
and summer, it must be possible to specify unambiguously by whose
time zone a session is scheduled. To simplify this task for
receivers, we allow the sender to specify the time (represented as
seconds since January 1, 1900 UTC) that a time zone adjustment
happens and the offset from the time when the session was first
scheduled. The "z=" line allows the sender to specify a list of
these adjustment times and offsets from the base time.
An example might be the following:
t=3724394400 3754123200 ; Mon 8-Jan-2018 10:00 UTC
; Tues 18-Dec-2018 12:00 UTC
r=604800 3600 0 90000 ; 1 week, 1 hour, zero, 25 hours
z=3730928400 -1h 3749680800 0 ; Sun 25-Mar-2018 1:00 UTC,
; offset 1 hour,
; Sun 28-Oct-2018 2:00 UTC,
; no offset
This specifies that at time 3730928400 (Sun 25-Mar-2018 1:00 UTC, the
onset of British Summer Time) the time base by which the session's
repeat times are calculated is shifted back by 1 hour, and that at
time 3749680800 (Sun 28-Oct-2018 2:00 UTC, the end of British Summer
Time) the session's original time base is restored. Adjustments are
always relative to the specified start time -- they are not
cumulative.
If a session is likely to last several years, it is expected that the
session description will be modified periodically rather than
transmit several years' worth of adjustments in one session
description.
5.12. Encryption Keys ("k=")
k=<method>
k=<method>:<encryption key>
The "k=" line (key-field) is obsolete and MUST NOT be used. It is
included in this document for legacy reasons. One MUST NOT include a
"k=" line in an SDP, and MUST discard it if it is received in an SDP.
5.13. Attributes ("a=")
a=<attribute-name>
a=<attribute-name>:<attribute-value>
Attributes are the primary means for extending SDP. Attributes may
be defined to be used as session-level attributes, media-level
attributes, or both. (Attribute scopes in addition to media-level
and session-level scopes may also be defined in extensions to this
document, e.g., [RFC5576] and [RFC8864].)
A media description may contain any number of "a=" lines (attribute-
fields) that are media description specific. These are referred to
as media-level attributes and add information about the media
description. Attribute-fields can also be added before the first
media description; these session-level attributes convey additional
information that applies to the session as a whole rather than to
individual media descriptions.
Attribute-fields may be of two forms:
* A property attribute is simply of the form "a=<attribute-name>".
These are binary attributes, and the presence of the attribute
conveys that the attribute is a property of the session. An
example might be "a=recvonly".
* A value attribute is of the form "a=<attribute-name>:<attribute-
value>". For example, a whiteboard could have the value attribute
"a=orient:landscape".
Attribute interpretation depends on the media tool being invoked.
Thus receivers of session descriptions should be configurable in
their interpretation of session descriptions in general and of
attributes in particular.
Attribute names MUST use the US-ASCII subset of ISO-10646/UTF-8.
Attribute values are octet strings, and MAY use any octet value
except 0x00 (Nul), 0x0A (LF), and 0x0D (CR). By default, attribute
values are to be interpreted as in ISO-10646 character set with UTF-8
encoding. Unlike other text fields, attribute values are NOT
normally affected by the "a=charset:" attribute as this would make
comparisons against known values problematic. However, when an
attribute is defined, it can be defined to be charset dependent, in
which case its value should be interpreted in the session charset
rather than in ISO-10646.
Attributes MUST be registered with IANA (see Section 8). If an
attribute is received that is not understood, it MUST be ignored by
the receiver.
5.14. Media Descriptions ("m=")
m=<media> <port> <proto> <fmt> ...
A session description may contain a number of media descriptions.
Each media description starts with an "m=" line (media-field) and is
terminated by either the next "m=" line or by the end of the session
description. A media-field has several subfields:
<media> is the media type. This document defines the values
"audio", "video", "text", "application", and "message". This list
is extended by other memos and may be further extended by
additional memos registering media types in the future (see
Section 8). For example, [RFC6466] defined the "image" media
type.
<port> is the transport port to which the media stream is sent. The
meaning of the transport port depends on the network being used as
specified in the relevant "c=" line, and on the transport protocol
defined in the <proto> subfield of the media-field. Other ports
used by the media application (such as the RTP Control Protocol
(RTCP) port [RFC3550]) MAY be derived algorithmically from the
base media port or MAY be specified in a separate attribute (for
example, the "a=rtcp:" attribute as defined in [RFC3605]).
If noncontiguous ports are used or if they don't follow the parity
rule of even RTP ports and odd RTCP ports, the "a=rtcp:" attribute
MUST be used. Applications that are requested to send media to a
<port> that is odd and where the "a=rtcp:" attribute is present
MUST NOT subtract 1 from the RTP port: that is, they MUST send the
RTP to the port indicated in <port> and send the RTCP to the port
indicated in the "a=rtcp:" attribute.
For applications where hierarchically encoded streams are being
sent to a unicast address, it may be necessary to specify multiple
transport ports. This is done using a similar notation to that
used for IP multicast addresses in the "c=" line:
m=<media> <port>/<number of ports> <proto> <fmt> ...
In such a case, the ports used depend on the transport protocol.
For RTP, the default is that only the even-numbered ports are used
for data with the corresponding one-higher odd ports used for the
RTCP belonging to the RTP session, and the <number of ports>
denoting the number of RTP sessions. For example:
m=video 49170/2 RTP/AVP 31
would specify that ports 49170 and 49171 form one RTP/RTCP pair,
and 49172 and 49173 form the second RTP/RTCP pair. RTP/AVP is the
transport protocol, and 31 is the format (see the description of
<fmt> below).
This document does not include a mechanism for declaring
hierarchically encoded streams using noncontiguous ports. (There
is currently no attribute defined that can accomplish this. The
"a=rtcp:" attribute defined in [RFC3605] does not handle
hierarchical encoding.) If a need arises to declare noncontiguous
ports then it will be necessary to define a new attribute to do
so.
If multiple addresses are specified in the "c=" line and multiple
ports are specified in the "m=" line, a one-to-one mapping from
port to the corresponding address is implied. For example:
m=video 49170/2 RTP/AVP 31
c=IN IP4 233.252.0.1/127/2
would imply that address 233.252.0.1 is used with ports 49170 and
49171, and address 233.252.0.2 is used with ports 49172 and 49173.
The mapping is similar if multiple addresses are specified using
multiple "c=" lines. For example:
m=video 49170/2 RTP/AVP 31
c=IN IP6 ff00::db8:0:101
c=IN IP6 ff00::db8:0:102
would imply that address ff00::db8:0:101 is used with ports 49170
and 49171, and address ff00::db8:0:102 is used with ports 49172
and 49173.
This document gives no meaning to assigning the same media address
to multiple media descriptions. Doing so does not implicitly
group those media descriptions in any way. An explicit grouping
framework (for example, [RFC5888]) should instead be used to
express the intended semantics. For instance, see [RFC8843].
<proto> is the transport protocol. The meaning of the transport
protocol is dependent on the address type subfield in the relevant
"c=" line. Thus a "c=" line with an address type of "IP4"
indicates that the transport protocol runs over IPv4. The
following transport protocols are defined, but may be extended
through registration of new protocols with IANA (see Section 8):
* udp: denotes that the data is transported directly in UDP with
no additional framing.
* RTP/AVP: denotes RTP [RFC3550] used under the RTP Profile for
Audio and Video Conferences with Minimal Control [RFC3551]
running over UDP.
* RTP/SAVP: denotes the Secure Real-time Transport Protocol
[RFC3711] running over UDP.
* RTP/SAVPF: denotes SRTP with the Extended SRTP Profile for
RTCP-Based Feedback [RFC5124] running over UDP.
The main reason to specify the transport protocol in addition to
the media format is that the same standard media formats may be
carried over different transport protocols even when the network
protocol is the same -- a historical example is vat (MBone's
popular multimedia audio tool) Pulse Code Modulation (PCM) audio
and RTP PCM audio; another might be TCP/RTP PCM audio. In
addition, relays and monitoring tools that are transport-protocol-
specific but format-independent are possible.
<fmt> is a media format description. The fourth and any subsequent
subfields describe the format of the media. The interpretation of
the media format depends on the value of the <proto> subfield.
If the <proto> subfield is "RTP/AVP" or "RTP/SAVP", the <fmt>
subfields contain RTP payload type numbers. When a list of
payload type numbers is given, this implies that all of these
payload formats MAY be used in the session, and these payload
formats are listed in order of preference, with the first format
listed being preferred. When multiple payload formats are listed,
the first acceptable payload format from the beginning of the list
SHOULD be used for the session. For dynamic payload type
assignments, the "a=rtpmap:" attribute (see Section 6.6) SHOULD be
used to map from an RTP payload type number to a media encoding
name that identifies the payload format. The "a=fmtp:" attribute
MAY be used to specify format parameters (see Section 6.15).
If the <proto> subfield is "udp", the <fmt> subfields MUST
reference a media type describing the format under the "audio",
"video", "text", "application", or "message" top-level media
types. The media type registration SHOULD define the packet
format for use with UDP transport.
For media using other transport protocols, the <fmt> subfield is
protocol specific. Rules for interpretation of the <fmt> subfield
MUST be defined when registering new protocols (see
Section 8.2.2).
Section 3 of [RFC4855] states that the payload format (encoding)
names defined in the RTP profile are commonly shown in upper case,
while media subtype names are commonly shown in lower case. It
also states that both of these names are case-insensitive in both
places, similar to parameter names which are case-insensitive both
in media type strings and in the default mapping to the SDP
"a=fmtp:" attribute.
6. SDP Attributes
The following attributes are defined. Since application writers may
add new attributes as they are required, this list is not exhaustive.
Registration procedures for new attributes are defined in
Section 8.2.4. Syntax is provided using ABNF [RFC7405] with some of
the rules defined further in Section 9.
6.1. cat (Category)
Name: cat
Value: cat-value
Usage Level: session
Charset Dependent: no
Syntax:
cat-value = category
category = non-ws-string
Example:
a=cat:foo.bar
This attribute gives the dot-separated hierarchical category of the
session. This is to enable a receiver to filter unwanted sessions by
category. There is no central registry of categories. This
attribute is obsolete and SHOULD NOT be used. It SHOULD be ignored
if received.
6.2. keywds (Keywords)
Name: keywds
Value: keywds-value
Usage Level: session
Charset Dependent: yes
Syntax:
keywds-value = keywords
keywords = text
Example:
a=keywds:SDP session description protocol
Like the "a=cat:" attribute, this was intended to assist identifying
wanted sessions at the receiver, and to allow a receiver to select
interesting sessions based on keywords describing the purpose of the
session; however, there is no central registry of keywords. Its
value should be interpreted in the charset specified for the session
description if one is specified, or by default in ISO 10646/UTF-8.
This attribute is obsolete and SHOULD NOT be used. It SHOULD be
ignored if received.
6.3. tool
Name: tool
Value: tool-value
Usage Level: session
Charset Dependent: no
Syntax:
tool-value = tool-name-and-version
tool-name-and-version = text
Example:
a=tool:foobar V3.2
This gives the name and version number of the tool used to create the
session description.
6.4. ptime (Packet Time)
Name: ptime
Value: ptime-value
Usage Level: media
Charset Dependent: no
Syntax:
ptime-value = non-zero-int-or-real
Example:
a=ptime:20
This gives the length of time in milliseconds represented by the
media in a packet. This is probably only meaningful for audio data,
but may be used with other media types if it makes sense. It should
not be necessary to know "a=ptime:" to decode RTP or vat audio, and
it is intended as a recommendation for the encoding/packetization of
audio.
6.5. maxptime (Maximum Packet Time)
Name: maxptime
Value: maxptime-value
Usage Level: media
Charset Dependent: no
Syntax:
maxptime-value = non-zero-int-or-real
Example:
a=maxptime:20
This gives the maximum amount of media that can be encapsulated in
each packet, expressed as time in milliseconds. The time SHALL be
calculated as the sum of the time the media present in the packet
represents. For frame-based codecs, the time SHOULD be an integer
multiple of the frame size. This attribute is probably only
meaningful for audio data, but may be used with other media types if
it makes sense. Note that this attribute was introduced after
[RFC2327], and implementations that have not been updated will ignore
this attribute.
6.6. rtpmap
Name: rtpmap
Value: rtpmap-value
Usage Level: media
Charset Dependent: no
Syntax:
rtpmap-value = payload-type SP encoding-name
"/" clock-rate [ "/" encoding-params ]
payload-type = zero-based-integer
encoding-name = token
clock-rate = integer
encoding-params = channels
channels = integer
This attribute maps from an RTP payload type number (as used in an
"m=" line) to an encoding name denoting the payload format to be
used. It also provides information on the clock rate and encoding
parameters. Note that the payload type number is indicated in a
7-bit field, limiting the values to inclusively between 0 and 127.
Although an RTP profile can make static assignments of payload type
numbers to payload formats, it is more common for that assignment to
be done dynamically using "a=rtpmap:" attributes. As an example of a
static payload type, consider u-law PCM encoded single-channel audio
sampled at 8 kHz. This is completely defined in the RTP audio/video
profile as payload type 0, so there is no need for an "a=rtpmap:"
attribute, and the media for such a stream sent to UDP port 49232 can
be specified as:
m=audio 49232 RTP/AVP 0
An example of a dynamic payload type is 16-bit linear encoded stereo
audio sampled at 16 kHz. If we wish to use the dynamic RTP/AVP
payload type 98 for this stream, additional information is required
to decode it:
m=audio 49232 RTP/AVP 98
a=rtpmap:98 L16/16000/2
Up to one "a=rtpmap:" attribute can be defined for each media format
specified. Thus, we might have the following:
m=audio 49230 RTP/AVP 96 97 98
a=rtpmap:96 L8/8000
a=rtpmap:97 L16/8000
a=rtpmap:98 L16/11025/2
RTP profiles that specify the use of dynamic payload types MUST
define the set of valid encoding names and/or a means to register
encoding names if that profile is to be used with SDP. The "RTP/AVP"
and "RTP/SAVP" profiles use media subtypes for encoding names, under
the top-level media type denoted in the "m=" line. In the example
above, the media types are "audio/L8" and "audio/L16".
For audio streams, encoding-params indicates the number of audio
channels. This parameter is OPTIONAL and may be omitted if the
number of channels is one, provided that no additional parameters are
needed.
For video streams, no encoding parameters are currently specified.
Additional encoding parameters MAY be defined in the future, but
codec-specific parameters SHOULD NOT be added. Parameters added to
an "a=rtpmap:" attribute SHOULD only be those required for a session
directory to make the choice of appropriate media to participate in a
session. Codec-specific parameters should be added in other
attributes (for example, "a=fmtp:").
Note: RTP audio formats typically do not include information about
the number of samples per packet. If a non-default (as defined in
the RTP Audio/Video Profile [RFC3551]) packetization is required, the
"a=ptime:" attribute is used as given in Section 6.4.
6.7. Media Direction Attributes
At most one occurrence of "a=recvonly", "a=sendrecv", "a=sendonly",
or "a=inactive" MAY appear at session level, and at most one MAY
appear in each media description.
If any one of these appears in a media description, then it applies
for that media description. If none appears in a media description,
then the one from session level, if any, applies to that media
description.
If none of the media direction attributes is present at either
session level or media level, "a=sendrecv" SHOULD be assumed as the
default.
Within the following SDP example, the "a=sendrecv" attribute applies
to the first audio media and the "a=inactive" attribute applies to
the others.
v=0
o=jdoe 3724395000 3724395001 IN IP6 2001:db8::1
s=-
c=IN IP6 2001:db8::1
t=0 0
a=inactive
m=audio 49170 RTP/AVP 0
a=sendrecv
m=audio 49180 RTP/AVP 0
m=video 51372 RTP/AVP 99
a=rtpmap:99 h263-1998/90000
6.7.1. recvonly (Receive-Only)
Name: recvonly
Value:
Usage Level: session, media
Charset Dependent: no
Example:
a=recvonly
This specifies that the tools should be started in receive-only mode
where applicable. Note that receive-only mode applies to the media
only, not to any associated control protocol. An RTP-based system in
receive-only mode MUST still send RTCP packets as described in
[RFC3550], Section 6.
6.7.2. sendrecv (Send-Receive)
Name: sendrecv
Value:
Usage Level: session, media
Charset Dependent: no
Example:
a=sendrecv
This specifies that the tools should be started in send and receive
mode. This is necessary for interactive multimedia conferences with
tools that default to receive-only mode.
6.7.3. sendonly (Send-Only)
Name: sendonly
Value:
Usage Level: session, media
Charset Dependent: no
Example:
a=sendonly
This specifies that the tools should be started in send-only mode.
An example may be where a different unicast address is to be used for
a traffic destination than for a traffic source. In such a case, two
media descriptions may be used, one in send-only mode and one in
receive-vonly mode. Note that send-only mode applies only to the
media, and any associated control protocol (e.g., RTCP) SHOULD still
be received and processed as normal.
6.7.4. inactive
Name: inactive
Value:
Usage Level: session, media
Charset Dependent: no
Example:
a=inactive
This specifies that the tools should be started in inactive mode.
This is necessary for interactive multimedia conferences where users
can put other users on hold. No media is sent over an inactive media
stream. Note that an RTP-based system MUST still send RTCP (if RTCP
is used), even if started in inactive mode.
6.8. orient (Orientation)
Name: orient
Value: orient-value
Usage Level: media
Charset Dependent: no
Syntax:
orient-value = portrait / landscape / seascape
portrait = %s"portrait"
landscape = %s"landscape"
seascape = %s"seascape"
; NOTE: These names are case-sensitive.
Example:
a=orient:portrait
Normally this is only used for a whiteboard or presentation tool. It
specifies the orientation of the workspace on the screen. Permitted
values are "portrait", "landscape", and "seascape" (upside-down
landscape).
6.9. type (Conference Type)
Name: type
Value: type-value
Usage Level: session
Charset Dependent: no
Syntax:
type-value = conference-type
conference-type = broadcast / meeting / moderated / test /
H332
broadcast = %s"broadcast"
meeting = %s"meeting"
moderated = %s"moderated"
test = %s"test"
H332 = %s"H332"
; NOTE: These names are case-sensitive.
Example:
a=type:moderated
This specifies the type of the multimedia conference. Allowed values
are "broadcast", "meeting", "moderated", "test", and "H332". These
values have implications for other options that are likely to be
appropriate:
* When "a=type:broadcast" is specified, "a=recvonly" is probably
appropriate for those connecting.
* When "a=type:meeting" is specified, "a=sendrecv" is likely to be
appropriate.
* "a=type:moderated" suggests the use of a floor control tool and
that the media tools be started so as to mute new sites joining
the multimedia conference.
* Specifying "a=type:H332" indicates that this loosely coupled
session is part of an H.332 session as defined in the ITU H.332
specification [ITU.H332.1998]. Media tools should be started
using "a=recvonly".
* Specifying "a=type:test" is suggested as a hint that, unless
explicitly requested otherwise, receivers can safely avoid
displaying this session description to users.
6.10. charset (Character Set)
Name: charset
Value: charset-value
Usage Level: session
Charset Dependent: no
Syntax:
charset-value = <defined in [RFC2978]>
This specifies the character set to be used to display the session
name and information data. By default, the ISO-10646 character set
in UTF-8 encoding is used. If a more compact representation is
required, other character sets may be used. For example, the ISO
8859-1 is specified with the following SDP attribute:
a=charset:ISO-8859-1
The charset specified MUST be one of those registered in the IANA
Character Sets registry (http://www.iana.org/assignments/character-
sets), such as ISO-8859-1. The character set identifier is a string
that MUST be compared against identifiers from the "Name" or
"Preferred MIME Name" field of the registry using a case-insensitive
comparison. If the identifier is not recognized or not supported,
all strings that are affected by it SHOULD be regarded as octet
strings.
Charset-dependent fields MUST contain only sequences of bytes that
are valid according to the definition of the selected character set.
Furthermore, charset-dependent fields MUST NOT contain the bytes 0x00
(Nul), 0x0A (LF), and 0x0d (CR).
6.11. sdplang (SDP Language)
Name: sdplang
Value: sdplang-value
Usage Level: session, media
Charset Dependent: no
Syntax:
sdplang-value = Language-Tag
; Language-Tag defined in RFC 5646
Example:
a=sdplang:fr
Multiple "a=sdplang:" attributes can be provided either at session or
media level if the session description or media use multiple
languages.
As a session-level attribute, it specifies the language for the
session description (not the language of the media). As a media-
level attribute, it specifies the language for any media-level SDP
information-field associated with that media (again not the language
of the media), overriding any "a=sdplang:" attributes specified at
session level.
In general, sending session descriptions consisting of multiple
languages is discouraged. Instead, multiple session descriptions
SHOULD be sent describing the session, one in each language.
However, this is not possible with all transport mechanisms, and so
multiple "a=sdplang:" attributes are allowed although NOT
RECOMMENDED.
The "a=sdplang:" attribute value must be a single language tag
[RFC5646]. An "a=sdplang:" attribute SHOULD be specified when a
session is distributed with sufficient scope to cross geographic
boundaries, where the language of recipients cannot be assumed, or
where the session is in a different language from the locally assumed
norm.
6.12. lang (Language)
Name: lang
Value: lang-value
Usage Level: session, media
Charset Dependent: no
Syntax:
lang-value = Language-Tag
; Language-Tag defined in RFC 5646
Example:
a=lang:de
Multiple "a=lang:" attributes can be provided either at session or
media level if the session or media has capabilities in more than one
language, in which case the order of the attributes indicates the
order of preference of the various languages in the session or media,
from most preferred to least preferred.
As a session-level attribute, "a=lang:" specifies a language
capability for the session being described. As a media-level
attribute, it specifies a language capability for that media,
overriding any session-level language(s) specified.
The "a=lang:" attribute value must be a single [RFC5646] language
tag. An "a=lang:" attribute SHOULD be specified when a session is of
sufficient scope to cross geographic boundaries where the language of
participants cannot be assumed, or where the session has capabilities
in languages different from the locally assumed norm.
The "a=lang:" attribute is supposed to be used for setting the
initial language(s) used in the session. Events during the session
may influence which language(s) are used, and the participants are
not strictly bound to only use the declared languages.
Most real-time use cases start with just one language used, while
other cases involve a range of languages, e.g., an interpreted or
subtitled session. When more than one "a=lang:" attribute is
specified, the "a=lang:" attribute itself does not provide any
information about multiple languages being intended to be used during
the session, or if the intention is to only select one of the
languages. If needed, a new attribute can be defined and used to
indicate such intentions. Without such semantics, it is assumed that
for a negotiated session one of the declared languages will be
selected and used.
6.13. framerate (Frame Rate)
Name: framerate
Value: framerate-value
Usage Level: media
Charset Dependent: no
Syntax:
framerate-value = non-zero-int-or-real
Example:
a=framerate:60
This gives the maximum video frame rate in frames/sec. It is
intended as a recommendation for the encoding of video data. Decimal
representations of fractional values are allowed. It is defined only
for video media.
6.14. quality
Name: quality
Value: quality-value
Usage Level: media
Charset Dependent: no
Syntax:
quality-value = zero-based-integer
Example:
a=quality:10
This gives a suggestion for the quality of the encoding as an integer
value. The intention of the quality attribute for video is to
specify a non-default trade-off between frame-rate and still-image
quality. For video, the value is in the range 0 to 10, with the
following suggested meaning:
+----+----------------------------------------+
| 10 | the best still-image quality the |
| | compression scheme can give. |
+----+----------------------------------------+
| 5 | the default behavior given no quality |
| | suggestion. |
+----+----------------------------------------+
| 0 | the worst still-image quality the |
| | codec designer thinks is still usable. |
+----+----------------------------------------+
Table 2: Encoding Quality Values
6.15. fmtp (Format Parameters)
Name: fmtp
Value: fmtp-value
Usage Level: media
Charset Dependent: no
Syntax:
fmtp-value = fmt SP format-specific-params
format-specific-params = byte-string
; Notes:
; - The format parameters are media type parameters and
; need to reflect their syntax.
Example:
a=fmtp:96 profile-level-id=42e016;max-mbps=108000;max-fs=3600
This attribute allows parameters that are specific to a particular
format to be conveyed in a way that SDP does not have to understand
them. The format must be one of the formats specified for the media.
Format-specific parameters, semicolon separated, may be any set of
parameters required to be conveyed by SDP and given unchanged to the
media tool that will use this format. At most one instance of this
attribute is allowed for each format.
The "a=fmtp:" attribute may be used to specify parameters for any
protocol and format that defines use of such parameters.
7. Security Considerations
SDP is frequently used with the Session Initiation Protocol [RFC3261]
using the offer/answer model [RFC3264] to agree on parameters for
unicast sessions. When used in this manner, the security
considerations of those protocols apply.
SDP is a session description format that describes multimedia
sessions. Entities receiving and acting upon an SDP message SHOULD
be aware that a session description cannot be trusted unless it has
been obtained by an authenticated and integrity-protected transport
protocol from a known and trusted source. Many different transport
protocols may be used to distribute session descriptions, and the
nature of the authentication and integrity protection will differ
from transport to transport. For some transports, security features
are often not deployed. In case a session description has not been
obtained in a trusted manner, the endpoint SHOULD exercise care
because, among other attacks, the media sessions received may not be
the intended ones, the destination to where the media is sent may not
be the expected one, any of the parameters of the session may be
incorrect, or the media security may be compromised. It is up to the
endpoint to make a sensible decision, taking into account the
security risks of the application and the user preferences - the
endpoint may decide to ask the user whether or not to accept the
session.
On receiving a session description over an unauthenticated transport
mechanism or from an untrusted party, software parsing the session
description should take a few precautions. Similar concerns apply if
integrity protection is not in place. Session descriptions contain
information required to start software on the receiver's system.
Software that parses a session description MUST NOT be able to start
other software except that which is specifically configured as
appropriate software to participate in multimedia sessions. It is
normally considered inappropriate for software parsing a session
description to start, on a user's system, software that is
appropriate to participate in multimedia sessions, without the user
first being informed that such software will be started and giving
the user's consent. Thus, a session description arriving by session
announcement, email, session invitation, or WWW page MUST NOT deliver
the user into an interactive multimedia session unless the user has
explicitly pre-authorized such action. As it is not always simple to
tell whether or not a session is interactive, applications that are
unsure should assume sessions are interactive. Software processing
URLs contained in session descriptions should also heed the security
considerations identified in [RFC3986].
In this specification, there are no attributes that would allow the
recipient of a session description to be informed to start multimedia
tools in a mode where they default to transmitting. Under some
circumstances it might be appropriate to define such attributes. If
this is done, an application parsing a session description containing
such attributes SHOULD either ignore them or inform the user that
joining this session will result in the automatic transmission of
multimedia data. The default behavior for an unknown attribute is to
ignore it.
In certain environments, it has become common for intermediary
systems to intercept and analyze session descriptions contained
within other signaling protocols. This is done for a range of
purposes, including but not limited to opening holes in firewalls to
allow media streams to pass, or to mark, prioritize, or block traffic
selectively. In some cases, such intermediary systems may modify the
session description, for example, to have the contents of the session
description match NAT bindings dynamically created. These behaviors
are NOT RECOMMENDED unless the session description is conveyed in
such a manner that allows the intermediary system to conduct proper
checks to establish the authenticity of the session description, and
the authority of its source to establish such communication sessions.
SDP by itself does not include sufficient information to enable these
checks: they depend on the encapsulating protocol (e.g., SIP or
RTSP). The use of some procedures and SDP extensions (e.g.,
Interactive Connectivity Establishment (ICE) [RFC8445] and ICE-SIP-
SDP [RFC8839]) may avoid the need for intermediaries to modify SDP.
SDP MUST NOT be used to convey keying material (e.g., using the
"a=crypto:" attribute [RFC4568]) unless it can be guaranteed that the
channel over which the SDP is delivered is both private and
authenticated.
8. IANA Considerations
8.1. The "application/sdp" Media Type
One media type registration from [RFC4566] has been updated, as
defined below.
Type name: application
Subtype name: sdp
Required parameters: None.
Optional parameters: None.
Encoding considerations: 8-bit text. SDP files are primarily UTF-8
format text. The "a=charset:" attribute may be used to signal the
presence of other character sets in certain parts of an SDP file
(see Section 6 of RFC 8866). Arbitrary binary content cannot be
directly represented in SDP.
Security considerations: See Section 7 of RFC 8866.
Interoperability considerations: See RFC 8866.
Published specification: See RFC 8866.
Applications which use this media type:
Voice over IP, video teleconferencing, streaming media, instant
messaging, among others. See also Section 3 of RFC 8866.
Fragment identifier considerations: None
Additional information:
Deprecated alias names for this type: N/A
Magic number(s): None.
File extension(s): The extension ".sdp" is commonly used.
Macintosh File Type Code(s): "sdp"
Person & email address to contact for further information:
IETF MMUSIC working group
<mmusic@ietf.org>
Intended usage: COMMON
Restrictions on usage: None
Author/Change controller:
Authors of RFC 8866
IETF MMUSIC working group delegated from the IESG
8.2. Registration of SDP Parameters with IANA
This document specifies IANA parameter registries for six named SDP
subfields. Using the terminology in the SDP specification Augmented
Backus-Naur Form (ABNF), they are <media>, <proto>, <attribute-name>,
<bwtype>, <nettype>, and <addrtype>.
This document also replaces and updates the definitions of all those
parameters previously defined by [RFC4566].
IANA has changed all references to RFC 4566 in these registries to
instead refer to this document.
The contact name and email address for all parameters registered in
this document is:
The IETF MMUSIC working group <mmusic@ietf.org> or its successor
as designated by the IESG.
All of these registries have a common format:
+======+==========+================+===========+
| Type | SDP Name | [other fields] | Reference |
+======+==========+================+===========+
Table 3: Common Format for SDP Registries
8.2.1. Registration Procedure
A specification document that defines values for SDP <media>,
<proto>, <attribute-name>, <bwtype>, <nettype>, and <addrtype>
parameters MUST include the following information:
* Contact name
* Contact email address
* Name being defined (as it will appear in SDP)
* Type of name (<media>, <proto>, <attribute-name>, <bwtype>,
<nettype>, or <addrtype>)
* A description of the purpose of the defined name
* A stable reference to the document containing this information and
the definition of the value. (This will typically be an RFC
number.)
The subsections below specify what other information (if any) must be
specified for particular parameters, and what other fields are to be
included in the registry.
8.2.2. Media Types (<media>)
The set of media types is intended to be small and SHOULD NOT be
extended except under rare circumstances. The same rules should
apply for media names as well as for top-level media types, and where
possible the same name should be registered for SDP as for MIME. For
media other than existing top-level media types, a Standards Track
RFC MUST be produced for a new top-level media type to be registered,
and the registration MUST provide good justification why no existing
media name is appropriate (the "Standards Action" policy of
[RFC8126]).
This memo registers the media types "audio", "video", "text",
"application", and "message".
Note: The media types "control" and "data" were listed as valid in an
early version of this specification [RFC2327]; however, their
semantics were never fully specified, and they are not widely used.
These media types have been removed in this specification, although
they still remain valid media type capabilities for a SIP user agent
as defined in [RFC3840]. If these media types are considered useful
in the future, a Standards Track RFC MUST be produced to document
their use. Until that is done, applications SHOULD NOT use these
types and SHOULD NOT declare support for them in SIP capabilities
declarations (even though they exist in the registry created by
[RFC3840]). Also note that [RFC6466] defined the "image" media type.
8.2.3. Transport Protocols (<proto>)
The <proto> subfield describes the transport protocol used. The
registration procedure for this registry is "RFC Required".
This document registers two values:
* "RTP/AVP" is a reference to [RFC3550] used under the RTP Profile
for Audio and Video Conferences with Minimal Control [RFC3551]
running over UDP/IP.
* "udp" indicates direct use of UDP.
New transport protocols MAY be defined, and MUST be registered with
IANA. Registrations MUST reference an RFC describing the protocol.
Such an RFC MAY be Experimental or Informational, although it is
preferable that it be Standards Track. The RFC defining a new
protocol MUST define the rules by which the <fmt> (see below)
namespace is managed.
<proto> names starting with "RTP/" MUST only be used for defining
transport protocols that are profiles of RTP. For example, a profile
whose short name is "XYZ" would be denoted by a <proto> subfield of
"RTP/XYZ".
Each transport protocol, defined by the <proto> subfield, has an
associated <fmt> namespace that describes the media formats that may
be conveyed by that protocol. Formats cover all the possible
encodings that could be transported in a multimedia session.
RTP payload formats under the "RTP/AVP" and other "RTP/*" profiles
MUST use the payload type number as their <fmt> value. If the
payload type number is dynamically assigned by this session
description, an additional "a=rtpmap:" attribute MUST be included to
specify the format name and parameters as defined by the media type
registration for the payload format. It is RECOMMENDED that other
RTP profiles that are registered (in combination with RTP) as SDP
transport protocols specify the same rules for the <fmt> namespace.
For the "udp" protocol, the allowed <fmt> values are media subtypes
from the IANA Media Types registry. The media type and subtype
combination <media>/<fmt> specifies the format of the body of UDP
packets. Use of an existing media subtype for the format is
encouraged. If no suitable media subtype exists, it is RECOMMENDED
that a new one be registered through the IETF process [RFC6838] by
production of, or reference to, a Standards Track RFC that defines
the format.
For other protocols, formats MAY be registered according to the rules
of the associated <proto> specification.
Registrations of new formats MUST specify which transport protocols
they apply to.
8.2.4. Attribute Names (<attribute-name>)
Attribute-field names (<attribute-name>) MUST be registered with IANA
and documented to avoid any issues due to conflicting attribute
definitions under the same name. (While unknown attributes in SDP
are simply ignored, conflicting ones that fragment the protocol are a
serious problem.)
The format of the <attribute-name> registry is:
+======+==========+=============+==============+===========+
| Type | SDP Name | Usage Level | Mux Category | Reference |
+======+==========+=============+==============+===========+
Table 4: Format of the <attribute-name> Registry
For example, the attribute "a=lang:", which is defined for both
session and media level, will be listed in the new registry as
follows:
+===========+==========+================+==============+===========+
| Type | SDP Name | Usage Level | Mux Category | Reference |
+===========+==========+================+==============+===========+
| attribute | lang | session, media | TRANSPORT | [RFC8866] |
| | | | | [RFC8859] |
+-----------+----------+----------------+--------------+-----------+
Table 5: <attribute-name> Registry Example
This one <attribute-name> registry combines all of the previous
usage-level-specific "att-field" registries, including updates made
by [RFC8859], and renames the "att-field" registry to the "attribute-
name (formerly "att-field")" registry. IANA has completed the
necessary reformatting.
Section 6 of this document replaces the initial set of attribute
definitions made by [RFC4566]. IANA has updated the registry
accordingly.
Documents can define new attributes and can also extend the
definitions of previously defined attributes.
8.2.4.1. New Attributes
New attribute registrations are accepted according to the
"Specification Required" policy of [RFC8126], provided that the
specification includes the following information:
* Contact name
* Contact email address
* Attribute name: the name of the attribute that will appear in SDP.
This MUST conform to the definition of <attribute-name>.
* Attribute syntax: for a value attribute (see Section 5.13), an
ABNF definition of the attribute value <attribute-value> syntax
(see Section 9) MUST be provided. The syntax MUST follow the rule
form per Section 2.2 of [RFC5234] and [RFC7405]. This SHALL
define the allowable values that the attribute might take. It MAY
also define an extension method for the addition of future values.
For a property attribute, the ABNF definition is omitted as the
property attribute takes no values.
* Attribute semantics: for a value attribute, a semantic description
of the values that the attribute might take MUST be provided. The
usage of a property attribute is described under Purpose below.
* Attribute value: the name of an ABNF syntax rule defining the
syntax of the value. Absence of a rule name indicates that the
attribute takes no values. Enclosing the rule name in "[" and "]"
indicates that a value is optional.
* Usage level: the usage level(s) of the attribute. This MUST be
one or more of the following: session, media, source, dcsa, and
dcsa(subprotocol). For a definition of source-level attributes,
see [RFC5576]. For a definition of dcsa attributes see [RFC8864].
* Charset dependent: this MUST be "Yes" or "No" depending on whether
the attribute value is subject to the "a=charset:" attribute.
* Purpose: an explanation of the purpose and usage of the attribute.
* O/A procedures: offer/answer procedures as explained in [RFC3264].
* Mux Category: this MUST indicate one of the following categories:
NORMAL, NOT RECOMMENDED, IDENTICAL, SUM, TRANSPORT, INHERIT,
IDENTICAL-PER-PT, SPECIAL, or TBD as defined by [RFC8859].
* Reference: a reference to the specification defining the
attribute.
The above is the minimum that IANA will accept. Attributes that are
expected to see widespread use and interoperability SHOULD be
documented with a Standards Track RFC that specifies the attribute
more precisely.
Submitters of registrations should ensure that the specification is
in the spirit of SDP attributes, most notably that the attribute is
platform independent in the sense that it makes no implicit
assumptions about operating systems and does not name specific pieces
of software in a manner that might inhibit interoperability.
Submitters of registrations should also carefully choose the
attribute usage level. They should not choose only "session" when
the attribute can have different values when media is disaggregated,
i.e., when each "m=" section has its own IP address on a different
endpoint. In that case, the attribute type chosen should be
"session, media" or "media" (depending on desired semantics). The
default rule is that for all new SDP attributes that can occur both
in session and media level, the media level overrides the session
level. When this is not the case for a new SDP attribute, it MUST be
explicitly stated.
IANA has registered the initial set of attribute names (<attribute-
name> values) with definitions as in Section 6 of this memo (these
definitions replace those in [RFC4566]).
8.2.4.2. Updates to Existing Attributes
Updated attribute registrations are accepted according to the
"Specification Required" policy of [RFC8126].
The Designated Expert reviewing the update is requested to evaluate
whether the update is compatible with the prior intent and use of the
attribute, and whether the new document is of sufficient maturity and
authority in relation to the prior document.
The specification updating the attribute (for example, by adding a
new value) MUST update registration information items from
Section 8.2.4.1 according to the following constraints:
* Contact name: a name for an entity responsible for the update MUST
be provided.
* Contact email address: an email address for an entity responsible
for the update MUST be provided.
* Attribute name: MUST be provided and MUST NOT be changed.
Otherwise it is a new attribute.
* Attribute syntax: the existing rule syntax with the syntax
extensions MUST be provided if there is a change to the syntax. A
revision to an existing attribute usage MAY extend the syntax of
an attribute, but MUST be backward compatible.
* Attribute semantics: a semantic description of new additional
attribute values or a semantic extension of existing values.
Existing attribute values semantics MUST only be extended in a
backward compatible manner.
* Usage level: updates MAY only add additional levels.
* Charset dependent: MUST NOT be changed.
* Purpose: MAY be extended according to the updated usage.
* O/A procedures: MAY be updated in a backward compatible manner
and/or it applies to a new usage level only.
* Mux Category: no change unless from "TBD" to another value (see
[RFC8859]. It MAY also change if media level is being added to
the definition of an attribute that previously did not include it.
* Reference: a new (additional or replacement) reference MUST be
provided.
Items SHOULD be omitted if there is no impact to them as a result of
the attribute update.
8.2.5. Bandwidth Specifiers (<bwtype>)
A proliferation of bandwidth specifiers is strongly discouraged.
New bandwidth specifiers (<bwtype> subfield values) MUST be
registered with IANA. The submission MUST reference a Standards
Track RFC specifying the semantics of the bandwidth specifier
precisely, and indicating when it should be used, and why the
existing registered bandwidth specifiers do not suffice.
The RFC MUST specify the Mux Category for this value as defined by
[RFC8859].
The format of the <bwtype> registry is:
+======+==========+==============+===========+
| Type | SDP Name | Mux Category | Reference |
+======+==========+==============+===========+
Table 6: Format of the <bwtype> Registry
IANA has updated the <bwtype> registry entries for the bandwidth
specifiers "CT" and "AS" with the definitions in Section 5.8 of this
memo (these definitions replace those in [RFC4566]).
8.2.6. Network Types (<nettype>)
Network type "IN", representing the Internet, is defined in
Section 5.2 and Section 5.7 of this memo (this definition replaces
that in [RFC4566]).
To enable SDP to reference a new non-Internet environment, a new
network type (<nettype> subfield value) MUST be registered with IANA.
The registration is subject to the "RFC Required" policy of
[RFC8126]. Although non-Internet environments are not normally the
preserve of IANA, there may be circumstances when an Internet
application needs to interoperate with a non-Internet application,
such as when gatewaying an Internet telephone call into the Public
Switched Telephone Network (PSTN). The number of network types
should be small and should be rarely extended. A new network type
registration MUST reference an RFC that gives details of the network
type and the address type(s) that may be used with it.
The format of the <nettype> registry is:
+======+==========+========================+===========+
| Type | SDP Name | Usable addrtype Values | Reference |
+======+==========+========================+===========+
Table 7: Format of the <nettype> Registry
IANA has updated the <nettype> registry to this new format. The
following is the updated content of the registry:
+=========+==========+========================+===========+
| Type | SDP Name | Usable addrtype Values | Reference |
+=========+==========+========================+===========+
| nettype | IN | IP4, IP6 | [RFC8866] |
+---------+----------+------------------------+-----------+
| nettype | TN | RFC2543 | [RFC2848] |
+---------+----------+------------------------+-----------+
| nettype | ATM | NSAP, GWID, E164 | [RFC3108] |
+---------+----------+------------------------+-----------+
| nettype | PSTN | E164 | [RFC7195] |
+---------+----------+------------------------+-----------+
Table 8: Content of the <nettype> registry
Note that both [RFC7195] and [RFC3108] registered "E164" as an
address type, although [RFC7195] mentions that the "E164" address
type has a different context for ATM and PSTN networks.
8.2.7. Address Types (<addrtype>)
New address types (<addrtype>) MUST be registered with IANA. The
registration is subject to the "RFC Required" policy of [RFC8126]. A
new address type registration MUST reference an RFC, giving details
of the syntax of the address type. Address types are not expected to
be registered frequently.
Section 5.7 of this document gives new definitions of address types
"IP4" and "IP6".
8.3. Encryption Key Access Methods (OBSOLETE)
The IANA previously maintained a table of SDP encryption key access
method ("enckey") names. This table is obsolete, since the "k=" line
is not extensible. New registrations MUST NOT be accepted.
9. SDP Grammar
This section provides an Augmented BNF grammar for SDP. ABNF is
defined in [RFC5234] and [RFC7405].
; SDP Syntax
session-description = version-field
origin-field
session-name-field
[information-field]
[uri-field]
*email-field
*phone-field
[connection-field]
*bandwidth-field
1*time-description
[key-field]
*attribute-field
*media-description
version-field = %s"v" "=" 1*DIGIT CRLF
;this memo describes version 0
origin-field = %s"o" "=" username SP sess-id SP sess-version SP
nettype SP addrtype SP unicast-address CRLF
session-name-field = %s"s" "=" text CRLF
information-field = %s"i" "=" text CRLF
uri-field = %s"u" "=" uri CRLF
email-field = %s"e" "=" email-address CRLF
phone-field = %s"p" "=" phone-number CRLF
connection-field = %s"c" "=" nettype SP addrtype SP
connection-address CRLF
;a connection field must be present
;in every media description or at the
;session level
bandwidth-field = %s"b" "=" bwtype ":" bandwidth CRLF
time-description = time-field
[repeat-description]
repeat-description = 1*repeat-field
[zone-field]
time-field = %s"t" "=" start-time SP stop-time CRLF
repeat-field = %s"r" "=" repeat-interval SP typed-time
1*(SP typed-time) CRLF
zone-field = %s"z" "=" time SP ["-"] typed-time
*(SP time SP ["-"] typed-time) CRLF
key-field = %s"k" "=" key-type CRLF
attribute-field = %s"a" "=" attribute CRLF
media-description = media-field
[information-field]
*connection-field
*bandwidth-field
[key-field]
*attribute-field
media-field = %s"m" "=" media SP port ["/" integer]
SP proto 1*(SP fmt) CRLF
; sub-rules of 'o='
username = non-ws-string
;pretty wide definition, but doesn't
;include space
sess-id = 1*DIGIT
;should be unique for this username/host
sess-version = 1*DIGIT
nettype = token
;typically "IN"
addrtype = token
;typically "IP4" or "IP6"
; sub-rules of 'u='
uri = URI-reference
; see RFC 3986
; sub-rules of 'e=', see RFC 5322 for definitions
email-address = address-and-comment / dispname-and-address
/ addr-spec
address-and-comment = addr-spec 1*SP "(" 1*email-safe ")"
dispname-and-address = 1*email-safe 1*SP "<" addr-spec ">"
; sub-rules of 'p='
phone-number = phone *SP "(" 1*email-safe ")" /
1*email-safe "<" phone ">" /
phone
phone = ["+"] DIGIT 1*(SP / "-" / DIGIT)
; sub-rules of 'c='
connection-address = multicast-address / unicast-address
; sub-rules of 'b='
bwtype = token
bandwidth = 1*DIGIT
; sub-rules of 't='
start-time = time / "0"
stop-time = time / "0"
time = POS-DIGIT 9*DIGIT
; Decimal representation of time in
; seconds since January 1, 1900 UTC.
; The representation is an unbounded
; length field containing at least
; 10 digits. Unlike some representations
; used elsewhere, time in SDP does not
; wrap in the year 2036.
; sub-rules of 'r=' and 'z='
repeat-interval = POS-DIGIT *DIGIT [fixed-len-time-unit]
typed-time = 1*DIGIT [fixed-len-time-unit]
fixed-len-time-unit = %s"d" / %s"h" / %s"m" / %s"s"
; NOTE: These units are case-sensitive.
; sub-rules of 'k='
key-type = %s"prompt" /
%s"clear:" text /
%s"base64:" base64 /
%s"uri:" uri
; NOTE: These names are case-sensitive.
base64 = *base64-unit [base64-pad]
base64-unit = 4base64-char
base64-pad = 2base64-char "==" / 3base64-char "="
base64-char = ALPHA / DIGIT / "+" / "/"
; sub-rules of 'a='
attribute = (attribute-name ":" attribute-value) /
attribute-name
attribute-name = token
attribute-value = byte-string
att-field = attribute-name ; for backward compatibility
; sub-rules of 'm='
media = token
;typically "audio", "video", "text", "image"
;or "application"
fmt = token
;typically an RTP payload type for audio
;and video media
proto = token *("/" token)
;typically "RTP/AVP", "RTP/SAVP", "udp",
;or "RTP/SAVPF"
port = 1*DIGIT
; generic sub-rules: addressing
unicast-address = IP4-address / IP6-address / FQDN / extn-addr
multicast-address = IP4-multicast / IP6-multicast / FQDN
/ extn-addr
IP4-multicast = m1 3( "." decimal-uchar )
"/" ttl [ "/" numaddr ]
; IP4 multicast addresses may be in the
; range 224.0.0.0 to 239.255.255.255
m1 = ("22" ("4"/"5"/"6"/"7"/"8"/"9")) /
("23" DIGIT )
IP6-multicast = IP6-address [ "/" numaddr ]
; IP6 address starting with FF
numaddr = integer
ttl = (POS-DIGIT *2DIGIT) / "0"
FQDN = 4*(alpha-numeric / "-" / ".")
; fully qualified domain name as specified
; in RFC 1035 (and updates)
IP4-address = b1 3("." decimal-uchar)
b1 = decimal-uchar
; less than "224"
IP6-address = 6( h16 ":" ) ls32
/ "::" 5( h16 ":" ) ls32
/ [ h16 ] "::" 4( h16 ":" ) ls32
/ [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
/ [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
/ [ *3( h16 ":" ) h16 ] "::" h16 ":" ls32
/ [ *4( h16 ":" ) h16 ] "::" ls32
/ [ *5( h16 ":" ) h16 ] "::" h16
/ [ *6( h16 ":" ) h16 ] "::"
h16 = 1*4HEXDIG
ls32 = ( h16 ":" h16 ) / IP4-address
; Generic for other address families
extn-addr = non-ws-string
; generic sub-rules: datatypes
text = byte-string
;default is to interpret this as UTF8 text.
;ISO 8859-1 requires "a=charset:ISO-8859-1"
;session-level attribute to be used
byte-string = 1*(%x01-09/%x0B-0C/%x0E-FF)
;any byte except NUL, CR, or LF
non-ws-string = 1*(VCHAR/%x80-FF)
;string of visible characters
token-char = ALPHA / DIGIT
/ "!" / "#" / "$" / "%" / "&"
/ "'" ; (single quote)
/ "*" / "+" / "-" / "." / "^" / "_"
/ "`" ; (Grave accent)
/ "{" / "|" / "}" / "~"
token = 1*(token-char)
email-safe = %x01-09/%x0B-0C/%x0E-27/%x2A-3B/%x3D/%x3F-FF
;any byte except NUL, CR, LF, or the quoting
;characters ()<>
integer = POS-DIGIT *DIGIT
zero-based-integer = "0" / integer
non-zero-int-or-real = integer / non-zero-real
non-zero-real = zero-based-integer "." *DIGIT POS-DIGIT
; generic sub-rules: primitives
alpha-numeric = ALPHA / DIGIT
POS-DIGIT = %x31-39 ; 1 - 9
decimal-uchar = DIGIT
/ POS-DIGIT DIGIT
/ ("1" 2(DIGIT))
/ ("2" ("0"/"1"/"2"/"3"/"4") DIGIT)
/ ("2" "5" ("0"/"1"/"2"/"3"/"4"/"5"))
; external references:
ALPHA = <ALPHA definition from RFC 5234>
DIGIT = <DIGIT definition from RFC 5234>
CRLF = <CRLF definition from RFC 5234>
HEXDIG = <HEXDIG definition from RFC 5234>
SP = <SP definition from RFC 5234>
VCHAR = <VCHAR definition from RFC 5234>
URI-reference = <URI-reference definition from RFC 3986>
addr-spec = <addr-spec definition from RFC 5322>
10. Summary of Changes from RFC 4566
* Generally clarified and refined terminology. Aligned terms used
in text with the ABNF. The terms <attribute>, <att-field>, and
"att-field" are now <attribute-name>. The terms <value> and <att-
value> are now <attribute-value>. The term "media" is now
<media>.
* Identified now-obsolete items: "a=cat:" (Section 6.1), "a=keywds:"
(Section 6.2), and "k=" (Section 5.12).
* Updated normative and informative references, and added references
to additional relevant related RFCs.
* Reformatted the SDP Attributes section (Section 6) for
readability. The syntax of attribute values is now given in ABNF.
* Made mandatory the sending of RTCP with inactive media streams
(Section 6.7.4).
* Removed the section "Private Sessions". That section dated back
to a time when the primary use of SDP was with SAP (Session
Announcement Protocol), which has fallen out of use. Now the vast
majority of uses of SDP is for establishment of private sessions.
The considerations for that are covered in Section 7.
* Expanded and clarified the specification of the "a=lang:"
(Section 6.12) and "a=sdplang:" (Section 6.11) attributes.
* Removed some references to SAP because it is no longer in
widespread use.
* Changed the way <fmt> values for UDP transport are registered
(Section 8.2.3).
* Changed the mechanism and documentation required for registering
new attributes (Section 8.2.4.1).
* Tightened up IANA registration procedures for extensions. Removed
phone number and long-form name (Section 8.2).
* Expanded the IANA <nettype> registry to identify valid <addrtype>
subfields (Section 8.2.6).
* Reorganized the several IANA "att-field" registries into a single
<attribute-name> registry (Section 8.2.4).
* Revised ABNF syntax (Section 9) for clarity and for alignment with
text. Backward compatibility is maintained with a few exceptions.
Of particular note:
- Revised the syntax of time descriptions ("t=", "r=", "z=") to
remove ambiguities. Clarified that "z=" only modifies the
immediately preceding "r=" lines. Made "z=" without a
preceding "r=" a syntax error (Section 5.11). (This is
incompatible with certain aberrant usage.)
- Updated the "IP6-address" and "IP6-multicast" rules, consistent
with the syntax in [RFC3986], mirroring a bug fix made to
[RFC3261] by [RFC5954]. Removed rules that were unused as a
result of this change.
- The "att-field" rule has been renamed "attribute-name" because
elsewhere "*-field" always refers to a complete line. However,
the rulename "att-field" remains defined as a synonym for
backward compatibility with references from other RFCs.
- The "att-value" rule has been renamed "attribute-value".
* Revised normative statements that were redundant with ABNF syntax,
making the text non-normative.
* Revised IPv4 unicast and multicast addresses in the example SDP
descriptions per [RFC5735] and [RFC5771].
* Changed some examples to use IPv6 addresses, and added additional
examples using IPv6.
* Incorporated case-insensitivity rules from [RFC4855].
* Revised sections that incorrectly referenced NTP (Section 5.2,
Section 5.9, Section 5.10, and Section 5.11).
* Clarified the explanation of the impact and use of the
"a=charset:" attribute (Section 6.10).
* Revised the description of the "a=type:" attribute to remove
implication that it sometimes changes the default media direction
to something other than "a=sendrecv" (Section 6.9).
11. References
11.1. Normative References
[E164] International Telecommunication Union, "E.164 : The
international public telecommunication numbering plan",
ITU Recommendation E.164, November 2010,
<https://www.itu.int/rec/T-REC-E.164-201011-I/en>.
[ISO.8859-1.1998]
International Organization for Standardization,
"Information technology - 8-bit single byte coded graphic
- character sets - Part 1: Latin alphabet No. 1, JTC1/
SC2", ISO/IEC Standard 8859-1, 1998.
[RFC1034] Mockapetris, P., "Domain names - concepts and facilities",
STD 13, RFC 1034, DOI 10.17487/RFC1034, November 1987,
<https://www.rfc-editor.org/info/rfc1034>.
[RFC1035] Mockapetris, P., "Domain names - implementation and
specification", STD 13, RFC 1035, DOI 10.17487/RFC1035,
November 1987, <https://www.rfc-editor.org/info/rfc1035>.
[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>.
[RFC2848] Petrack, S. and L. Conroy, "The PINT Service Protocol:
Extensions to SIP and SDP for IP Access to Telephone Call
Services", RFC 2848, DOI 10.17487/RFC2848, June 2000,
<https://www.rfc-editor.org/info/rfc2848>.
[RFC2978] Freed, N. and J. Postel, "IANA Charset Registration
Procedures", BCP 19, RFC 2978, DOI 10.17487/RFC2978,
October 2000, <https://www.rfc-editor.org/info/rfc2978>.
[RFC3108] Kumar, R. and M. Mostafa, "Conventions for the use of the
Session Description Protocol (SDP) for ATM Bearer
Connections", RFC 3108, DOI 10.17487/RFC3108, May 2001,
<https://www.rfc-editor.org/info/rfc3108>.
[RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO
10646", STD 63, RFC 3629, DOI 10.17487/RFC3629, November
2003, <https://www.rfc-editor.org/info/rfc3629>.
[RFC3986] 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>.
[RFC4566] Handley, M., Jacobson, V., and C. Perkins, "SDP: Session
Description Protocol", RFC 4566, DOI 10.17487/RFC4566,
July 2006, <https://www.rfc-editor.org/info/rfc4566>.
[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>.
[RFC5576] Lennox, J., Ott, J., and T. Schierl, "Source-Specific
Media Attributes in the Session Description Protocol
(SDP)", RFC 5576, DOI 10.17487/RFC5576, June 2009,
<https://www.rfc-editor.org/info/rfc5576>.
[RFC5646] Phillips, A., Ed. and M. Davis, Ed., "Tags for Identifying
Languages", BCP 47, RFC 5646, DOI 10.17487/RFC5646,
September 2009, <https://www.rfc-editor.org/info/rfc5646>.
[RFC5890] Klensin, J., "Internationalized Domain Names for
Applications (IDNA): Definitions and Document Framework",
RFC 5890, DOI 10.17487/RFC5890, August 2010,
<https://www.rfc-editor.org/info/rfc5890>.
[RFC5952] Kawamura, S. and M. Kawashima, "A Recommendation for IPv6
Address Text Representation", RFC 5952,
DOI 10.17487/RFC5952, August 2010,
<https://www.rfc-editor.org/info/rfc5952>.
[RFC7195] Garcia-Martin, M. and S. Veikkolainen, "Session
Description Protocol (SDP) Extension for Setting Audio and
Video Media Streams over Circuit-Switched Bearers in the
Public Switched Telephone Network (PSTN)", RFC 7195,
DOI 10.17487/RFC7195, May 2014,
<https://www.rfc-editor.org/info/rfc7195>.
[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>.
[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>.
[RFC8859] Nandakumar, S., "A Framework for Session Description
Protocol (SDP) Attributes When Multiplexing", RFC 8859,
DOI 10.17487/RFC8859, January 2021,
<https://www.rfc-editor.org/info/rfc8859>.
[RFC8864] Drage, K., Makaraju, M., Ejzak, R., Marcon, J., and R.
Even, Ed., "Negotiation Data Channels Using the Session
Description Protocol (SDP)", RFC 8864,
DOI 10.17487/RFC8864, January 2021,
<https://www.rfc-editor.org/info/rfc8864>.
11.2. Informative References
[ITU.H332.1998]
International Telecommunication Union, "H.332 : H.323
extended for loosely coupled conferences", ITU
Recommendation H.332, September 1998,
<https://www.itu.int/rec/T-REC-H.332-199809-I/en>.
[RFC2045] Freed, N. and N. Borenstein, "Multipurpose Internet Mail
Extensions (MIME) Part One: Format of Internet Message
Bodies", RFC 2045, DOI 10.17487/RFC2045, November 1996,
<https://www.rfc-editor.org/info/rfc2045>.
[RFC2327] Handley, M. and V. Jacobson, "SDP: Session Description
Protocol", RFC 2327, DOI 10.17487/RFC2327, April 1998,
<https://www.rfc-editor.org/info/rfc2327>.
[RFC2974] Handley, M., Perkins, C., and E. Whelan, "Session
Announcement Protocol", RFC 2974, DOI 10.17487/RFC2974,
October 2000, <https://www.rfc-editor.org/info/rfc2974>.
[RFC3261] Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston,
A., Peterson, J., Sparks, R., Handley, M., and E.
Schooler, "SIP: Session Initiation Protocol", RFC 3261,
DOI 10.17487/RFC3261, June 2002,
<https://www.rfc-editor.org/info/rfc3261>.
[RFC3264] Rosenberg, J. and H. Schulzrinne, "An Offer/Answer Model
with Session Description Protocol (SDP)", RFC 3264,
DOI 10.17487/RFC3264, June 2002,
<https://www.rfc-editor.org/info/rfc3264>.
[RFC3550] Schulzrinne, H., Casner, S., Frederick, R., and V.
Jacobson, "RTP: A Transport Protocol for Real-Time
Applications", STD 64, RFC 3550, DOI 10.17487/RFC3550,
July 2003, <https://www.rfc-editor.org/info/rfc3550>.
[RFC3551] Schulzrinne, H. and S. Casner, "RTP Profile for Audio and
Video Conferences with Minimal Control", STD 65, RFC 3551,
DOI 10.17487/RFC3551, July 2003,
<https://www.rfc-editor.org/info/rfc3551>.
[RFC3556] Casner, S., "Session Description Protocol (SDP) Bandwidth
Modifiers for RTP Control Protocol (RTCP) Bandwidth",
RFC 3556, DOI 10.17487/RFC3556, July 2003,
<https://www.rfc-editor.org/info/rfc3556>.
[RFC3605] Huitema, C., "Real Time Control Protocol (RTCP) attribute
in Session Description Protocol (SDP)", RFC 3605,
DOI 10.17487/RFC3605, October 2003,
<https://www.rfc-editor.org/info/rfc3605>.
[RFC3711] Baugher, M., McGrew, D., Naslund, M., Carrara, E., and K.
Norrman, "The Secure Real-time Transport Protocol (SRTP)",
RFC 3711, DOI 10.17487/RFC3711, March 2004,
<https://www.rfc-editor.org/info/rfc3711>.
[RFC3840] Rosenberg, J., Schulzrinne, H., and P. Kyzivat,
"Indicating User Agent Capabilities in the Session
Initiation Protocol (SIP)", RFC 3840,
DOI 10.17487/RFC3840, August 2004,
<https://www.rfc-editor.org/info/rfc3840>.
[RFC3890] Westerlund, M., "A Transport Independent Bandwidth
Modifier for the Session Description Protocol (SDP)",
RFC 3890, DOI 10.17487/RFC3890, September 2004,
<https://www.rfc-editor.org/info/rfc3890>.
[RFC4568] Andreasen, F., Baugher, M., and D. Wing, "Session
Description Protocol (SDP) Security Descriptions for Media
Streams", RFC 4568, DOI 10.17487/RFC4568, July 2006,
<https://www.rfc-editor.org/info/rfc4568>.
[RFC4855] Casner, S., "Media Type Registration of RTP Payload
Formats", RFC 4855, DOI 10.17487/RFC4855, February 2007,
<https://www.rfc-editor.org/info/rfc4855>.
[RFC5124] Ott, J. and E. Carrara, "Extended Secure RTP Profile for
Real-time Transport Control Protocol (RTCP)-Based Feedback
(RTP/SAVPF)", RFC 5124, DOI 10.17487/RFC5124, February
2008, <https://www.rfc-editor.org/info/rfc5124>.
[RFC5322] Resnick, P., Ed., "Internet Message Format", RFC 5322,
DOI 10.17487/RFC5322, October 2008,
<https://www.rfc-editor.org/info/rfc5322>.
[RFC5735] Cotton, M. and L. Vegoda, "Special Use IPv4 Addresses",
RFC 5735, DOI 10.17487/RFC5735, January 2010,
<https://www.rfc-editor.org/info/rfc5735>.
[RFC5771] Cotton, M., Vegoda, L., and D. Meyer, "IANA Guidelines for
IPv4 Multicast Address Assignments", BCP 51, RFC 5771,
DOI 10.17487/RFC5771, March 2010,
<https://www.rfc-editor.org/info/rfc5771>.
[RFC5888] Camarillo, G. and H. Schulzrinne, "The Session Description
Protocol (SDP) Grouping Framework", RFC 5888,
DOI 10.17487/RFC5888, June 2010,
<https://www.rfc-editor.org/info/rfc5888>.
[RFC5954] Gurbani, V., Ed., Carpenter, B., Ed., and B. Tate, Ed.,
"Essential Correction for IPv6 ABNF and URI Comparison in
RFC 3261", RFC 5954, DOI 10.17487/RFC5954, August 2010,
<https://www.rfc-editor.org/info/rfc5954>.
[RFC6466] Salgueiro, G., "IANA Registration of the 'image' Media
Type for the Session Description Protocol (SDP)",
RFC 6466, DOI 10.17487/RFC6466, December 2011,
<https://www.rfc-editor.org/info/rfc6466>.
[RFC6838] Freed, N., Klensin, J., and T. Hansen, "Media Type
Specifications and Registration Procedures", BCP 13,
RFC 6838, DOI 10.17487/RFC6838, January 2013,
<https://www.rfc-editor.org/info/rfc6838>.
[RFC7230] Fielding, R., Ed. and J. Reschke, Ed., "Hypertext Transfer
Protocol (HTTP/1.1): Message Syntax and Routing",
RFC 7230, DOI 10.17487/RFC7230, June 2014,
<https://www.rfc-editor.org/info/rfc7230>.
[RFC7405] Kyzivat, P., "Case-Sensitive String Support in ABNF",
RFC 7405, DOI 10.17487/RFC7405, December 2014,
<https://www.rfc-editor.org/info/rfc7405>.
[RFC7656] Lennox, J., Gross, K., Nandakumar, S., Salgueiro, G., and
B. Burman, Ed., "A Taxonomy of Semantics and Mechanisms
for Real-Time Transport Protocol (RTP) Sources", RFC 7656,
DOI 10.17487/RFC7656, November 2015,
<https://www.rfc-editor.org/info/rfc7656>.
[RFC7826] Schulzrinne, H., Rao, A., Lanphier, R., Westerlund, M.,
and M. Stiemerling, Ed., "Real-Time Streaming Protocol
Version 2.0", RFC 7826, DOI 10.17487/RFC7826, December
2016, <https://www.rfc-editor.org/info/rfc7826>.
[RFC8445] Keranen, A., Holmberg, C., and J. Rosenberg, "Interactive
Connectivity Establishment (ICE): A Protocol for Network
Address Translator (NAT) Traversal", RFC 8445,
DOI 10.17487/RFC8445, July 2018,
<https://www.rfc-editor.org/info/rfc8445>.
[RFC8839] Petit-Huguenin, M., Nandakumar, S., Holmberg, C., Keränen,
A., and R. Shpount, "Session Description Protocol (SDP)
Offer/Answer Procedures for Interactive Connectivity
Establishment (ICE)", RFC 8839, DOI 10.17487/RFC8839,
January 2021, <https://www.rfc-editor.org/info/rfc8839>.
[RFC8843] Holmberg, C., Alvestrand, H., and C. Jennings,
"Negotiating Media Multiplexing Using the Session
Description Protocol (SDP)", RFC 8843,
DOI 10.17487/RFC8843, January 2021,
<https://www.rfc-editor.org/info/rfc8843>.
Acknowledgements
Many people in the IETF Multiparty Multimedia Session Control
(MMUSIC) working group have made comments and suggestions
contributing to this document.
In particular, we would like to thank the following people who
contributed to the creation of this document or one of its
predecessor documents: Adam Roach, Allison Mankin, Bernie Hoeneisen,
Bill Fenner, Carsten Bormann, Eve Schooler, Flemming Andreasen,
Gonzalo Camarillo, Jörg Ott, John Elwell, Jon Peterson, Jonathan
Lennox, Jonathan Rosenberg, Keith Drage, Peter Parnes, Rob Lanphier,
Ross Finlayson, Sean Olson, Spencer Dawkins, Steve Casner, Steve
Hanna, Van Jacobson.
Authors' Addresses
Ali Begen
Networked Media
Turkey
Email: ali.begen@networked.media
Paul Kyzivat
United States of America
Email: pkyzivat@alum.mit.edu
Colin Perkins
University of Glasgow
School of Computing Science
Glasgow
G12 8QQ
United Kingdom
Email: csp@csperkins.org
Mark Handley
University College London
Department of Computer Science
London
WC1E 6BT
United Kingdom
Email: M.Handley@cs.ucl.ac.uk
|