RFC 6038
RFC 6038
Morton
Request for Comments: 6038 L. Ciavattone
Updates: 5357 AT&T Labs
Category: Standards Track October 2010
ISSN: 2070-1721
Abstract
This memo describes two closely related features for the core
specification of the Two-Way Active Measurement Protocol (TWAMP): an
optional capability where the responding host returns some of the
command octets or padding octets to the sender, and an optional
sender packet format that ensures equal test packet sizes are used in
both directions.
Copyright Notice
Copyright (c) 2010 IETF Trust and the persons identified as the
document authors. All rights reserved.
Table of Contents
1. Introduction ....................................................3
2. Requirements Language ...........................................3
3. Purpose and Scope ...............................................4
4. TWAMP Control Extensions ........................................4
4.1. Connection Setup with New Features .........................5
4.2. Reflect Octets: Request-TW-Session Packet Format ...........6
4.3. Reflect Octets: Accept Session Packet Format ...............7
4.4. Additional Considerations ..................................9
5. Extended TWAMP Test .............................................9
5.1. Sender Behavior ............................................9
5.1.1. Packet Timings ......................................9
5.1.2. Reflect Octets: Packet Formats and Contents .........9
5.1.3. Reflect Octets: Interaction with Padding
Truncation .........................................11
5.1.4. Symmetrical Size: Session-Sender Packet Format .....13
5.1.5. Symmetrical Size AND Reflect Octets:
Session-Sender Packet ..............................14
5.2. Reflector Behavior ........................................14
5.2.1. Reflect Octets: Session-Reflector Packet
Format and Contents ................................15
5.2.2. Symmetrical Size: Session-Reflector Packet Format ..16
5.2.3. Symmetrical Size AND Reflect Octets:
Session-Sender Packet Format .......................16
6. Security Considerations ........................................17
7. IANA Considerations ............................................17
7.1. Registry Specification ....................................17
7.2. Registry Contents .........................................17
8. Acknowledgements ...............................................17
9. Normative References ...........................................18
1. Introduction
Throughout this memo, the bits marked MBZ (Must Be Zero) MUST be set
to zero by senders and MUST be ignored by receivers. Also, the HMAC
(Hashed Message Authentication Code) MUST be calculated as defined in
Section 3.2 of [RFC4656].
2. Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
When the Server and Control-Client have agreed to use the Reflect
Octets mode during control connection setup, then the Control-Client,
the Server, the Session-Sender, and the Session-Reflector MUST all
conform to the requirements of that mode, as identified below.
When the Server and Control-Client have agreed to use the Symmetrical
Size mode during control connection setup, then the Control-Client,
the Server, the Session-Sender, and the Session-Reflector MUST all
conform to the requirements of that mode, as identified below.
The Server sets one or both of the new bit positions in the Modes
field of the Server Greeting message to indicate its capabilities and
willingness to operate in either of these modes (or both) if desired.
The bits designated for the Reflect Octets feature in the Request-TW-
Session command are as shown in the packet format 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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 5 | MBZ | IPVN | Conf-Sender | Conf-Receiver |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Number of Schedule Slots |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
. .
. ... Many fields (66 octets) not shown ... .
. .
. .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Padding Length (4 octets) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Start Time (8 octets) |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Timeout (8 octets) |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Type-P Descriptor |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Octets to be reflected | Length of padding to reflect |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| MBZ (4 octets) |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
| HMAC (16 octets) |
| |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
The Padding Length SHALL be > the Length of padding to reflect when
specifying a test session using the OPTIONAL Reflect Octets mode.
The bits designated for the Reflect Padding feature in the Accept
Session command are as shown in the packet format 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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Accept | MBZ | Port |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
| |
| SID (16 octets) |
| |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Reflected octets | Server octets |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| MBZ (8 octets) |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
| HMAC (16 octets) |
| |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
The Reflected octets field SHALL contain the octets from the Request-
TW-Session Octets to be reflected field and be 2 octets long, as
shown.
The Server octets field SHALL contain information that the Server
intends to be returned in the TWAMP-Test Packet Padding (to be
reflected) field, OR SHALL be zero, and be 2 octets long, as shown.
Although the Server determines the SID, this field is very long (16
octets) and does not normally appear in TWAMP-Test packets. The
following items MUST be part of compliant implementations using the
Reflect Octets feature:
The value of the Modes field sent by the Server in the Server
Greeting message is the bit-wise OR of the mode values that it is
willing to support during this session.
With the publication of this memo as an RFC, the last 7 bit positions
of the Modes 32-bit field are used. A Control-Client conforming to
this extension of [RFC5357] MAY ignore the values in the higher bits
of the Modes field, or it MAY support other features that are
communicated in those bit positions. The other bits are available
for future protocol extensions.
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sequence Number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Timestamp |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Error Estimate | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +
| |
| Packet Padding (to be reflected) |
. (length in octets specified in command) .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
. .
. Additional Packet Padding .
. .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Server octets |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| |
| Remaining Packet Padding (to be reflected) |
. (total length in octets specified in command) .
. .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
The Server octets field contains the same information that the Server
returned to the Control-Client in the Accept-Session message
corresponding to this specific test session (see Section 4.3). At
the Session-Reflector, these octets MUST be reflected the same as the
rest of the Packet Padding (to be reflected) field.
When using the truncation process in TWAMP alone, see Section 4.2.1
of [RFC5357], the Session-Sender MUST append sufficient Packet
Padding octets to allow the same IP packet payload lengths to be used
in each direction of transmission (this is usually desirable). To
compensate for the Session-Reflector's larger test packet format, the
Session-Sender MUST append at least 27 octets of padding in
Unauthenticated mode, and at least 56 octets in Authenticated and
Encrypted modes. The sizes of TWAMP-Test protocol packets and the
resulting truncated padding to achieve equal packet sizes in both
directions are shown in the table below:
+-------------------+----------------------+---------------------+
| Octets in: | Unauthenticated Mode | Auth/Encrypted Mode |
+-------------------+----------------------+---------------------+
| Reflector Header | 41 | 104 |
| Sender Header | 14 | 48 |
| Truncated Padding | 27 | 56 |
+-------------------+----------------------+---------------------+
When using the Reflect Octets mode simultaneously with the truncation
process that TWAMP recommends in Section 4.2.1 of [RFC5357], the
Session-Sender MUST append at least 27 octets of padding plus the
Length of the padding to reflect octets when operating in
Unauthenticated mode. The Session-Sender MUST append at least 56
octets of padding plus the Length of the padding to reflect octets
when operating in Authenticated and Encrypted modes.
Unauthenticated Mode
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sequence Number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Timestamp |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Error Estimate | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +
| |
| |
| MBZ (27 octets) |
| |
| |
| |
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| | |
+-+-+-+-+-+-+-+-+ +
. .
. Packet Padding .
. .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
When both the Symmetrical Size mode and the Reflect Octets mode are
selected, the Session-Sender SHALL use the following TWAMP-Test
Packet Format in Unauthenticated mode:
Unauthenticated Mode
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sequence Number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Timestamp |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Error Estimate | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +
| |
| |
| MBZ (27 octets) |
| |
| |
| |
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| | |
+-+-+-+-+-+-+-+-+ +
| Packet Padding (to be reflected) |
. (length in octets specified in command) .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
. .
. Additional Packet Padding .
. .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sequence Number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Timestamp |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Error Estimate | MBZ |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Receive Timestamp |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sender Sequence Number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sender Timestamp |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sender Error Estimate | MBZ |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Sender TTL | Packet Padding (from Session-Sender) |
+-+-+-+-+-+-+-+-+ +
. .
+ +-+-+-+-+-+-+-+-+
| Packet Padding (from Session-Sender) | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +
| |
| |
. Additional Packet Padding .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
When the Server has returned a non-zero value in the Server octets
field of the Accept Session message (as described in Section 4.3),
then the Session-Reflector SHALL reflect these octets the same as the
rest of the Packet Padding (to be reflected) field.
When both the Symmetrical Size mode and the Reflect Octets mode are
selected, the Session-Reflector MUST operate using the Session-Sender
Packet Format defined in Section 5.1.5, where the Padding Octets are
separated from the information fields, and the Packet Padding (to be
reflected) field precedes the Additional Padding.
6. Security Considerations
7. IANA Considerations
This memo adds two modes to the IANA registry for the TWAMP Modes
field, and describes behavior when the new modes are used. This
field is a recognized extension mechanism for TWAMP.
8. Acknowledgements
The authors thank Steve Baillargeon, Walt Steverson, and Stina Ross
for helpful review and comments.
9. Normative References
[RFC4656] Shalunov, S., Teitelbaum, B., Karp, A., Boote, J., and M.
Zekauskas, "A One-way Active Measurement Protocol
(OWAMP)", RFC 4656, September 2006.
[RFC5357] Hedayat, K., Krzanowski, R., Morton, A., Yum, K., and J.
Babiarz, "A Two-Way Active Measurement Protocol (TWAMP)",
RFC 5357, October 2008.
Authors' Addresses
Al Morton
AT&T Labs
200 Laurel Avenue South
Middletown, NJ 07748
USA
Len Ciavattone
AT&T Labs
200 Laurel Avenue South
Middletown, NJ 07748
USA