rfc3103.txt

RFC 的详细文档！

   omitting the value field.

   It is not valid for a host to request an address with an FQDN type as
   its local address (See specification of ASSIGN_REQUEST_RSA-IP and
   ASSIGN_REQUEST_RSAP-IP, below).

8.2.  Ports

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 2   |            Length             |     Number    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |           Port number         |  ...
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

   The ports parameter encodes zero or more TCP or UDP ports.  When a
   single port is specified, the value of the number field is 1 and
   there is one port field following the number field.  When more than
   one port is specified, the value of the number field will indicate
   the total number of ports contained, and the parameter may take one
   of two forms.  If there is one port field, the ports specified are
   considered to be contiguous starting at the port number specified in
   the port field.  Alternatively, there may be a number of port fields
   equal to the value of the number field.  The number of port fields
   can be extrapolated from the length field.





Borella, et al.               Experimental                     [Page 12]

RFC 3103              RSIP Protocol Specification           October 2001


   In some cases, it is necessary to specify a don't care value for one
   or more ports (e.g., when a client application is using ephemeral
   source ports).  This is accomplished by setting the length field to
   1, setting the number field to the number of ports necessary, and
   omitting all port fields.  The value of the number field MUST be
   greater than or equal to one.

   If micro-flow based policy applies to a given ports parameter, it
   MUST contain exactly one port field.

8.3.  Lease Time

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 3   |          Length = 4           |   Lease time  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                   Lease time                  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

   The lease time parameter specifies the length, in seconds, of an
   RSIP host registration or parameter binding.

8.4.  Client ID

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 4   |          Length = 4           |   Client ID   |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                    Client ID                  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

   The client ID parameter specifies an RSIP client ID.  Client ID's
   by an RSIP gateway to differentiate RSIP hosts.

8.5.  Bind ID

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 5   |          Length = 4           |    Bind ID    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                     Bind ID                   |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

   The bind ID parameter specifies an RSIP bind ID.  Bind ID's are used
   by RSIP hosts and gateways to differentiate an RSIP host's bindings.



Borella, et al.               Experimental                     [Page 13]

RFC 3103              RSIP Protocol Specification           October 2001


8.6.  Tunnel Type

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 6   |          Length = 1           |  Tunnel type  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

   The tunnel type parameter specifies the type of tunnel used between
   an RSIP host and an RSIP gateway.  Defined tunnel types are:

             Tunnel Type
             -----------
      0      Reserved
      1      IP-IP
      2      GRE
      3      L2TP

8.7.  RSIP Method

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 7   |          Length = 1           |  RSIP method  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

   The RSIP method parameter specifies an RSIP method.  Defined RSIP
   methods are:

             RSIP method
             -----------
      0      Reserved
      1      RSA-IP
      2      RSAP-IP

8.8.  Error

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 8   |          Length = 2           |     Error     |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |     Error     |
   +-+-+-+-+-+-+-+-+

   The error parameter specifies an error.  The currently defined error
   values are presented in Appendix A.




Borella, et al.               Experimental                     [Page 14]

RFC 3103              RSIP Protocol Specification           October 2001


8.9.  Flow Policy

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 9   |          Length = 2           |     Local     |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Remote     |
   +-+-+-+-+-+-+-+-+

   The flow policy parameter specifies both the local and remote flow
   policy.

   Defined local flow policies are:

             Local Flow Policy
             -----------------
      0      Reserved
      1      Macro flows
      2      Micro flows

   Defined remote flow policies are:

             Remote Flow Policy
             ------------------
      0      Reserved
      1      Macro flows
      2      Micro flows
      3      No policy

8.10.  Indicator

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 10  |          Length = 2           |     Value     |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |     Value     |
   +-+-+-+-+-+-+-+-+

   An indicator parameter is a general-purpose parameter, the use of
   which is defined by the message that it appears in.  An RSIP message
   that uses an indicator parameter MUST define the meaning and
   interpretation of all of the indicator's possible values.







