rfc3015.txt

RFC 的详细文档！

Network Working Group                                           F. Cuervo
Request for Comments: 3015                                      N. Greene
Obsoletes: 2885, 2886                                           A. Rayhan
Category: Standards Track                                 Nortel Networks
                                                               C. Huitema
                                                    Microsoft Corporation
                                                                 B. Rosen
                                                                  Marconi
                                                                J. Segers
                                                      Lucent Technologies
                                                            November 2000


                      Megaco Protocol Version 1.0

Status of this Memo

   This document specifies an Internet standards track protocol for the
   Internet community, and requests discussion and suggestions for
   improvements.  Please refer to the current edition of the "Internet
   Official Protocol Standards" (STD 1) for the standardization state
   and status of this protocol.  Distribution of this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (2000).  All Rights Reserved.

Abstract

   This document defines the protocol used between elements of a
   physically decomposed multimedia gateway, i.e. a Media Gateway and a
   Media Gateway Controller.  The document is common text with ITU-T
   Recommendation H.248 and is a result of applying the changes in RFC
   2886 to the text of RFC 2885.

   The protocol presented in this document meets the requirements for a
   media gateway control protocol as presented in RFC 2805.














Cuervo, et al.              Standards Track                     [Page 1]

RFC 3015              Megaco Protocol Version 1.0          November 2000


TABLE OF CONTENTS

   1. SCOPE........................................................  6
   2. REFERENCES...................................................  6
        2.1 Normative references...................................  6
        2.2 Informative references.................................  9
   3. DEFINITIONS.................................................. 10
   4. ABBREVIATIONS................................................ 11
   5. CONVENTIONS.................................................. 11
   6. CONNECTION MODEL............................................. 11
        6.1 Contexts............................................... 14
                6.1.1 Context Attributes and Descriptors........... 15
                6.1.2 Creating, Deleting and Modifying Contexts.... 15
        6.2 Terminations........................................... 15
                6.2.1 Termination Dynamics......................... 16
                6.2.2 TerminationIDs............................... 17
                6.2.3 Packages..................................... 17
                6.2.4 Termination Properties and Descriptors....... 18
                6.2.5 Root Termination............................. 21
   7. COMMANDS..................................................... 21
        7.1 Descriptors............................................ 22
                7.1.1 Specifying Parameters........................ 22
                7.1.2 Modem Descriptor............................. 23
                7.1.3 Multiplex Descriptor......................... 23
                7.1.4 Media Descriptor............................. 24
                7.1.5 Termination State Descriptor................. 24
                7.1.6 Stream Descriptor............................ 25
                7.1.7 LocalControl Descriptor...................... 26
                7.1.8 Local and Remote Descriptors................. 27
                7.1.9 Events Descriptor............................ 30
                7.1.10 EventBuffer Descriptor...................... 32
                7.1.11 Signals Descriptor.......................... 32
                7.1.12 Audit Descriptor............................ 34
                7.1.13 ServiceChange Descriptor.................... 35
                7.1.14 DigitMap Descriptor......................... 36
                7.1.15 Statistics Descriptor....................... 41
                7.1.16 Packages Descriptor......................... 41
                7.1.17 ObservedEvents Descriptor................... 42
                7.1.18  Topology Descriptor........................ 42
        7.2 Command Application Programming Interface.............. 45
                7.2.1 Add.......................................... 46
                7.2.2 Modify....................................... 47
                7.2.3 Subtract..................................... 48
                7.2.4 Move......................................... 49
                7.2.5 AuditValue................................... 50
                7.2.6 AuditCapabilities............................ 52
                7.2.7 Notify....................................... 53
                7.2.8 ServiceChange................................ 54



Cuervo, et al.              Standards Track                     [Page 2]

RFC 3015              Megaco Protocol Version 1.0          November 2000


                7.2.9 Manipulating and Auditing Context Attributes. 58
                7.2.10 Generic Command Syntax...................... 58
        7.3 Command Error Codes.................................... 58
   8. TRANSACTIONS................................................. 60
        8.1 Common Parameters...................................... 62
                8.1.1 Transaction Identifiers...................... 62
                8.1.2 Context Identifiers.......................... 62
        8.2 Transaction Application Programming Interface.......... 63
                8.2.1 TransactionRequest........................... 63
                8.2.2 TransactionReply............................. 63
                8.2.3 TransactionPending........................... 65
        8.3 Messages............................................... 65
   9. TRANSPORT.................................................... 65
        9.1 Ordering of Commands................................... 66
        9.2 Protection against Restart Avalanche................... 67
   10. SECURITY CONSIDERATIONS..................................... 68
        10.1 Protection of Protocol Connections.................... 68
        10.2 Interim AH scheme..................................... 69
        10.3 Protection of Media Connections....................... 70
   11.  MG-MGC CONTROL INTERFACE................................... 71
        11.1 Multiple Virtual MGs.................................. 71
        11.2 Cold Start............................................ 72
        11.3 Negotiation of Protocol Version....................... 72
        11.4 Failure of an MG...................................... 73
        11.5 Failure of an MGC..................................... 74
   12. PACKAGE DEFINITION.......................................... 75
        12.1 Guidelines for defining packages...................... 75
                12.1.1 Package..................................... 76
                12.1.2 Properties.................................. 76
                12.1.3 Events...................................... 77
                12.1.4 Signals..................................... 77
                12.1.5 Statistics.................................. 77
                12.1.6 Procedures.................................. 78
        12.2 Guidelines to defining Properties, Statistics and
        Parameters to Events and Signals........................... 78
        12.3 Lists................................................. 78
        12.4 Identifiers........................................... 78
        12.5 Package Registration.................................. 79
   13.  IANA CONSIDERATIONS........................................ 79
        13.1 Packages.............................................. 79
        13.2 Error Codes........................................... 79
        13.3 ServiceChange Reasons................................. 80
   ANNEX A: BINARY ENCODING OF THE PROTOCOL (NORMATIVE)............ 80
        A.1 Coding of wildcards.................................... 81
        A.2 ASN.1 syntax specification............................. 82
        A.3 Digit maps and path names.............................. 99
   ANNEX B TEXT ENCODING OF THE PROTOCOL (NORMATIVE)...............100
        B.1 Coding of wildcards....................................100