Borella, et al.               Experimental                     [Page 15]

RFC 3103              RSIP Protocol Specification           October 2001


8.11.  Message Counter

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 11  |          Length = 4           |     Counter   |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                    Counter                    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

   A message counter parameter is used to mark RSIP messages with
   sequentially-increasing values.  Message counters MUST be used with
   UDP, in order to facilitate reliability.

8.12.  Vendor Specific Parameter

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Type = 12  |            Length             |    Vendor ID  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Vendor ID  |            Subtype            |    Value...
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

   The vendor specific parameter is used to encode parameters that are
   defined by a particular vendor.  The vendor ID field is the vendor-
   specific ID assigned by IANA.  Subtypes are defined and used by each
   vendor as necessary.  An RSIP host or gateway SHOULD silently ignore
   vendor-specific messages that it does not understand.

9.  Message Types

   RSIP messages consist of three mandatory fields, version, message
   type, and overall length, followed by one or more required
   parameters, followed in turn by zero or more optional parameters.  In
   an RSIP message, all required parameters MUST appear in the exact
   order specified below.  Optional parameters MAY appear in any order.
   Message format is shown below:

    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Version    |  Message type |         Overall length        |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    Parameters...
   +-+-+-+-+-+-+-+-+-+-+





Borella, et al.               Experimental                     [Page 16]

RFC 3103              RSIP Protocol Specification           October 2001


   The version number field is a single byte and specifies the RSIP
   version number that is being used.  The current RSIP version number
   is 1.

   The message type field is a single byte and specifies the message
   contained in the current packet.  There may be only one message per
   packet.  Message types are given numerical assignments in Appendix B.

   The overall length field is two bytes and contains the number of
   bytes in the RSIP message, including the three mandatory fields.

   Most parameters are only allowed to appear once in each message.  The
   exceptions are as follows:

      -  Multiple address parameters MUST appear in ASSIGN_REQUEST_RSA-
         IP, ASSIGN_RESPONSE_RSA-IP, ASSIGN_REQUEST_RSAP-IP,
         ASSIGN_RESPONSE_RSAP-IP, LISTEN_REQUEST and LISTEN_RESPONSE.

      -  Multiple ports parameters MUST appear in ASSIGN_REQUEST_RSAP-
         IP, ASSIGN_RESPONSE_RSAP-IP, LISTEN_REQUEST and
         LISTEN_RESPONSE.

      -  Multiple RSIP method and tunnel type parameters MAY appear in
         RESISTER_RESPONSE.

      -  Multiple address parameters and multiple indicator parameters
         MAY appear in QUERY_REQUEST and QUERY_RESPONSE.

   The following message types are defined in BNF.  Required parameters
   are enclosed in <> and MUST appear.  Optional parameters are enclosed
   in [] and MAY appear.  Not all message types need to be implemented
   in order to be RSIP compliant.  For example, an RSIP host and/or
   gateway may not support LISTEN_REQUEST and LISTEN_RESPONSE, or may
   only support RSAP-IP and not RSA-IP.

9.1.  ERROR_RESPONSE

9.1.1.  Description

   An ERROR_RESPONSE is used to provide error messages from an RSIP
   gateway to an RSIP host.  Usually, errors indicate that the RSIP
   gateway cannot or will not perform an action or allocate resources on
   behalf of the host.  If the error is related to a particular client
   ID or bind ID, these associated parameters MUST be included.
   Multiple errors MAY NOT be reported in the same ERROR_RESPONSE.  In
   situations where more than one error has occurred, the RSIP gateway
   MUST choose only one error to report.




Borella, et al.               Experimental                     [Page 17]

RFC 3103              RSIP Protocol Specification           October 2001


9.1.2.  Format

   <ERROR_RESPONSE> ::= <Version>
                        <Message Type>
                        <Overall Length>