Cuervo, et al.              Standards Track                     [Page 3]

RFC 3015              Megaco Protocol Version 1.0          November 2000


        B.2 ABNF specification.....................................100
   ANNEX C TAGS FOR MEDIA STREAM PROPERTIES (NORMATIVE)............112
        C.1 General Media Attributes...............................113
        C.2 Mux Properties.........................................114
        C.3 General bearer properties..............................115
        C.4 General ATM properties.................................115
        C.5 Frame Relay............................................118
        C.6 IP.....................................................118
        C.7 ATM AAL2...............................................119
        C.8 ATM AAL1...............................................120
        C.9 Bearer Capabilities....................................121
        C.10 AAL5 Properties.......................................129
        C.11 SDP Equivalents.......................................130
        C.12 H.245.................................................131
   ANNEX D TRANSPORT OVER IP (NORMATIVE)...........................131
        D.1 Transport over IP/UDP using Application Level Framing..131
                D.1.1 Providing At-Most-Once Functionality.........132
                D.1.2 Transaction identifiers and three-way handshake
                ...................................................132
                D.1.3 Computing retransmission timers..............133
                D.1.4 Provisional responses........................134
                D.1.5 Repeating Requests, Responses and
                Acknowledgements...................................135
        D.2 Using TCP..............................................136
                D.2.1 Providing the At-Most-Once functionality.....137
                D.2.2 Transaction identifiers and three way handshake
                ...................................................137
                D.2.3 Computing retransmission timers..............137
                D.2.4 Provisional responses........................137
                D.2.5 Ordering of commands.........................138
   ANNEX E BASIC PACKAGES (NORMATIVE)..............................138
        E.1 Generic................................................138
                E.1.1 Properties...................................138
                E.1.2 Events.......................................138
                E.1.3 Signals......................................140
                E.1.4 Statistics...................................140
        E.2 Base Root Package......................................140
                E.2.1 Properties...................................140
                E.2.2 Events.......................................142
                E.2.3 Signals......................................142
                E.2.4 Statistics...................................142
                E.2.5 Procedures...................................142
        E.3 Tone Generator Package.................................142
                E.3.1 Properties...................................142
                E.3.2 Events.......................................143
                E.3.3 Signals......................................143
                E.3.4 Statistics...................................143
                E.3.5 Procedures...................................143



Cuervo, et al.              Standards Track                     [Page 4]

RFC 3015              Megaco Protocol Version 1.0          November 2000


        E.4 Tone Detection Package.................................144
                E.4.1 Properties...................................144
                E.4.2 Events.......................................144
                E.4.3 Signals......................................146
                E.4.4 Statistics...................................146
                E.4.5 Procedures...................................146
        E.5 Basic DTMF Generator Package...........................147
                E.5.1 Properties...................................147
                E.5.2 Events.......................................147
                E.5.3 Signals......................................147
                E.5.4 Statistics...................................148
                E.5.5 Procedures...................................148
        E.6 DTMF detection Package.................................148
                E.6.1 Properties...................................149
                E.6.2 Events.......................................149
                E.6.3 Signals......................................150
                E.6.4 Statistics...................................150
                E.6.5 Procedures...................................150
        E.7 Call Progress Tones Generator Package..................151
                E.7.1 Properties...................................151
                E.7.2 Events.......................................151
                E.7.3 Signals......................................151
                E.7.4 Statistics...................................152
                E.7.5 Procedures...................................152
        E.8 Call Progress Tones Detection Package..................152
                E.8.1 Properties...................................152
                E.8.2 Events.......................................153
                E.8.3 Signals......................................153
                E.8.4 Statistics...................................153
                E.8.5 Procedures...................................153
        E.9 Analog Line Supervision Package........................153
                E.9.1 Properties...................................153
                E.9.2 Events.......................................153
                E.9.3 Signals......................................156
                E.9.4 Statistics...................................157
                E.9.5 Procedures...................................157
                E.9.6 Error Code...................................157
        E.10 Basic Continuity Package..............................157
                E.10.1 Properties..................................157
                E.10.2 Events......................................157
                E.10.3 Signals.....................................158
                E.10.4 Statistics..................................158
                E.10.5 Procedures..................................159
        E.11 Network Package.......................................159
                E.11.1 Properties..................................159
                E.11.2 Events......................................160
                E.11.3 Signals.....................................161
                E.11.4 Statistics..................................161



Cuervo, et al.              Standards Track                     [Page 5]

RFC 3015              Megaco Protocol Version 1.0          November 2000


                E.11.5 Procedures..................................162
        E.12 RTP  Package..........................................162