view Side-By-Side changes
IPPM Working Group S. Niccolini Internet-Draft S. Tartarelli Intended status: Standards Track J. Quittek Expires:August 26, 2007February 25, 2008 NEC M. Swany UDelFebruary 22,August 24, 2007Traceroute MeasurementsInformation Model and XML Data Modeldraft-ietf-ippm-storetraceroutes-03for Traceroute Measurements draft-ietf-ippm-storetraceroutes-04 Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire onAugust 26, 2007.February 25, 2008. Copyright Notice Copyright (C) The IETF Trust (2007). Abstract Thismemodocument describes a standard way to storetraceroute measurements. To better addressthetraceroute measurements storing issue,configuration and theauthorsresults of traceroute measurements. This document first of allgive a definition of the traceroute tool, describedescribes the toolitself as well as its parameters and the default values on the most common operating systems and the output results Niccolini, et al. Expires August 26, 2007 [Page 1] Internet-Draft Traceroute Storage Format February 2007 that can be stored. Afterwards,itself; afterwards, the common information modelwith the base elements of the traceroute measurement storingis defined dividing the information elements in two semantically separated groups (configuration elements and results ones). Moreover Niccolini, et al. Expires February 25, 2008 [Page 1] Internet-Draft Traceroute Storage Format August 2007 an additional element is defined to relate configuration elements and results ones by means of a common unique identifier. On the basis of the information model a data model based on XML isthen proposed in orderdefined toactuallystore the results of traceroute measurements. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.Definition of Traceroute . . . . .Terminology used in this document . . . . . . . . . . . . . . 32.1. Traceroute Configuration Parameters . . . . . . . . . . . 43.Known Problems withThe Traceroute tool and its operations . . . . . . . . . . . .. . . . 8 3.1. Accuracy of4 4. Results. . . . . . . . . . . . . . . . . . . 8 3.2. Alternativeof tracerouteImplementations . . . . . . . . . . 8 4. Reports/results . . . . . . . . .measurements . . . . . . . . . . . . . .84 5. Information Model forStoringTraceroute Measurements . . . .9. . . . 5 5.1. Data Types . . . . . . . . . . . . . . . . . . . . . . . .96 5.2. Information Elements . . . . . . . . . . . . . . . . . . .107 5.2.1. Configuration Information Elements . . . . . . . . . .117 5.2.2. Results Information Elements . . . . . . . . . . . . .1511 5.2.3. Information Element Correlating Configuration and Results Elements . . . . . . . . . . . . . . . . . . .1815 5.2.4. Information Elements to compare traceroute measurements results one with each other . . . . . . . 15 6. Data Model for Storing Traceroute Measurements . . . . . . . .1916 7. XML Schema for traceroute Measurements . . . . . . . . . . . .2017 8.Differences to DISMAN-TRACEROUTE-MIBSecurity Considerations . . . . . . . . . . . . .38 8.1. Naming. . . . . . 35 8.1. Conducting Traceroute Measurements . . . . . . . . . . . . 35 8.2. Securing Traceroute Measurements Information . . . . . . . 36 9. IANA Considerations .39 8.2. Semantics. . . . . . . . . . . . . . . . . . . . 36 10. References . . . . . .39 8.3. Additional Information Elements. . . . . . . . . . . . .40 9. Security Considerations. . . . . . . 37 10.1. Normative References . . . . . . . . . . . .40 9.1. Conducting. . . . . . . 37 10.2. Informative References . . . . . . . . . . . . . . . . . . 37 Appendix A. TracerouteMeasurementsDefault Configuration Parameters . . . . . 38 A.1. Alternative Traceroute Implementations . . . . . . .40 9.2. Securing. . . 42 Appendix B. Known Problems with TracerouteMeasurement Results. . . . . . . . .41 10. IANA Considerations. . 42 B.1. Compatibility between traceroute measurements results and IPPM metrics . . . . . . . . . . . . . . . . . . . . .41 11. References42 Appendix C. Differences to DISMAN-TRACEROUTE-MIB . . . . . . . . 43 C.1. Naming . . . . . . . . . . . . . . . . . .42 11.1. Normative References. . . . . . . . 44 C.2. Semantics . . . . . . . . . . . . . .42 11.2. Informative References. . . . . . . . . . 44 C.3. Additional Information Elements . . . . . . . .42. . . . . 45 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . .4345 Intellectual Property and Copyright Statements . . . . . . . . . .4547 Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page 2] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007 1. Introduction Traceroutes are being used by lots of measurement efforts, either as an independent measurement or to get path information to support other measurement efforts. That is why there is the need to standardize the waytraceroute measurements are stored andtherelated metrics associated with such measurements. Since traceroute is a tool that has built-in configurable mechanisms like time-outsconfiguration andcan experience problems related tothecrossingresults offirewalls thus experiencing fake losses or incomplete delay information.traceroute measurements are stored. The standard metrics defined by IPPM working group in matter of delay, connectivity and losses do not apply to the metrics returned by the traceroute tool; therefore, in order to compare results of traceroute measurements, thesolutiononly possibility is to add to the stored results a specification of the operating system and version for thetool used. Moreover there is a need to better define thetraceroute toolas well as its parameters and the results it outputs since, to the authors' knowledge, there is so far no standard describing these. These are the motivations that moved the authors to write this draft in the context of the IPPM working group even if other working groups (like DISMAN) have already addressed similar issues related to the definition of the MIB for configuring and retrieving traceroute measurements results.used. Thisdraft,document, in order to storetracerouteresults of traceroute measurements and allow comparison of them, defines a standard way to storetraceroute measurementsthem using a XML schema. Thedraftdocument isorganisedorganized as follows: Section 2givesdefines thedefinition of tracerouteterminology usedas referencein this document, Section 3 describes therest oftraceroute tool, Section 4 describes thedraft as wellresults of a traceroute measurement as displayed to the screen from which the tracerouteconfigurable parameters and their default values for the most common operating systems. Section 3 reports on both traceroute accuracy of results and existing alternatives for traceroute implementations. Section 4 describes the results available from the traceroute output screen.tool was launched. Section 5 and Section 6 respectively describeour proposed Informationthe information model andDatadata model for storing configuration and results of the traceroute measurements.Section 8 reports the differences to [RFC4560].Thedraftdocument ends with security considerations and IANA considerations in Section98 and Section109 respectively. 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. 2.DefinitionTerminology used in this document The terminology used in this document is defined as follow: o traceroute tool: a software tool for network diagnostic behaving like described in Section 3; o traceroute measurement: an instance of the traceroute tool launched, with specific configuration parameters (traceroute measurement configuration parameters), from a specific host (initiator of the traceroute measurement) giving as output specific traceroute measurement results; o traceroute probe: one of many IP packets send out by the traceroute tool during a traceroute measurement; o traceroute measurement configuration parameters: the configuration parameters of a traceroute measurement; o traceroute measurement results: the results of a traceroute measurement; o traceroute measurement information: both the results and the configuration parameters of a traceroute measurement; Niccolini, et al. Expires February 25, 2008 [Page 3] Internet-Draft Traceroute Storage Format August 2007 o traceroute measurement path: a sequence of hosts transited in order by traceroute probes during a traceroute measurement; 3. The Traceroute tool and its operations Traceroute is a network diagnostic tool used to determine the hop by hop path from a source to a destination and the Round Trip Time (RTT) from the source to each hop. Traceroute canthereforebe therefore used to discoverwhere and how a host is connected tosome information (hop counts, delays, etc.) about theInternetpath between the initiator of the traceroute measurement andcan be Niccolini, et al. Expires August 26, 2007 [Page 3] Internet-Draft Traceroute Storage Format February 2007 usefully employed to troubleshoot network connections.other hosts. Typically, the tracerouteattempstool attempts to discover the path to a destination by sending UDP probes with specific time-to-live (TTL) values in the IP packet header and trying to elicit an ICMP TIME_EXCEEDED response from each gateway along the path to some host. More in detail,the host running the traceroute sends thea first set of probes with TTL equal toone1 are sent by the traceroute tool from the host initiating the traceroute measurement (some tool implementations allow setting the initial TTL to a value equal to "n" different fromone,1, so that the first "n-1" hops are skipped and the first hop that will be traced is the "n-th" in the path). Upon receiving a probe, the first hop host decreases the TTL value by one. By observing a TTL value equal to zero, the host rejects the probe and typically returns an ICMP message with a TIME_EXCEEDED value.TracerouteThe traceroute tool can therefore derive the IP address of the first hop from the header of the ICMP message and evaluate the RTT between thesourcehost initiating the traceroute measurement and the first hop. The next hops are discovered following the same procedure, taking care of increasing at each step the TTL value of theoutgoingprobes by one. The TTL value is increased until either an ICMP PORT_UNREACHABLE message is received, meaning that the destination host has been reached, or the maximum configured number of hops has been hit. Some implementations, use ICMP Echos, instead of UDP datagrams. However, many routers do not return ICMP messages about ICMP messages, i.e. no ICMP TIME_EXCEEDED is returned for an ICMP Echo. Therefore,inthisdraft we RECOMMENDdocument recommends to base implementations on UDP datagrams.2.1. Traceroute Configuration Parameters In order to define an information model for storing traceroutes, we first investigated which configuration parameters are relevant when running traceroute. We considered four major traceroute implementations and compared them based on configurable parameters and default values. The LINUX (SUSE 9.1), BSD (FreeBSD 7.0) and UNIX (SunOS 5.9) implemetations are basedConsiderations onUDP datagrams, while the WINDOWS (XP SP2) one uses ICMP Echos. The comparison is summarized inTCP-based implementations of thefollowing table, where an N/Atraceroute tool are reported inthe option column, means that such parameter is not configurable for the specific implementation. A comprehensive comparisonAppendix A.1. 4. Results ofavailable implementations is outsidetraceroute measurements The following list reports thescope of this draft; however, alreadyinformation fields provided as results bysampling a few different implementations, we can observe that they can differ quite significantly in terms of configurable parameters and also default values. Note thatall traceroute tool implementations considered. The order inthe following table we reported only those optionswhich they areavailablereported here is not relevant and it changes inat least two of the considered implementations.Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page 4] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007+---------------------------------------------------------+ | OS |Option| Description | Default | +--------+------+-------------------------------+---------+ | LINUX | -m |Specifydifferent implementations. For each hop the information reported is: o themaximum TTL used | 30 | |--------+------|in outgoing probes. |---------| | FreeBSD| -m | | OS var | |--------+------| |---------| | UNIX | -m | | 30 | |--------+------| |---------| | WINDOWS| -h | | 30 | +--------+------+-------------------------------+---------+ | LINUX | -n |Displayhopaddresses | - | |--------+------|numerically rather than |---------| | FreeBSD| -n |simbolically. | - | |--------+------| |---------| | UNIX | -n | | - | |--------+------| |---------| | WINDOWS| -d | | - | +--------+------+-------------------------------+---------+ | LINUX | -w |Setindex; o thetimehost symbolic address, provided that at least one of the probes received a response, the symbolic address could be resolved at the corresponding host and that the option towait fordisplay only numerical addresses was not set; o the host IP address, provided that at least one of the probes received a| 3 sec | |--------+------|responseresponse; o the RTT for each response to a probe.|---------| | FreeBSD| -w | | 5 sec | |--------+------| |---------| | UNIX | -w | | 5 sec | |--------+------| |---------| | WINDOWS| -w | | 4 sec | +--------+------+-------------------------------+---------+ | LINUX | N/A |Specify a loose source route | - | |--------+------|gateway (to directDepending on the|---------| | FreeBSD| -g |traceroute through routers not | - | |--------+------|necessarilytraceroute tool implementation, additional information might be displayed in thepath). |---------| | UNIX | -g | | - | |--------+------| |---------| | WINDOWS| -g | | - | +--------+------+-------------------------------+---------+ | LINUX | -p |Set the base UDP port number | 33434 | |------- +------|used inoutput (for instance MPLS- related information). It might happen that some probes|---------| | FreeBSD| -p |(UDP port = base + nhops - 1). | 33434 | |--------+------| |---------| | UNIX | -p | | 33434 | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | -q |Setdo not receive a response within thenumber of probes per | 3 | |--------+------|TTL. |---------| | FreeBSD| -q | | 3 | |--------+------| |---------| | UNIX | -q | | 3 | Niccolini, et al. Expires August 26, 2007 [Page 5] Internet-Draft Traceroute Storage Format February 2007 |--------+------| |---------| | WINDOWS| N/A | | 3 | +--------+------+-------------------------------+---------+ | LINUX | -S |Setconfigured time-out (for instance if theIP source addressprobe is filtered out by a firewall). In this case, an "*" is displayed in|IP | |--------+------|outgoing probes toplace of the|address | | FreeBSD| -s |specified value. |ofRTT. The information model reflects this using a string with the| |--------+------| |out | | UNIX | -s | |interface| |--------+------| | | | WINDOWS| N/A | | | +--------+------+-------------------------------+---------+ | LINUX | -t |Setvalue of "RoundTripTimeNotAvailable" meaning either thetype-of-service (TOS) | 0 | |--------+------|inprobe was lost because of a time-out or it was not possible to transmit a probe. It may also happen that some implementations print theprobessame line multiple times when a router decreases the TTL by more than one looking like multiple hops, the information model is not impacted by this since each line is handled separately and it is left to thespecified |---------| | FreeBSD| -t |value. |applications handling the XML file how to deal with it. Moreover, for delays below 1 ms, some implementations reports 0| |--------+------| |---------| |ms (e.g. UNIX| -t | | 0 | |--------+------| |---------| | WINDOWS| N/A | | 0 | +--------+------+-------------------------------+---------+ | LINUX | -v |Verbose output: received ICMP | - | |--------+------|packets other than |---------| | FreeBSD| -v |TIME_EXCEEDEDand| - | |--------+------|UNREACHABLE are listed. |---------| | UNIX | -v | | - | |--------+------| |---------| | WINDOWS| N/A | |LINUX) while WINDOWS tracert reports "< 1 ms". 5. Information Model for Traceroute Measurements The information model is composed of information elements; for defining these information elements, a template is used. Such template is specified in the list below: o name -| +--------+------+-------------------------------+---------+ | LINUX | N/A |SetA unique and meaningful name for thetime (in msec)information element. The preferred spelling for the name is to|use mixed case if the name is compound, with an initial lower case letter, e.g., "sourceIpAddress". o description -| |--------+------|pause between probes. |---------| | FreeBSD| -z | | 0 | |--------+------| |---------| | UNIX | -P | | 0 | |--------+------| |---------| | WINDOWS| N/A | |The semantics of this information element. o dataType -| +--------+------+-------------------------------+---------+ | LINUX | -r |BypassOne of thenormal routing | - | |--------+------|tables and send directlytypes listed in Section 5.1 of this document or in an extension of the information model. The type space for attributes is constrained toa |---------| | FreeBSD| -r |host on attached network. | - | |--------+------| |---------| | UNIX | -r | | - | |--------+------| |---------| | WINDOWS| N/A | |facilitate implementation. o units -| +--------+------+-------------------------------+---------+ | LINUX | -f |SetIf theinitial TTLelement is a measure of some kind, the units identify what the measure is. o default value - The default value for the| 1 | |--------+------|first probe. |---------| | FreeBSD| -f | | 1 | |--------+------| |---------| | UNIX | -f | | 1 |element (where applicable). Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page6]5] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007|--------+------| |---------| | WINDOWS| N/A | | 1 | +--------+------+-------------------------------+---------+ | LINUX | -F |Set5.1. Data Types This section describes the"don't fragment" bit. | - | |--------+------| |---------| | FreeBSD| -F | | - | |--------+------| |---------| | UNIX | -F | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | N/A |Enables socket level debugging.| - | |--------+------| |---------| | FreeBSD| -d | | - | |--------+------| |---------| | UNIX | -d | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | N/A |Use ICMP ECHO insteadset ofUDP | - | |--------+------|datagrams. |---------| | FreeBSD| -I | | - | |--------+------| |---------| | UNIX | -I | | - | |--------+------| |---------| | WINDOWS| N/A | |valid data types of the information model. o String -| +--------+------+-------------------------------+---------+ | LINUX | -I |SpecifyThe type "String" represents anetwork interface to | - | |--------+------|obtainfinite length string of valid characters from theIP addressUnicode character encoding set. Unicode allows for|---------| | FreeBSD| -i |outgoing IP packets | - | |--------+------|(alternativeASCII and many other international character sets tooption -s). |---------| | UNIX | -i | | - | |--------+------| |---------| | WINDOWS| N/A | |be used. It is expected that strings will be encoded in UTF-8 format, which is identical in encoding for USASCII characters, but also accommodates other Unicode multi-byte characters. o InetAddressType -| +--------+------+-------------------------------+---------+ | LINUX | N/A |Toggle checksum. | - | |--------+------| |---------| | FreeBSD| -x | | - | |--------+------| |---------| | UNIX | -x | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | - |As optional last paramater, |Depends | |--------+------|LINUX, FreeBSD and UNIX |on | | FreeBSD| - |implementations allow |implement| |--------+------|specifying the probe datagram |ation. | | UNIX | - |length for outgoing probes. | | Niccolini, et al. Expires August 26, 2007 [Page 7] Internet-Draft Traceroute Storage Format February 2007 |--------+------| | | | WINDOWS| N/A | | | +--------+------+-------------------------------+---------+ 3. Known Problems with Traceroute 3.1. AccuracyThe type "InetAddressType" represents a type ofResults A known inconsistency exists between the round-trip delay metric defined by the IPPM working group and the results returned by the current traceroute implementations. Unfortunately, it is unlikely that the traceroute implementations will implement the standard definition in the near future. In orderInternet address. The allowed values are tocompare results of different traceroute measurements, specifications both of the operating system (name and version) and of the traceroute tool version usedbe intended as imported from [RFC4001]; an additional allowed value is "asnumber". o InetAddress - The type "InetAddress" denotes a generic Internet address. The allowed values areaddedto be intended as imported from [RFC4001]; an additional allowed value is themetadata elements in orderAS number tohelp in comparing metrics. Moreover,be indicated as thetraceroute has built-in configurable mechanisms like time-outs and can experience problems related toactual number plus thecrossing of firewalls; therefore some ofindication how thepackets that traceroute sends out end up being time-out or filtered. Asmapping from IP address to AS number was performed. o TruthValue - The type "TruthValue" represents aconsequence, it might not be possibleBoolean value. The allowed values are totracebe intended as imported from [RFC2579]. o Unsigned32 - The type "Unsigned32" represents a value in thepath torange (0..4294967295). o Unsigned16 - The type "Unsigned16" represents anode or there might not bevalue in the range (0..65535). o Unsigned8 - The type "Unsigned32" represents acomplete setvalue in the range (0..255). o InterfaceIndexOrZero - The type "InterfaceIndexOrZero" is an extension ofprobes describingtheRTTInterfaceIndex convention. The latter defines a greater than zero value used toreach it. 3.2. Alternative traceroute Implementations As stated above,identify an interface or interface sub-layer in thewidespred usesystem. This extension permits the additional value offirewallszero. Examples of the usage of zero mightprevent UDPinclude situations where interface was unknown, orICMP based tracerouteswhen none or all interfaces need tocompletely trace the pathbe referenced. The allowed values are to be intended as imported from [RFC2863]. o ProbesType - The type "ProbesType" represents adestination, sinceway of indicating the protocol used for the tracerouteprobes might end up being filtered. In some cases, such limitation might be overcome by sending instead TCP packetsprobes. Allowed values are UDP, TCP, ICMP. o DateAndTime - The type "DateAndTime" represents a date-time specification. The allowed values are tospecific portsbe intended as imported from [RFC2579] apart from the fact thathosts located behindin this document there is thefirewall are listening for connections on. TCP based implementations use TCP SYN or FYN probes and listen for TIME_EXCEEDED messages, TCP RESET and other messages from firewalls and gateways on the path. On the other hand, some firewalls filter out TCP SYN packetsneed toprevent denial of service attacks, therefore the actual advantage of using TCPuse a millisecond resolution insteadof UDP traceroute depends mainly on firewall configurations, which are not known in adavance. A detailed analysis of TCP based traceroutesa decisecond one. o OperationResponseStatus - The type "OperationResponseStatus" isoutside the scope of this draft, therefore in the sequel, we will restrict our focusused to report themost commonly implemented UDP based traceroute. 4. Reports/results The following list reports the information fields provided by all traceroute implementations considered.result of an operation. Theorder in which theyallowed values are to be intended as imported from [RFC4560]. Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page8]6] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007reported here is not relevant and it changes in different implementations. For each hop the information reported is: o5.2. Information Elements This section describes thehop index; oelements related to thehost symbolical address, provided that at least onestoring ofthe probes receivedaresponse, the symbolic address could be resolved at the correponding hosttraceroute measurement. The elements are grouped in two groups (Configuration andthat the optionResults) according todisplay only numerical addresses was not set; o the host IP address, provided that at least onetheir semantics. In order to relate configuration and results elements by means ofthe probes receivedaresponse; o the RTT for each responsecommon unique identifier, an additional element is defined belonging toa probe. Depending onboth thetraceroute implementation, additional information might be displayed in the output (for instance MPLS-related information). It might happen that some probes do not receive a response within the configured time-out (for instance if the probe is filtered out by a firewall). In this case, an "*" is displayed in place of the RTT. Besides, for delays below 1 ms, some implementations reports 0 ms (f.i. UNIX and LINUX) while WINDOWS tracert reports "< 1 ms". 5.two groups. 5.2.1. Configuration InformationModel for Storing Traceroute MeasurementsElements This section describes theinformation model forelements specific to thetraceroute measurements data storing. The information model is composedconfiguration ofinformation elements; for defining these information elements, a template is used. Such template is specified inthelist below:traceroute measurement. 5.2.1.1. CtlTargetAddressType o name -A unique and meaningful name for the information element. The preferred spelling for the name is to use mixed case if the name is compound, with an initial lower case letter, e.g., "sourceIpAddress".CtlTargetAddressType o description -The semanticsSpecifies the type ofthis information element.destination address used in the traceroute measurement. o dataType -One ofInetAddressType o units - N/A o default value - N/A 5.2.1.2. CtlTargetAddress o name - CtlTargetAddress o description - Specifies thetypes listed in Section 5.1 of this document orhost address used inan extension oftheinformation model.traceroute measurement. The host address typespace for attributes is constrained to facilitate implementation. o units - Ifcan be determined by theelement is a measureexamining the value ofsome kind,the corresponding CtlTargetAddressType. o dataType - InetAddress o unitsidentify what the measure is.- N/A o default value -The default value for the element (where applicable). 5.1. Data Types This section describesN/A 5.2.1.3. CtlBypassRouteTable o name - CtlBypassRouteTable o description - Specifies if theset of valid data typesoptional bypassing of theinformation model.route table was enabled or not. If enabled, the normal routing tables will be bypassed and the probes will be sent directly to a host on an attached network. If the host is not on a directly-attached network, an error is returned. This option can be used to perform the traceroute measurement to a local host through an interface that has no route defined. o dataType - TruthValue o units - N/A o default value - false Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page9]7] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007 5.2.1.4. CtlProbeDataSize oStringname -The type "String" represents a finite length string of valid characters from the Unicode character encoding set. Unicode allows for ASCII and many other international character sets to be used. It is expected that strings will be encoded in UTF-8 format, which is identical in encoding for USASCII characters, but also accomodates other Unicode multibyte characters.CtlProbeDataSize oInetAddressTypedescription -The type "InetAddressType" represents a typeSpecifies the size of the probes ofInternet address. The allowed values are to be intended as imported from [RFC4001]; an additional allowed value is "asnumber". o InetAddress - The type "InetAddress" denotesageneric Internet address. The allowed valuestraceroute measurement in octets. If UDP datagrams areto be intendedused asimported from [RFC4001]; an additional allowedprobes, then the value contained in this object isthe AS numberexact. If another protocol is used tobe indicated as the actual number plustransmit probes (i.e. TCP or ICMP) for which theindication howspecified size is not appropriate, then themapping from IP address to AS number was performed. o TruthValue - The type "TruthValue" represents a boolean value. The allowed values areimplementation can use whatever size (appropriate tobe intended as imported from [RFC2579]. o Unsigned32 - The type "Unsigned32" represents a value intherange (0..4294967295). o InterfaceIndexOrZero - The type "InterfaceIndexOrZero"method) isan extension ofclosest to theInterfaceIndex convention.specified size. Thelatter defines a greater than zeromaximum valueused to identify an interface or interface sub-layer in the system. This extension permitsfor this object was computed by subtracting theadditional value of zero. Examplessmallest possible IP header size of 20 octets (IPv4 header with no options) and theusageUDP header size ofzero might include situations where interface was unknown, or when none or all interfaces need to be referenced. The allowed values are to be intended as imported8 octets from[RFC2863]. o ProbesType - The type "ProbesType" representsthe maximum IP packet size. An IP packet has awaymaximum size ofindicating the protocol used for the traceroute probes. Allowed values are UDP, TCP, ICMP.65535 octets (excluding IPv6 Jumbograms). oDateAndTimedataType -The type "DateAndTime" represents a date-time specification. The allowed values are to be intended as imported from [RFC2579] apart fromUnsigned32 o units - octets o default value - 0 5.2.1.5. CtlTimeOut o name - CtlTimeOut o description - Specifies thefact thattime-out value, inthis document there is the need to use a milli-second resolution insteadseconds, for each probe of adeci-second one.traceroute measurement. oOperationResponseStatusdataType -The type "OperationResponseStatus" is used to reportUnsigned32 o units - seconds o default value - 3 5.2.1.6. CtlProbesPerHop o name - CtlProbesPerHop o description - Specifies theresultnumber ofan operation. The allowed valuesprobes with the same time- to-live (TTL) value that areto be intended as imported from [RFC4560]. 5.2. Information Elements This section describessent for each host. o dataType - Unsigned32 o units - probes o default value - 3 5.2.1.7. CtlPort o name - CtlPort o description - Specifies theelements ofbase UDP port used by the traceroute measurement.The elements are groupedA port that is not intwo groups (Configuration and Results) according to their semantics. In orderuse at the destination (target) host needs torelate configuration and results elements by means of a common unique identifier, an additional elementbe specified. The default value for this object isdefined belonging to boththetwo groups.IANA assigned port, 33434, for the traceroute measurement. o dataType - Unsigned32 o units - UDP Port Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page10]8] Internet-Draft Traceroute Storage FormatFebruaryAugust 20075.2.1. Configuration Information Elements This section describes the elements of the traceroute measurement that are specific to traceroute configuration. 5.2.1.1. CtlTargetAddressTypeo default value - 33434 5.2.1.8. CtlMaxTtl o name -CtlTargetAddressTypeCtlMaxTtl o description - Specifies thetype of host address used inmaximum TTL value for the traceroutecommand.measurement. o dataType -InetAddressTypeUnsigned32 o units -N/Atime-to-live value o default value -N/A 5.2.1.2. CtlTargetAddress30 5.2.1.9. CtlDSField o name -CtlTargetAddressCtlDSField o description - Specifies thehost address usedvalue that was stored in the Differentiated Services (DS) field in the traceroutecommand.probe. Thehost address type can be determined by the examiningDS Field is defined as thevalueType of Service (TOS) octet in a IPv4 header or as thecorresponding CtlTargetAddressType.Traffic Class octet in a IPv6 header. The value of this object must be a decimal integer in the range from 0 to 255. This option can be used to determine what effect an explicit DS field setting has on a traceroute measurement and its probes. Not all values are legal or meaningful. Useful TOS octet values are probably '16' (low delay) and '8' (high throughput). Further references can be found in [RFC2474] for the definition of the Differentiated Services (DS) field and to [RFC1812] Section 5.3.2 for Type of Service (TOS). o dataType -InetAddressUnsigned32 o units - N/A o default value -N/A 5.2.1.3. CtlByPassRouteTable0 5.2.1.10. CtlSourceAddressType o name -CtlByPassRouteTableCtlSourceAddressType o description - Specifiesiftheoptional bypassingtype of theroute table was enabled or not. If enabled, the traceroute will bypass the normal routing tables and send directly to a host on an attached network. If the host is not on a directly-attached network, an error is returned. This option can besource address, CtlSourceAddress, usedto performin the tracerouteoperation to a local host through an interface that has no route defined.measurement. o dataType -TruthValueInetAddressType o units - N/A o default value -false 5.2.1.4. CtlProbeDataSizeN/A 5.2.1.11. CtlSourceAddress o name -CtlProbeDataSizeCtlSourceAddress o description - Specifies thesize of the data portion ofIP address (which has to be given as an IP number, not atraceroute operation in octets. If the RECOMMENDED traceroute method (UDP datagramshostname) asprobes) is used, thenthevalue containedsource address used inthis object is exact. If anothertraceroutemethod is used for which the specified size is not appropriate, then the implementation should haveprobes. On hosts with more than one IP address, this option can be usedwhatever size (appropriateto force themethod) is closestsource address to be something other than thespecified size. The maximumprimary IP address of the interface the probe is sent on. A zero length octet string value for this object means Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page11]9] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007 that source address specification was disabled. The address type (InetAddressType) that relates to this objectwas computedis specified bysubstracting the smallest possible IP header size of 20 octets (IPv4 header with no options) and the UDP header size of 8 octets fromthemaximum IP packet size. An IP packet has a maximum sizecorresponding value of65535 octets (excluding IPv6 Jumbograms).CtlSourceAddressType. o dataType -Unsigned32InetAddress o units -octectsN/A o default value -0 5.2.1.5. CtlTimeOutN/A 5.2.1.12. CtlIfIndex o name -CtlTimeOutCtlIfIndex o description - Specifies thetime-out value,interface index used inseconds,the traceroute measurement for sending the tracerouteoperation.probes. A value of zero for this object implies that the interface was unknown. o dataType -Unsigned32InterfaceIndexOrZero o units -secondsN/A o default value -3 5.2.1.6. CtlProbesPerHop0 5.2.1.13. CtlMiscOptions o name -CtlProbesPerHopCtlMiscOptions o description - Specifies implementation dependent options. o dataType - String o units - N/A o default value - N/A 5.2.1.14. CtlMaxFailures o name - CtlMaxFailures o description - Specifies the maximum number oftimes to reissueconsecutive timeouts allowed before terminating a tracerouterequest withmeasurement. A value of either 255 (maximum hop count/possible TTL value) or a 0 indicates that thesame time-to-live (TTL) value.function of terminating a remote traceroute measurement when a specific number of consecutive timeouts are detected was disabled. This element is included to give full compatibility with [RFC4560]. No known implementation of traceroute currently supports it. o dataType - Unsigned32 o units -probestimeouts o default value -3 5.2.1.7. CtlPort5 5.2.1.15. CtlDontFragment o name -CtlPortCtlDontFragment o description - Specifies if thebase UDP port used by the traceroute operation. Need to specify a port that is notdon't fragment flag (DF) inuse atthedestination (target) host. The default valueIP header forthis object isa probe was enabled or not. Setting theIANA assigned port, 33434,DF flag can be used forthe traceroute function.performing a manual PATH MTU test. Niccolini, et al. Expires February 25, 2008 [Page 10] Internet-Draft Traceroute Storage Format August 2007 o dataType -Unsigned32TruthValue o units -UDP PortN/A o default value -33434 5.2.1.8. CtlMaxTtlfalse 5.2.1.16. CtlInitialTtl o name -CtlMaxTtlCtlInitialTtl o description - Specifies themaximuminitial TTL valuefor theused in a tracerouteoperation.measurement. Such TTL setting is intended to bypass the initial (often well known) portion of a path. o dataType - Unsigned32 o units -time-to-live valueN/A o default value -30 Niccolini, et al. Expires August 26, 2007 [Page 12] Internet-Draft Traceroute Storage Format February 2007 5.2.1.9. CtlDSField1 5.2.1.17. CtlDescr o name -CtlDSFieldCtlDescr o description -Specifies the value that was stored in the Differentiated Services (DS) field in the IP packet used to encapsulate the traceroute probe. The DS Field is defined as the Type of Service (TOS) octet in a IPv4 header or as the Traffic Class octet in a IPv6 header.Thevaluepurpose of thisobject must be a decimal integer in the range from 0 to 255. This option can be usedelement is todetermine what effect an explicit DS field setting has onprovide atraceroute response. Not all values are legal or meaningful. Useful TOS octet values are probably '16' (low delay) and '8' (high throughput). Further references can be found in [RFC2474] for the definitiondescription of theDifferentiated Services (DS) field and to [RFC1812] Section 5.3.2 for Type of Service (TOS).traceroute measurement. o dataType -Unsigned32String o units - N/A o default value -0 5.2.1.10. CtlSourceAddressTypeN/A 5.2.1.18. CtlType o name -CtlSourceAddressTypeCtlType o description - Specifies thetype of the source address, CtlSourceAddress,implementation method usedwhen performingfor the tracerouteoperation.measurement. It specifies if the traceroute is using TCP, UDP or ICMP probes. o dataType -InetAddressTypeProbesType o units - N/A o default value -N/A 5.2.1.11. CtlSourceAddressUDP 5.2.2. Results Information Elements This section describes the elements specific to the results of the traceroute measurement. 5.2.2.1. ResultsStartDateAndTime o name -CtlSourceAddressResultsStartDateAndTime o description - Specifies theIP address (which has to be given as an IP number, not a hostname) as the source address used in outgoing probe packets. On hosts with more than one IP address, this option can be used to force the source address to be something other than the primary IP addressdate and start time of theinterfacetraceroute measurement. This is the time when the first probepacket is sent on. A zero length octet string value for this object means that source address specificationwasdisabled. The address type (InetAddressType) that relates to this object is specified byseen at thecorresponding value of CtlSourceAddressType.sending interface. o dataType -InetAddressDateAndTime o units - N/Ao default value - N/A 5.2.1.12. CtlIfIndexNiccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page13]11] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007 oname - CtlIfIndex o description - Specifies the inferface index used in the traceroute operation for sending the traceroute probes. A value of zero for this object implies that the interface was unknown. o dataType - InterfaceIndexOrZero o units - N/A odefault value -0 5.2.1.13. CtlMiscOptionsN/A 5.2.2.2. ResultsIpTgtAddrType o name -CtlMiscOptionsResultsIpTgtAddrType o description - Specifiesimplementation dependent options.the type of address stored in the corresponding ResultsIpTgtAddr element. o dataType -StringInetAddressType o units - N/A o default value - N/A5.2.1.14. CtlMaxFailures5.2.2.3. ResultsIpTgtAddr o name -CtlMaxFailuresResultsIpTgtAddr o description - Specifies themaximum number of consecutive timeouts allowed before terminatingIP address associated with atraceroute operation. ACtlTargetAddress valueof either 255 (maximum hop count/possible TTL value) or a 0 indicates thatwhen thefunctiondestination address is specified as a DNS name. The value ofterminatingthis object should be aremote traceroute operationzero length octet string when aspecific number of consecutive timeouts are detected was disabled. This elementDNS name isincludednot specified or when a specified DNS name fails togive full compatibility with [RFC4560]. No known implementation of traceroute currently supports it.resolve. o dataType -Unsigned32InetAddress o units -timeoutsN/A o default value -5 5.2.1.15. CtlDontFragmentN/A 5.2.2.4. Index o name -CtlDontFragmentIndex o description - Specifiesif the don't fragment flag (DF) in the IP headeran index that consecutively numbers all probes for which aprobereply wasenabled or not. Settingreceived in theDF flag can be usedsequential order in which the replies were received. The maximum value forperforming a manual PATH MTU test.this object is CtlMaxTtl*CtlProbesPerHop. o dataType -TruthValueUnsigned32 o units - N/A o default value -false 5.2.1.16. CtlInitialTtlN/A 5.2.2.5. HopIndex o name -CtlInitialTtlHopIndex o description - Specifiesthe initial TTL value usedwhich hop in a tracerouteoperation. Such TTL setting is intended to bypassmeasurement path theinitial (often well known) portion of a path. Niccolini, et al. Expires August 26, 2007 [Page 14] Internet-Draft Traceroute Storage Format February 2007probe's results are for. o dataType - Unsigned32 o units - N/A o default value -1 5.2.1.17. CtlDescrN/A 5.2.2.6. IndexPerHop o name -CtlDescrIndexPerHop Niccolini, et al. Expires February 25, 2008 [Page 12] Internet-Draft Traceroute Storage Format August 2007 o description - Specifies the index of a probe for a particular hop in a traceroute measurement path. Thepurposenumber ofthis elementprobes per hop isto provide a descriptiondetermined by the value of thetraceroute test.corresponding CtlProbesPerHop element. o dataType -StringUnsigned32 o units - N/A o default value - N/A5.2.1.18. CtlType o name - CtlType o description - Specifies the implementation method used for the traceroute operation. It specifies if the traceroute is using TCP, UDP or ICMP probes. o dataType - ProbesType o units - N/A o default value - UDP 5.2.2. Results Information Elements This section describes the elements of the traceroute measurement that are specific to the results of a traceroute operation. 5.2.2.1. ResultsStartDateAndTime o name - ResultsStartDateAndTime o description - Specifies the date and start time of the traceroute operation. This is the time when the first probe was seen at the sending interface. o dataType - DateAndTime o units - N/A o default value - N/A 5.2.2.2. ResultsIpTgtAddrType5.2.2.7. HopAddrType o name -ResultsIpTgtAddrTypeHopAddrType o description - Specifies the type of address stored in the correspondingResultsIpTgtAddrHopAddr element. o dataType - InetAddressType o units - N/A o default value - N/ANiccolini, et al. Expires August 26, 2007 [Page 15] Internet-Draft Traceroute Storage Format February 2007 5.2.2.3. ResultsIpTgtAddr5.2.2.8. HopAddr o name -ResultsIpTgtAddrHopAddr o description - Specifies theIPaddressassociated withof aCtlTargetAddress value whenhop in thedestination addresstraceroute measurement path. This object isspecified asnot allowed to be a DNS name. The value of the corresponding object, HopAddrType, indicates thisobject should be a zero length octet string when a DNS name is not specified or when a specified DNS name fails to resolve.object's IP address type. o dataType - InetAddress o units - N/A o default value - N/A5.2.2.4. Index5.2.2.9. HopGeoLocation o name -IndexHopGeoLocation o description - Specifiesan index that consecutively numbers all probes for which a reply was received inthesequential ordergeo location of a hop inwhichthereplies were received. The maximum value for this object is CtlMaxTtl*CtlProbesPerHop.traceroute measurement path. o dataType -Unsigned32String o units - N/A o default value - N/A5.2.2.5. HopIndex5.2.2.10. MPLSTopLabel o name -HopIndex o description - Specifies which hop in a traceroute path that the probe's results are for. o dataType - Unsigned32 o units - N/A o default value - N/A 5.2.2.6. IndexPerHop o name - IndexPerHop o description - Specifies the index of a probe for a particular hop in a traceroute path. The number of probes per hop is determined by the value of the corresponding CtlProbesPerHop element. o dataType - Unsigned32 o units - N/A o default value - N/A 5.2.2.7. HopAddrType o name - HopAddrType o description - Specifies the type of address stored in the corresponding HopAddr element. Niccolini, et al. Expires August 26, 2007 [Page 16] Internet-Draft Traceroute Storage Format February 2007 o dataType - InetAddressType o units - N/A o default value - N/A 5.2.2.8. HopAddr o name - HopAddr o description - Specifies the address of a hop in the traceroute path. This object is not allowed to be a DNS name. The value of the corresponding object, HopAddrType, indicates this object's IP address type. o dataType - InetAddress o units - N/A o default value - N/A 5.2.2.9. HopGeoLocation o name - HopGeoLocation o description - Specifies the geo location of a hop in the traceroute path. o dataType - String o units - N/A o default value - N/A 5.2.2.10. MPLSTopLabel o name - MPLSTopLabelMPLSTopLabel o description - Specifies the top entry of the MPLS label stack of a probe observed when the probe arrived at the hop that replied to the probe. This object contains the top MPLS label stack entry as 32 bit value as it is observed on the MPLS label stack. Contained in this single number are the MPLS label, the Exp field, the S flag, and the MPLS TTL value as specified in RFC3032 [RFC3032].3032. Niccolini, et al. Expires February 25, 2008 [Page 13] Internet-Draft Traceroute Storage Format August 2007 o dataType - Unsigned32 o units - N/A o default value - N/A 5.2.2.11. RoundTripTime o name - RoundTripTime o description - Specifies the amount of time measured in milliseconds from when a probe was sent to when its response was received or when it timed out. The value of this element is reported as the truncation of the number reported by the traceroute tool (the output "< 1 ms" is therefore encoded as 0 ms). A string with the value of "RoundTripTimeNotAvailable" means either the probe was lost because of a timeout or it was not possible to transmit a probe.Niccolini, et al. Expires August 26, 2007 [Page 17] Internet-Draft Traceroute Storage Format February 2007o dataType - Unsigned32 or String o units - milliseconds or N/A o default value - N/A 5.2.2.12. ResponseStatus o name - ResponseStatus o description - Specifies the result of a tracerouteoperationmeasurement made by the host for a particular probe. o dataType - OperationResponseStatus o units - N/A o default value - N/A 5.2.2.13. Time o name - Time o description - Specifies the timestamp for when the response to the probe was received at the interface. o dataType - DateAndTime o units - N/A o default value - N/A 5.2.2.14. ResultsHopRawOutputData o name - ResultsHopRawOutputData o description - Specifies the raw output data returned by the tracerouteoperationmeasurement for a certain hop in a traceroute measurement path. o dataType - String o units - N/A o default value - N/A Niccolini, et al. Expires February 25, 2008 [Page 14] Internet-Draft Traceroute Storage Format August 2007 5.2.2.15. ResultsEndDateAndTime o name - ResultsEndDateAndTime o description - Specifies the date and end time of the tracerouteoperation.measurement. It is either the time when the response to the last probe of the tracerouteoperationmeasurement was received or the time when the last probe of the tracerouteoperationmeasurement was sent plus the relative timeout (in case of missing response). o dataType - DateAndTime o units - N/A o default value - N/A 5.2.3. Information Element Correlating Configuration and Results Elements This section defines an additional element belonging to both the two previousgroups.groups (configuration elements and result elements) named TestName. This element is defined in order to relateNiccolini, et al. Expires August 26, 2007 [Page 18] Internet-Draft Traceroute Storage Format February 2007configuration elements and results ones by means of a common unique identifier. 5.2.3.1. TestName o name - TestName o description - Specifies the name of a traceroutetest.measurement. This is locally unique. o dataType - String o units - N/A o default value - N/A 5.2.4. Information Elements to compare traceroute measurements results one with each other This section defines additional elements belonging to both the two previous groups (configuration elements and result elements); these elements were defined in order to allow traceroute measurements results comparison among different traceroute measurements. 5.2.4.1. OSName o name - OSName o description - Specifies the name of the operating system on which the traceroute measurement was launched. o dataType - String o units - N/A o default value - N/A Niccolini, et al. Expires February 25, 2008 [Page 15] Internet-Draft Traceroute Storage Format August 2007 5.2.4.2. OSVersion o name - OSVersion o description - Specifies the OS version on which the traceroute measurement was launched. o dataType - String o units - N/A o default value - N/A 5.2.4.3. ToolVersion o name - ToolVersion o description - Specifies the version of the traceroute tool used. o dataType - String o units - N/A o default value - N/A 6. Data Model for Storing Traceroute Measurements For storing and transmitting information according to the information model defined in the previous section, a data model is required that specifies how to encode the elements of the information model. There are several design choices for a data model. It can use a binary or textual representation and it can be defined from scratch or use already existing frameworks and data models. In general, the use of already existing frameworks and models should be preferred. Binary and textual representation both have advantages and disadvantages. Textualrepresentionsrepresentations are (with some limitations) human readable while a binary representation consumes less resources for storing, transmitting and parsing data. An already existing and closely related data model is the DISMAN- TRACEROUTE-MIB module [RFC4560], that specifies a BER encoding [RFC3417] used by the Simple Network Management Protocol (SNMP) [RFC3410] for transmitting tracerouteinformation.measurement information (configuration and results). This data model is well suited and supported within network management systems, but as a general format for storing and transmitting traceroute results it is not easily applicable. Another binary representation would be an extension of traffic flow information encodings as specified for the IPFIX protocol [I-D.ietf-ipfix-protocol], [I-D.ietf-ipfix-info]. The IPFIX protocol is extensible. However, the architecture behind this protocol [I-D.ietf-ipfix-architecture] is targeted at exporting passively Niccolini, et al. Expires February 25, 2008 [Page 16] Internet-Draft Traceroute Storage Format August 2007 measured flow information. Therefore, some obstacles are expected when trying to use it for transmitting traceroutemeasurement results.measurements information. For textual representations, using the eXtensible Markup Language (XML) [XML] is an obvious choice. XML supports clean structuring ofNiccolini, et al. Expires August 26, 2007 [Page 19] Internet-Draft Traceroute Storage Format February 2007data and syntax checking of records. With some limitations it is human readable. It is supported well by a huge pool of tools and standards for generating, transmitting, parsing and converting it to other data formats. Its disadvantages is the resourcecomsumptionconsumption for processing, storing, and transmitting information. Since the expected data volumesofrelated to traceroutedatameasurements in network operation and maintenance is not expected to beextremlyextremely high, the inefficient usage of resources is not a significant disadvantage. Therefore, XML was chosen as basis for the traceroute measurements information model that is specified in this section. Section 7 contains the XML schema to be used as a template for storing and/or exchanging traceroutemeasurements.measurements information. The schema was designed in order to use an extensible approach based on templates (pretty similar to how IPFIX protocol is designed) where the traceroute configuration elements (both the requested parameters, Request, and the actual parameters used, MeasurementMetadata) are metadata to be referenced by results information elements (data) by means of the TestName element (used as unique identifier). CurrentlyGlobalOpen Grid Forum(GGF)(OGF) is also using this approach and cross- requirements have been analyzed. As a result of this analysis the XML schema contained in Section 7 is compatible withGGFOGF schema since it was designed in a way that both limits theunecessaryunnecessary redundancy and a simple one-to-onetrasformationtransformation between the two exist. 7. XML Schema for traceroute Measurements <?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="urn:ietf:params:xml:ns:traceroute-1.0"> <xs:simpleType name="inetAddressType"> <xs:restriction base="xs:string"> <xs:enumeration value="unknown"/> <xs:enumeration value="ipv4"/> <xs:enumeration value="ipv6"/> <xs:enumeration value="dns"/> <xs:enumeration value="asnumber"/> </xs:restriction> </xs:simpleType> Niccolini, et al. Expires February 25, 2008 [Page 17] Internet-Draft Traceroute Storage Format August 2007 <xs:simpleType name="inetAddressTypeWithoutDns"> <xs:restriction base="xs:string"> <xs:enumeration value="unknown"/> <xs:enumeration value="ipv4"/> <xs:enumeration value="ipv6"/> <xs:enumeration value="asnumber"/>Niccolini, et al. Expires August 26, 2007 [Page 20] Internet-Draft Traceroute Storage Format February 2007<xs:enumeration value="noSpecification"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_zeroLengthString"> <xs:restriction base="xs:string"> <xs:maxLength value="0"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_inetAddressIpv4"> <xs:restriction base="xs:string"> <xs:pattern value="(([1-9]?[0-9]|1[0-9][0-9]| 2[0-4][0-9]|25[0-5]).){3}([1-9]?[0-9]|1[0-9] [0-9]|2[0-4][0-9]|25[0-5])"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_inetAddressIpv6"> <xs:restriction base="xs:string"> <xs:pattern value="(([\dA-Fa-f]{1,4}:){7}[\dA-Fa-f]{1,4}) (:([\d]{1,3}.){3}[\d]{1,3})?"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_inetAddressDns"> <xs:restriction base="xs:string"> <xs:maxLength value="256"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_asNumber"> <xs:restriction base="xs:unsignedInt"/> </xs:simpleType> <xs:simpleType name="_ipASNumberMappingType"> <xs:restriction base="xs:string"> <xs:enumeration value="bgptables"/> <xs:enumeration value="routingregistries"/> <xs:enumeration value="nslookup"/> <xs:enumeration value="others"/> <xs:enumeration value="unknown"/></xs:restriction> </xs:simpleType> <xs:simpleType name="operationResponseStatus"> <xs:restriction base="xs:string"> <xs:enumeration value="responseReceived"/>Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page21]18] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007 </xs:restriction> </xs:simpleType> <xs:simpleType name="operationResponseStatus"> <xs:restriction base="xs:string"> <xs:enumeration value="responseReceived"/> <xs:enumeration value="unknown"/> <xs:enumeration value="internalError"/> <xs:enumeration value="requestTimedOut"/> <xs:enumeration value="unknownDestinationAddress"/> <xs:enumeration value="noRouteToTarget"/> <xs:enumeration value="interfaceInactiveToTarget"/> <xs:enumeration value="arpFailure"/> <xs:enumeration value="maxConcurrentLimitReached"/> <xs:enumeration value="unableToResolveDnsName"/> <xs:enumeration value="invalidHostAddress"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_dateAndTimeUpToSeconds"> <xs:restriction base="xs:dateTime"/> </xs:simpleType> <xs:simpleType name="_timeMilliseconds"> <xs:restriction base="xs:unsignedShort"> <xs:maxExclusive value="1000"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_TestName"> <xs:annotation> <xs:documentation>Specifies the name of a traceroutetest.measurement. This is locally unique. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:maxLength value="32"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_OSName"> <xs:annotation> <xs:documentation>Specifies the name of the operating system on which the traceroute measurement was launched. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> Niccolini, et al. Expires February 25, 2008 [Page 19] Internet-Draft Traceroute Storage Format August 2007 <xs:maxLength value="32"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_OSVersion"> <xs:annotation> <xs:documentation>Specifies the OS version on which theNiccolini, et al. Expires August 26, 2007 [Page 22] Internet-Draft Traceroute Storage Format February 2007traceroute measurement was launched. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:maxLength value="32"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_ToolVersion"> <xs:annotation> <xs:documentation>Specifies the version of the traceroute tool used. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:maxLength value="32"/> </xs:restriction> </xs:simpleType> <xs:simpleTypename="_CtlByPassRouteTable">name="_CtlBypassRouteTable"> <xs:annotation> <xs:documentation>Specifies if the optional bypassing of the route table was enabled or not. If enabled, thetraceroute will bypass thenormal routing tables will be bypassed andsendthe probes will be sent directly to a host on an attached network. If the host is not on a directly-attached network, an error is returned. This option can be used to perform the tracerouteoperationmeasurement to a local host through an interface that has no route defined. </xs:documentation> </xs:annotation> <xs:restriction base="xs:boolean"/> </xs:simpleType> <xs:simpleType name="_CtlProbeDataSize"> <xs:annotation> <xs:documentation>Specifies the size of thedata portionprobes of a tracerouteoperationmeasurement in octets. Ifthe RECOMMENDED traceroute method (UDPUDP datagrams are used asprobes) is used,probes, then the value contained in this object is exact. If anothertraceroute methodNiccolini, et al. Expires February 25, 2008 [Page 20] Internet-Draft Traceroute Storage Format August 2007 protocol is used to transmit probes (i.e. TCP or ICMP) for which the specified size is not appropriate, then the implementationshould have usedcan use whatever size (appropriate to the method) is closest to the specified size. The maximum value for this object was computed bysubstractingsubtracting the smallest possible IP header size of 20 octets (IPv4 header with no options) and the UDP header size of 8 octets from the maximum IP packet size. An IPNiccolini, et al. Expires August 26, 2007 [Page 23] Internet-Draft Traceroute Storage Format February 2007packet has a maximum size of 65535 octets (excluding IPv6jumbograms). Units are: octects.Jumbograms). </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedShort"> <xs:maxExclusive value="65508"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_CtlTimeOut"> <xs:annotation> <xs:documentation>Specifies the time-out value, in seconds, fortheeach probe of a tracerouteoperation. Units are: seconds.measurement. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"> <xs:minExclusive value="0"/> <xs:maxExclusive value="61"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_CtlProbesPerHop"> <xs:annotation> <xs:documentation>Specifies the number oftimes to reissue a traceroute requestprobes with the same time-to-live (TTL)value. Units are: probes.value that are sent for each host. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"> <xs:minExclusive value="0"/> <xs:maxExclusive value="11"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_CtlPort"> <xs:annotation> <xs:documentation>Specifies the base UDP port used by the tracerouteoperation. Need to specify ameasurement. A port that is not in use at the destination (target)host.host needs to be Niccolini, et al. Expires February 25, 2008 [Page 21] Internet-Draft Traceroute Storage Format August 2007 specified. The default value for this object is the IANA assigned port, 33434, for the traceroutefunction. Units are: UDP port.measurement. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedShort"> <xs:minExclusive value="0"/> </xs:restriction>Niccolini, et al. Expires August 26, 2007 [Page 24] Internet-Draft Traceroute Storage Format February 2007</xs:simpleType> <xs:simpleType name="_CtlMaxTtl"> <xs:annotation> <xs:documentation>Specifies the maximum TTL value for the tracerouteoperation. Units are: time-to-live value.measurement. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"> <xs:minExclusive value="0"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_CtlDSField"> <xs:annotation> <xs:documentation>Specifies the value that was stored in the Differentiated Services (DS) field in theIP packet used to encapsulate thetraceroute probe. The DS Field is defined as the Type of Service (TOS) octet in a IPv4 header or as the Traffic Class octet in a IPv6 header. The value of this object must be a decimal integer in the range from 0 to 255. This option can be used to determine what effect an explicit DS field setting has on a tracerouteresponse.measurement and its probes. Not all values are legal or meaningful. Useful TOS octet values are probably '16' (low delay) and '8' (high throughput). Further references can be found intheRFC 2474 for the definition of the Differentiated Services (DS) field and totheRFC 1812 Section 5.3.2 for Type of Service (TOS). </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"/> </xs:simpleType> <xs:simpleType name="_CtlIfIndex"> <xs:annotation> <xs:documentation>Specifies theinferfaceinterface index used in the tracerouteoperationmeasurement for sending the traceroute probes. A value of zero for this Niccolini, et al. Expires February 25, 2008 [Page 22] Internet-Draft Traceroute Storage Format August 2007 object implies that the interface was unknown. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"/> </xs:simpleType> <xs:simpleType name="_CtlMiscOptions">Niccolini, et al. Expires August 26, 2007 [Page 25] Internet-Draft Traceroute Storage Format February 2007<xs:annotation> <xs:documentation>Specifies implementation dependent options.</xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:maxLength value="100"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_CtlMaxFailures"> <xs:annotation> <xs:documentation>Specifies the maximum number of consecutive timeouts allowed before terminating a tracerouteoperation.measurement. A value of either 255 (maximum hop count/possible TTL value) or a 0 indicates that the function of terminating a remote tracerouteoperationmeasurement when a specific number of consecutive timeouts are detected was disabled. This element is included to give full compatibility withDISMAN working group documents.RFC 4560. No known implementation of traceroute currently supports it.Units are: timeouts.</xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"/> </xs:simpleType> <xs:simpleType name="_CtlDontFragment"> <xs:annotation> <xs:documentation>Specifies if the don't fragment flag (DF) in the IP header for a probe was enabled or not. Setting the DF flag can be used for performing a manual PATH MTU test. </xs:documentation> </xs:annotation> <xs:restriction base="xs:boolean"/> </xs:simpleType> <xs:simpleType name="_CtlInitialTtl"> <xs:annotation> <xs:documentation>Specifies the initial TTL value used in a tracerouteoperation.measurement. Such Niccolini, et al. Expires February 25, 2008 [Page 23] Internet-Draft Traceroute Storage Format August 2007 TTL setting is intended to bypass the initial (often well known) portion of a path. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"> <xs:minExclusive value="0"/>Niccolini, et al. Expires August 26, 2007 [Page 26] Internet-Draft Traceroute Storage Format February 2007</xs:restriction> </xs:simpleType> <xs:simpleType name="_CtlDescr"> <xs:annotation> <xs:documentation>The purpose of this element is to provide a description of the traceroutetest.measurement. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:maxLength value="100"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_CtlType"> <xs:annotation> <xs:documentation>Specifies the implementation method used for the tracerouteoperation.measurement. It specifies if the traceroute is using TCP, UDP or ICMP probes. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:enumeration value="TCP"/> <xs:enumeration value="UDP"/> <xs:enumeration value="ICMP"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_Index"> <xs:annotation> <xs:documentation>Specifies an index that consecutively numbers all probes for which a reply was received in the sequential order in which the replies were received. The maximum value for this object is CtlMaxTtl*CtlProbesPerHop. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedShort"> <xs:minExclusive value="0"/> Niccolini, et al. Expires February 25, 2008 [Page 24] Internet-Draft Traceroute Storage Format August 2007 <xs:maxExclusive value="2551"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_HopIndex"> <xs:annotation> <xs:documentation>Specifies which hop in a traceroute measurement paththatthe probe's results are for.The value of this element is initially determined by the value of Niccolini, et al. Expires August 26, 2007 [Page 27] Internet-Draft Traceroute Storage Format February 2007 CtlInitialTtl.</xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"> <xs:minExclusive value="0"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_IndexPerHop"> <xs:annotation> <xs:documentation>Specifies the index of a probe for a particular hop in a traceroute measurement path. The number of probes per hop is determined by the value of the corresponding CtlProbesPerHop element. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedByte"> <xs:minExclusive value="0"/> <xs:maxExclusive value="11"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_HopGeoLocation"> <xs:annotation> <xs:documentation>Specifies the geo location of a hop in the traceroute measurement path. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:maxLength value="100"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_MPLSTopLabel"> <xs:annotation> <xs:documentation>Specifies the top entry of the MPLS label stack of a probe observed when the probe arrived at the hop that replied to the probe. This object contains the top MPLS label stack Niccolini, et al. Expires February 25, 2008 [Page 25] Internet-Draft Traceroute Storage Format August 2007 entry as 32 bit value as it is observed on the MPLS label stack. Contained in this single number are the MPLS label, the Exp field, the S flag, and the MPLS TTL value as specified in RFC3032 [RFC3032].3032. </xs:documentation> </xs:annotation> <xs:restriction base="xs:unsignedInt"><xs:maxExclusive value="4294967296"/><xs:maxInclusive value="4294967295"/> </xs:restriction> </xs:simpleType>Niccolini, et al. Expires August 26, 2007 [Page 28] Internet-Draft Traceroute Storage Format February 2007<xs:simpleType name="_probeRoundTripTime"> <xs:restriction base="xs:unsignedShort"> <xs:maxExclusive value="60001"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_probeRoundTripTimeNotAvailable"> <xs:restriction base="xs:string"> <xs:enumeration value="NotAvailable"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="_ResultsHopRawOutputData"> <xs:annotation> <xs:documentation>Specifies the raw output data returned by the tracerouteoperationmeasurement for a certain hop in a traceroute measurement path. </xs:documentation> </xs:annotation> <xs:restriction base="xs:string"> <xs:maxLength value="200"/> </xs:restriction> </xs:simpleType> <xs:complexType name="_inetAddressASNumber"> <xs:annotation> <xs:documentation>Specifies the AS number of a hop in the traceroute path as a 24 bit number and the indication how the mapping from IP address to AS number was performed. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="asNumber" type="_asNumber"/> <xs:element name="ipASNumberMappingType" type="_ipASNumberMappingType"/> </xs:sequence> Niccolini, et al. Expires February 25, 2008 [Page 26] Internet-Draft Traceroute Storage Format August 2007 </xs:complexType> <xs:complexType name="_inetAddress"> <xs:choice> <xs:element name="inetAddressUnknown" type="_zeroLengthString"/> <xs:element name="inetAddressIpv4" type="_inetAddressIpv4"/> <xs:element name="inetAddressIpv6" type="_inetAddressIpv6"/> <xs:element name="inetAddressDns" type="_inetAddressDns"/>Niccolini, et al. Expires August 26, 2007 [Page 29] Internet-Draft Traceroute Storage Format February 2007<xs:element name="inetAddressASNumber" type="_inetAddressASNumber"/> </xs:choice> </xs:complexType> <xs:complexType name="_inetAddressWithoutDns"> <xs:choice> <xs:element name="inetAddressUnknown" type="_zeroLengthString"/> <xs:element name="inetAddressIpv4" type="_inetAddressIpv4"/> <xs:element name="inetAddressIpv6" type="_inetAddressIpv6"/> <xs:element name="inetAddressASNumber" type="_inetAddressASNumber"/> <xs:element name="zeroLengthString" type="_zeroLengthString"/> </xs:choice> </xs:complexType> <xs:complexType name="_dateAndTime"> <xs:sequence> <xs:element name="dateAndTimeUpToSeconds" type="_dateAndTimeUpToSeconds"/> <xs:element name="timeMilliseconds" type="_timeMilliseconds"/> </xs:sequence> </xs:complexType> <xs:complexType name="_CtlTargetAddressType"> <xs:annotation> <xs:documentation>Specifies the type ofhostdestination address used in the traceroutecommand.measurement. </xs:documentation> </xs:annotation> <xs:sequence> Niccolini, et al. Expires February 25, 2008 [Page 27] Internet-Draft Traceroute Storage Format August 2007 <xs:element name="targetAddressType" type="inetAddressType"/> </xs:sequence> </xs:complexType> <xs:complexType name="_CtlTargetAddress"> <xs:annotation> <xs:documentation>Specifies the host address used in the traceroutecommand.measurement. The host address type can be determined by the examining the value of the corresponding CtlTargetAddressType. </xs:documentation>Niccolini, et al. Expires August 26, 2007 [Page 30] Internet-Draft Traceroute Storage Format February 2007</xs:annotation> <xs:sequence> <xs:element name="targetAddress" type="_inetAddress"/> </xs:sequence> </xs:complexType> <xs:complexType name="_CtlSourceAddressType"> <xs:annotation> <xs:documentation>Specifies the type of the source address, CtlSourceAddress, usedwhen performingin the tracerouteoperation.measurement. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="sourceAddressType" type="inetAddressTypeWithoutDns"/> </xs:sequence> </xs:complexType> <xs:complexType name="_CtlSourceAddress"> <xs:annotation> <xs:documentation>Specifies the IP address (which has to be given as an IP number, not a hostname) as the source address used inoutgoing probe packets.traceroute probes. On hosts with more than one IP address, this option can be used to force the source address to be something other than the primary IP address of the interface the probepacketis sent on. A zero length octet string value for this object means that sourceaddresaddress specification was disabled. The address type (InetAddressType) that relates to this object is specified by the corresponding value of CtlSourceAddressType. </xs:documentation> </xs:annotation> <xs:sequence> Niccolini, et al. Expires February 25, 2008 [Page 28] Internet-Draft Traceroute Storage Format August 2007 <xs:element name="sourceAddress" type="_inetAddressWithoutDns"/> </xs:sequence> </xs:complexType> <xs:complexType name="_ResultsStartDateAndTime"> <xs:annotation> <xs:documentation>Specifies the date and start time of the tracerouteoperation.measurement. This is the time when the first probe wassent.seen at the sending interface. </xs:documentation> </xs:annotation> <xs:sequence>Niccolini, et al. Expires August 26, 2007 [Page 31] Internet-Draft Traceroute Storage Format February 2007<xs:element name="dateAndTime" type="_dateAndTime"/> </xs:sequence> </xs:complexType> <xs:complexType name="_ResultsIpTgtAddrType"> <xs:annotation> <xs:documentation>Specifies the type of address stored in the corresponding ResultsIpTgtAddr element. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="ipTgtAddrType" type="inetAddressTypeWithoutDns"/> </xs:sequence> </xs:complexType> <xs:complexType name="_ResultsIpTgtAddr"> <xs:annotation> <xs:documentation>Specifies the IP address associated with a CtlTargetAddress value when the destination address is specified as a DNS name. The value of this object should be a zero length octet string when a DNS name is not specified or when a specified DNS name fails to resolve. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="ipTgtAddr" type="_inetAddressWithoutDns"/> </xs:sequence> </xs:complexType> <xs:complexType name="_HopAddrType"> <xs:annotation> Niccolini, et al. Expires February 25, 2008 [Page 29] Internet-Draft Traceroute Storage Format August 2007 <xs:documentation>Specifies the type of address stored in the corresponding HopAddr element. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="probeHopAddrType" type="inetAddressTypeWithoutDns"/> </xs:sequence> </xs:complexType> <xs:complexType name="_HopAddr"> <xs:annotation> <xs:documentation>Specifies the address of a hop in the traceroute measurement path. This object is not allowed toNiccolini, et al. Expires August 26, 2007 [Page 32] Internet-Draft Traceroute Storage Format February 2007be a DNS name. The value of the corresponding object, HopAddrType, indicates this object's IP address type. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="probeHopAddr" type="_inetAddressWithoutDns"/> </xs:sequence> </xs:complexType> <xs:complexType name="_RoundTripTime"> <xs:annotation> <xs:documentation>Specifies the amount of time measured in milliseconds from when a probe was sent to when its response was received or when it timed out. The value of this element is reported as the truncation of the number reported by the traceroute tool (the output"<1"< 1 ms" is therefore encoded as 0 ms). A string with the value of "RoundTripTimeNotAvailable" means either the probe was lost because of a timeout or it was not possible to transmit a probe.Units are: milliseconds.</xs:documentation> </xs:annotation> <xs:choice> <xs:element name="probeRoundTripTime" type="_probeRoundTripTime"/> <xs:element name="probeRoundTripTimeNotAvailable" type="_probeRoundTripTime"/> </xs:choice> </xs:complexType> Niccolini, et al. Expires February 25, 2008 [Page 30] Internet-Draft Traceroute Storage Format August 2007 <xs:complexType name="_ResponseStatus"> <xs:annotation> <xs:documentation>Specifies the result of a tracerouteoperationmeasurement made by the host for a particular probe. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="probeResponseStatus" type="operationResponseStatus"/> </xs:sequence> </xs:complexType> <xs:complexType name="_Time"> <xs:annotation> <xs:documentation>Specifies the timestamp for when the response to the probe wasreceived. Niccolini, et al. Expires August 26, 2007 [Page 33] Internet-Draft Traceroute Storage Format February 2007received at the interface. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="dateAndTime" type="_dateAndTime"/> </xs:sequence> </xs:complexType> <xs:complexType name="_ResultsProbe"> <xs:sequence> <xs:element name="Index" type="_Index"/> <xs:element name="HopIndex" type="_HopIndex"/> <xs:element name="IndexPerHop" type="_IndexPerHop"/> <xs:element name="HopAddrType" type="_HopAddrType"/> <xs:element name="HopAddr" type="_HopAddr"/> <xs:element name="HopGeoLocation" type="_HopGeoLocation" minOccurs="0" maxOccurs="1"/> <xs:element name="MPLSTopLabel" type="_MPLSTopLabel" minOccurs="0" maxOccurs="1"/> <xs:element name="RoundTripTime" type="_RoundTripTime"/> <xs:element name="ResponseStatus" type="_ResponseStatus"/> <xs:element name="Time" type="_Time"/> Niccolini, et al. Expires February 25, 2008 [Page 31] Internet-Draft Traceroute Storage Format August 2007 </xs:sequence> </xs:complexType> <xs:complexType name="_ResultsEndDateAndTime"> <xs:annotation> <xs:documentation>Specifies the date and end time of the tracerouteoperation.measurement. It is either the time when the response to the last probe of the tracerouteoperationmeasurement was received or the time when the last probe of the tracerouteoperationmeasurement was sent plus the relative timeout (in case of missing response). </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="dateAndTime" type="_dateAndTime"/> </xs:sequence> </xs:complexType>Niccolini, et al. Expires August 26, 2007 [Page 34] Internet-Draft Traceroute Storage Format February 2007<xs:complexType name="_Metadata"> <xs:annotation> <xs:documentation>Specifies the metadata for a traceroute operation. In a request, these are the requested parameters. In a response, they are the actual parameters used. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="TestName" type="_TestName"/> <xs:element name="OSName" type="_OSName" minOccurs="0" maxOccurs="1"/> <xs:element name="OSVersion" type="_OSVersion" minOccurs="0" maxOccurs="1"/> <xs:element name="ToolVersion" type="_ToolVersion" minOccurs="0" maxOccurs="1"/> <xs:element name="CtlTargetAddressType" type="_CtlTargetAddressType"/> <xs:element name="CtlTargetAddress" type="_CtlTargetAddress"/> <xs:elementname="CtlByPassRouteTable" type="_CtlByPassRouteTable"name="CtlBypassRouteTable" type="_CtlBypassRouteTable" minOccurs="0" maxOccurs="1" default="false"/> <xs:element name="CtlProbeDataSize" Niccolini, et al. Expires February 25, 2008 [Page 32] Internet-Draft Traceroute Storage Format August 2007 type="_CtlProbeDataSize" minOccurs="0" maxOccurs="1" default="0"/> <xs:element name="CtlTimeOut" type="_CtlTimeOut" minOccurs="0" maxOccurs="1" default="3"/> <xs:element name="CtlProbesPerHop" type="_CtlProbesPerHop" minOccurs="0" maxOccurs="1" default="3"/> <xs:element name="CtlPort" type="_CtlPort" minOccurs="0" maxOccurs="1" default="33434"/> <xs:element name="CtlMaxTtl" type="_CtlMaxTtl" minOccurs="0" maxOccurs="1" default="30"/> <xs:element name="CtlDSField" type="_CtlDSField" minOccurs="0" maxOccurs="1" default="0"/> <xs:element name="CtlSourceAddressType" type="_CtlSourceAddressType"/>Niccolini, et al. Expires August 26, 2007 [Page 35] Internet-Draft Traceroute Storage Format February 2007<xs:element name="CtlSourceAddress" type="_CtlSourceAddress"/> <xs:element name="CtlIfIndex" type="_CtlIfIndex" minOccurs="0" maxOccurs="1" default="0"/> <xs:element name="CtlMiscOptions" type="_CtlMiscOptions" minOccurs="0" maxOccurs="1"/> <xs:element name="CtlMaxFailures" type="_CtlMaxFailures" minOccurs="0" maxOccurs="1" default="5"/> <xs:element name="CtlDontFragment" type="_CtlDontFragment" minOccurs="0" maxOccurs="1" default="false"/> <xs:element name="CtlInitialTtl" type="_CtlInitialTtl" minOccurs="0" maxOccurs="1" default="1"/> <xs:element name="CtlDescr" type="_CtlDescr" minOccurs="0" maxOccurs="1"/> <xs:element name="CtlType" type="_CtlType" minOccurs="0" maxOccurs="1" default="UDP"/> </xs:sequence> </xs:complexType> <xs:complexType name="_Measurement"> <xs:annotation> Niccolini, et al. Expires February 25, 2008 [Page 33] Internet-Draft Traceroute Storage Format August 2007 <xs:documentation> Contains the actual traceroutemeasurement.measurement results. </xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="TestName" type="_TestName"/> <xs:element name="ResultsStartDateAndTime" type="_ResultsStartDateAndTime"/> <xs:element name="ResultsIpTgtAddrType" type="_ResultsIpTgtAddrType"/> <xs:element name="ResultsIpTgtAddr" type="_ResultsIpTgtAddr"/> <xs:element name="ResultsProbe" type="_ResultsProbe" minOccurs="1" maxOccurs="2550"/> <xs:element name="ResultsHopRawOutputData" type="_ResultsHopRawOutputData" minOccurs="0" maxOccurs="255"/>Niccolini, et al. Expires August 26, 2007 [Page 36] Internet-Draft Traceroute Storage Format February 2007<xs:element name="ResultsEndDateAndTime" type="_ResultsEndDateAndTime"/> </xs:sequence> </xs:complexType> <xs:complexType name="_traceRoute"> <xs:choice> <xs:sequence> <xs:element name="Request" type="_Metadata"/> </xs:sequence> <xs:sequence> <xs:element name="MeasurementMetadata" type="_Metadata"/> </xs:sequence> <xs:sequence> <xs:element name="Measurement" type="_Measurement"/> </xs:sequence> <xs:sequence> <xs:element name="Request" type="_Metadata"/> <xs:element name="MeasurementMetadata" type="_Metadata"/> </xs:sequence> <xs:sequence> <xs:element name="Request" type="_Metadata"/> Niccolini, et al. Expires February 25, 2008 [Page 34] Internet-Draft Traceroute Storage Format August 2007 <xs:element name="Measurement" type="_Measurement"/> </xs:sequence> <xs:sequence> <xs:element name="MeasurementMetadata" type="_Metadata"/> <xs:element name="Measurement" type="_Measurement"/> </xs:sequence> <xs:sequence> <xs:element name="Request" type="_Metadata"/> <xs:element name="MeasurementMetadata" type="_Metadata"/> <xs:element name="Measurement" type="_Measurement"/> </xs:sequence> </xs:choice> </xs:complexType>Niccolini, et al. Expires August 26, 2007 [Page 37] Internet-Draft Traceroute Storage Format February 2007<!--Reference to "traceRoute" element--> <xs:element xmlns="urn:ietf:params:xml:ns:traceroute-1.0" name="traceRoute" type="_traceRoute"/> </xs:schema> 8.DifferencesSecurity Considerations Security considerations in this section discuss are grouped into considerations related toDISMAN-TRACEROUTE-MIB For performing remoteconducting tracerouteoperations at managed node, the IETF has standardized the DISMAN-TRACEROUTE-MIB module in RFC 4560 [RFC4560].measurements and considerations related to storing and transmitting traceroute measurements information. Thismodule allows: o retrieving capability informationmemo does not specify an implementation ofthea tracerouteimplementation at the managed node, o configuringtool. Neither does it specify a certain procedure for storing tracerouteoperationsmeasurements information. Still it is considered desirable tobe prformed, o retrieving information about ongoingdiscuss related security issues below. 8.1. Conducting Traceroute Measurements Conducting Internet measurements can raise both security andcompleted tracerouteprivacy concerns. Traceroute measurements,o retrieving traceroute measurement statistics. The traceroute storage format describedinthis document has significant overlaps with this MIB module. Particularly,which traffic is injected into themodelsnetwork, can be abused forthe traceroutedenial-of-service attacks disguised as legitimate measurementconfiguration and for the result from completed measurements are almost identical. But for other pats of the DISMAN-TRACEROUTE MIB module there is no need to model them in a traceroute storage format. Particularly, the capability information, information about ongoing measurements and measurement statistics are not covered byactivity. Niccolini, et al. Expires February 25, 2008 [Page 35] Internet-Draft Traceroute Storage Format August 2007 Measurement parameters MUST be carefully selected so that thetraceroute storage model. Concerning traceroutemeasurementsand results, there are structural differences between the two models caused by the different choices for the encodinginject trivial amounts of additional traffic into thespecification. For DISMAN-TRACEROUTE-MIB,networks they measure. If they inject "too much" traffic, they can skew theStructureresults ofManagement Information (SMIv2, STD 58, RFC 2578 [RFC2578]) was used, while forthetraceroute storage format is encoded using XML. This differencemeasurement, and instructure implies that the DISMAN-TRACEROUTE-MIB module contains SMI-specific information element (managed objects) that concern tables of managed objects (specification, entry creationextreme cases cause congestion anddelection, status retrieval) that are not required for the XML- encoded traceroute storage format. But for most of the remaining information elements that concern configurationdenial oftracerouteservice. The measurements themselves could be harmed by routers giving measurement traffic a different priority than "normal" traffic, or by an attacker injecting artificial measurement traffic. If routers can recognize measurement traffic andresults of completed measurements,treat it separately, thesemanticsmeasurements will not reflect actual user traffic. If an attacker injects artificial traffic that isidentical betweenaccepted as legitimate, theDISMAN- TRACEROUTE-MIB module andloss rate will be artificially lowered. Therefore, thetraceroute storage format. There are very few exceptionsmeasurement methodologies SHOULD include appropriate techniques tothis whichreduce the probability measurement traffic can be distinguished from "normal" traffic. Authentication techniques, such as digital signatures, may be used where appropriate to guard against injected traffic attacks. 8.2. Securing Traceroute Measurements Information Traceroute measurement information arelisted below. Also namingnot considered highly sensitive. Still, they may contain sensitive information on network paths, routing states, use IP addresses, and roundtrip times, that the operator a networks may want to detect for business or security reasons. It is thus important to control access to Information acquired by conducting traceroute measurements, particularly when transmitting it over a networks but also when storing it. It is RECOMMENDED that transmission of traceroute measurement informationelementsover a network uses appropriate protection mechanisms for preserving privacy, integrity and authenticity. It isidentical between both models withfurther RECOMMENDED that secure authentication and authorization are used for protecting stored traceroute measurement information. 9. IANA Considerations This document uses URNs to describe an XML namespace and an XML schema for traceroute measurements information storing and transmission conforming to afewregistry mechanism described in [RFC3688]. Two URI assignments are requested. 1. Registration request for the IPPM traceroute measurements namespace Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page38]36] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007exceptions. For* URI: urn:ietf:params:xml:ns:traceroute-1.0 * Registrant Contact: IESG * XML: None. Namespace URIs do not represent an XML 2. Registration request for the IPPM traceroutestorage model, a few information elements have been added, some because ofmeasurements schema * URI: urn:ietf:params:xml:schema:traceroute-1.0 * Registrant Contact: IESG * XML: See thedifferent structure and some to provide additional information on completed measurements. 8.1. Naming Basically, names in both models are chosen using the same naming conventions. For the traceroute measurement configuration information all names, such as CtlProbesPerHop, are identical in both models exceptsection Section 7 of this document. 10. References 10.1. Normative References [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Textual Conventions forthe traceRoute prefix that was removed to avoid unecessary redundancy in the XML fileSMIv2", STD 58, RFC 2579, April 1999. [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", RFC 2863, June 2000. [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder, "Textual Conventions forCtlDataSize which was renamed to CtlProbeDataSizeInternet Network Addresses", RFC 4001, February 2005. [RFC4560] Quittek, J. and K. White, "Definitions of Managed Objects forclarificationRemote Ping, Traceroute, and Lookup Operations", RFC 4560, June 2006. 10.2. Informative References [I-D.ietf-ipfix-architecture] Sadasivan, G., "Architecture for IP Flow Information Export", draft-ietf-ipfix-architecture-12 (work in progress), September 2006. [I-D.ietf-ipfix-info] Quittek, J., "Information Model for IP Flow Information Export", draft-ietf-ipfix-info-15 (work in progress), February 2007. [I-D.ietf-ipfix-protocol] Claise, B., "Specification of thetraceroute storage model. ResultsIPFIX Protocol for the Exchange ofmeasurementsIP Traffic Flow Information", draft-ietf-ipfix-protocol-25 (work in progress), August 2007. [RFC1812] Baker, F., "Requirements for IP Version 4 Routers", RFC 1812, June 1995. Niccolini, et al. Expires February 25, 2008 [Page 37] Internet-Draft Traceroute Storage Format August 2007 [RFC2474] Nichols, K., Blake, S., Baker, F., and D. Black, "Definition of theDISMAN-TRACEROUTE-MIB modules are distributed over two tables,Differentiated Services Field (DS Field) in thetraceRouteResultsTable containing mainly information about ongoing measurementsIPv4 andthe traceRouteProbeHistoryTable containing only information about completed measurements. According to the SMIv2 naming conventions namesIPv6 Headers", RFC 2474, December 1998. [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Structure ofinformation elements in these tables have different prefixes (traceRouteResultsManagement Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC3032] Rosen, E., Tappan, D., Fedorkow, G., Rekhter, Y., Farinacci, D., Li, T., andtraceRouteProbeHistory). SinceA. Conta, "MPLS Label Stack Encoding", RFC 3032, January 2001. [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. [RFC3417] Presuhn, R., "Transport Mappings for the Simple Network Management Protocol (SNMP)", STD 62, RFC 3417, December 2002. [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, January 2004. [XML] Yergeau et al., F., "Extensible Markup Language (XML) 1.0 (Third Edition)", W3C Recommendation, February 2004. Appendix A. Traceroute Default Configuration Parameters This section lists traceroutestorage format only reportsmeasurement configuration parameters as well as their defaults oncompleted measurements, this separation is not needed anymorevarious platforms and illustrates how widely they may vary. This document considered four major traceroute tool implementations and compared them based on configurable parameters and default values. The LINUX (SUSE 9.1), BSD (FreeBSD 7.0) and UNIX (SunOS 5.9) implementations are based on UDP datagrams, while theprefix "Results"WINDOWS (XP SP2) one uses ICMP Echos. The comparison isused for all related information elements. Beyond that, there are only a few changessummarized inelement names. The renaming actions include: o traceRouteProbeHistoryProbeIndex to IndexPerHop, o traceRouteProbeHistoryResponse to RoundTripTime, o traceRouteProbeHistoryTime to ResultsEndDateAndTime, o traceRouteProbeHistoryLastRC to ResultsHopRawOutputData. 8.2. Semantics The semantics was changed for two information elements only. For traceRouteProbeHistoryResponsethe following table, where an N/A in theDISMAN-TRACEROUTE-MIB, a value of 0 indicated,option column, means thatit wassuch parameter is notpossible to transmit a probe. For the traceroute strorage format, a value of 0configurable forelement RoundTripTime indicates thatthemeasured time was less than one millisecond, while forspecific implementation. A comprehensive comparison of available implementations is outside thecase that it was not possible to transmit a probescope of this document; however, already by sampling astring is usedfew different implementations, it can be observed thatindicates the problem. For traceRouteCtlIfIndexthey can differ quite significantly inthe DISMAN-TRACEROUTE-MIB, a valueterms of0 indicated,configurable parameters and also default values. Note thatitin theoption to setfollowing table only those options which are available in at least two of theindex is not available. This was translated toconsidered implementations are reported. +---------------------------------------------------------+ Niccolini, et al. Expires February 25, 2008 [Page 38] Internet-Draft Traceroute Storage Format August 2007 | OS |Option| Description | Default | +--------+------+-------------------------------+---------+ | LINUX | -m |Specify the maximum TTL used | 30 | |--------+------|in traceroute probes. |---------| | FreeBSD| -m | | OS var | |--------+------| |---------| | UNIX | -m | | 30 | |--------+------| |---------| | WINDOWS| -h | | 30 | +--------+------+-------------------------------+---------+ | LINUX | -n |Display hop addresses | - | |--------+------|numerically rather than |---------| | FreeBSD| -n |symbolically. | - | |--------+------| |---------| | UNIX | -n | | - | |--------+------| |---------| | WINDOWS| -d | | - | +--------+------+-------------------------------+---------+ | LINUX | -w |Set the time to wait for a | 3 sec | |--------+------|response to a probe. |---------| | FreeBSD| -w | | 5 sec | |--------+------| |---------| | UNIX | -w | | 5 sec | |--------+------| |---------| | WINDOWS| -w | | 4 sec | +--------+------+-------------------------------+---------+ | LINUX | N/A |Specify a loose source route | - | |--------+------|gateway (to direct the |---------| | FreeBSD| -g |traceroute probes through | - | |--------+------|routers not necessarily in |---------| | UNIX | -g | the path). | - | |--------+------| |---------| | WINDOWS| -g | | - | +--------+------+-------------------------------+---------+ | LINUX | -p |Set the base UDP port number | 33434 | |------- +------|used in traceroute probes |---------| | FreeBSD| -p |(UDP port = base + nhops - 1). | 33434 | |--------+------| |---------| | UNIX | -p | | 33434 | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | -q |Set the number of probes per | 3 | |--------+------|TTL. |---------| | FreeBSD| -q | | 3 | |--------+------| |---------| | UNIX | -q | | 3 | |--------+------| |---------| Niccolini, et al. Expires February 25, 2008 [Page 39] Internet-Draft Traceroute Storage Format August 2007 | WINDOWS| N/A | | 3 | +--------+------+-------------------------------+---------+ | LINUX | -S |Set the IP source address in |IP | |--------+------|outgoing probes to the |address | | FreeBSD| -s |specified value. |of the | |--------+------| |out | | UNIX | -s | |interface| |--------+------| | | | WINDOWS| N/A | | | +--------+------+-------------------------------+---------+ | LINUX | -t |Set the type-of-service (TOS) | 0 | |--------+------|in the probes to the specified |---------| | FreeBSD| -t |value. | 0 | |--------+------| |---------| | UNIX | -t | | 0 | |--------+------| |---------| | WINDOWS| N/A | | 0 | +--------+------+-------------------------------+---------+ | LINUX | -v |Verbose output: received ICMP | - | |--------+------|packets other than |---------| | FreeBSD| -v |TIME_EXCEEDED and | - | |--------+------|UNREACHABLE are listed. |---------| | UNIX | -v | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | N/A |Set the time (in msec) to | - | |--------+------|pause between probes. |---------| | FreeBSD| -z | | 0 | |--------+------| |---------| | UNIX | -P | | 0 | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | -r |Bypass the normal routing | - | |--------+------|tables and send directly to a |---------| | FreeBSD| -r |host on attached network. | - | |--------+------| |---------| | UNIX | -r | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | -f |Set the initial TTL for the | 1 | |--------+------|first probe. |---------| | FreeBSD| -f | | 1 | |--------+------| |---------| | UNIX | -f | | 1 | |--------+------| |---------| Niccolini, et al. Expires February 25, 2008 [Page 40] Internet-Draft Traceroute Storage Format August 2007 | WINDOWS| N/A | | 1 | +--------+------+-------------------------------+---------+ | LINUX | -F |Set the "don't fragment" bit. | - | |--------+------| |---------| | FreeBSD| -F | | - | |--------+------| |---------| | UNIX | -F | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | N/A |Enables socket level debugging.| - | |--------+------| |---------| | FreeBSD| -d | | - | |--------+------| |---------| | UNIX | -d | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | N/A |Use ICMP ECHO instead of UDP | - | |--------+------|datagrams. |---------| | FreeBSD| -I | | - | |--------+------| |---------| | UNIX | -I | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | -I |Specify a network interface to | - | |--------+------|obtain the IP address for |---------| | FreeBSD| -i |outgoing IP packets | - | |--------+------|(alternative to option -s). |---------| | UNIX | -i | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | N/A |Toggle checksum. | - | |--------+------| |---------| | FreeBSD| -x | | - | |--------+------| |---------| | UNIX | -x | | - | |--------+------| |---------| | WINDOWS| N/A | | - | +--------+------+-------------------------------+---------+ | LINUX | - |As optional last parameter, |Depends | |--------+------|LINUX, FreeBSD and UNIX |on | | FreeBSD| - |implementations allow |implement| |--------+------|specifying thetraceroute strorage format, such that aprobe datagram |ation. | | UNIX | - |length for outgoing probes. | | |--------+------| | | Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page39]41] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007value of 0 for this element indicates that| WINDOWS| N/A | | | +--------+------+-------------------------------+---------+ A.1. Alternative Traceroute Implementations As stated above, theused interface is unknown. The element traceRouteProbeHistoryLastRC inwidespread use of firewalls might prevent UDP or ICMP based traceroutes to completely trace theDISMAN-TRACEROUTE-MIB was replaced by element ResultsHopRawOutputData. While traceRouteProbeHistoryLastRC just reportspath to areply code, ResultsHopRawOutputData reports the full raw output data produced by thedestination, since tracerouteinstance that was used. 8.3. Additional Information Elements Only a few information elements have been addedprobes might end up being filtered. In some cases, such limitation might be overcome by sending instead TCP packets to specific ports that hosts located behind themodelfirewall are listening for connections on. TCP based implementations use TCP SYN or FIN probes and listen for TIME_EXCEEDED messages, TCP RESET and other messages from firewalls and gateways on the path. On the other hand, some firewalls filter out TCP SYN packets to prevent denial of service attacks, therefore theDISMAN-TRACEROUTE-MIB module. o For providing geographical information about hopsactual advantage of using TCP instead of UDP traceroute depends mainly on firewall configurations, which are not known intheadvance. A detailed analysis of TCP-based traceroutepath, HopGeoLocationtools and measurements wasadded. o For providingoutside thetop MPLS label stack entryscope ofa probe inthis document, anyway for completeness reasons the information model supports the storing of TCP-based traceroutepath MPLSTopLabel was added. o For providing additional timestamp beyond ResultsEndDateAndTime, ResultsStartDateAndTime and Time were added. 9. Security Considerations Security considerations in this section discuss are grouped into considerations related to conductingmeasurements, too. Appendix B. Known Problems with Traceroute B.1. Compatibility between traceroute measurementsand considerations related to storing and transmittingresults and IPPM metrics Because ofmeasurements. This memo does not specify animplementationofchoices, a known inconsistency exists between the round-trip delay metric defined by the IPPM working group in RFC 2681 and the results returned by the current traceroutemeasurements. Neither doestool implementations. Unfortunately, itspecify a certain procedure for storingis unlikely that the traceroutemeasurement results. Still ittool implementations will implement the standard definition in the near future. The only possibility isconsidered desirabletherefore todiscuss related security issues below. 9.1. Conducting Traceroute Measurements Conducting Internetcompare results of different traceroute measurementscan raiseone with each other; in order to do this, specifications bothsecurityof the operating system (name andprivacy concerns. Traceroute measurements, in which traffic is injected intoversion) and of thenetwork, can be abused for denial-of-service attacks disguised as legitimate measurement activity. Measurement parameters MUST be carefully selected so thattraceroute tool version used were added to the metadata elements in order to help in comparing metrics between two different traceroute measurementsinject trivial amountsresults (if run using the same operating system and the same version ofadditional traffic intothenetworks they measure. If they inject "too much" traffic, theytool). Moreover, the traceroute tool has built-in configurable mechanisms like time-outs and canskewexperience problems related to theresultscrossing ofthe measurement, and in extreme cases cause congestion and denialfirewalls; therefore some ofservice. The measurements themselves couldthe packets that traceroute sends out end up being time-out or filtered. As a consequence, it might not beharmed by routers givingpossible to trace the path to a node or there might not be a complete set of probes describing the RTT to reach it. Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page40]42] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007measurement traffic a different priority than "normal" traffic, or by an attacker injecting artificial measurement traffic. If routers can recognize measurement traffic and treat it separately,Appendix C. Differences to DISMAN-TRACEROUTE-MIB For performing remote traceroute operations at managed node, themeasurements will not reflect actual user traffic. If an attacker injects artificial traffic that is accepted as legitimate,IETF has standardized theloss rate will be artificially lowered. Therefore,DISMAN-TRACEROUTE-MIB module in [RFC4560]. This module allows: o retrieving capability information of themeasurement methodologies SHOULD include appropriate techniquestraceroute tool implementation at the managed node, o configuring traceroute measurements toreducebe performed, o retrieving information about ongoing and completed traceroute measurements, o retrieving traceroute measurement statistics. The traceroute storage format described in this document has significant overlaps with this MIB module. Particularly, theprobabilitymodels for the traceroute measurementtraffic can be distinguishedconfiguration and for the result from"normal" traffic. Authentication techniques, such as digital signatures, may be used where appropriatecompleted measurements are almost identical. But for other pats of the DISMAN-TRACEROUTE MIB module there is no need toguard against injected traffic attacks. 9.2. Securing Traceroute Measurement Results Traceroute resultsmodel them in a traceroute measurements storage format. Particularly, the capability information, information about ongoing measurements and measurement statistics are notconsidered highly sensible. Still, they may contain sensible information on network paths, routing states, use IP addresses,covered by the DISMAN traceroute storage model. Concerning traceroute measurements androundtrip times, thattheir results, there are structural differences between theoperator a networks may want to detecttwo models caused by the different choices forbusiness or security reasons. It is thus important to control access tothe encoding of the specification. For DISMAN- TRACEROUTE-MIB, the Structure of Management Informationacquired by conducting(SMIv2, STD 58, RFC 2578 [RFC2578]) was used, while the IPPM traceroutemeasurement, particularly when transmitting it over a networks but also when storing it. Itmeasurements data model isRECOMMENDEDencoded using XML. This difference in structure implies thattransmissionthe DISMAN-TRACEROUTE-MIB module contains SMI-specific information element (managed objects) that concern tables oftraceroute measurement results over a network uses appropriate protection mechanisms for preserving privacy, integritymanaged objects (specification, entry creation andauthenticity. It is further RECOMMENDEDdeletion, status retrieval) thatsecure authentication and authorizationareusednot required forprotecting storedthe XML- encoded tracerouteresults. 10. IANA Considerations This document uses URNs to describe an XML namespace and an XML schemameasurements data model. But for most of the remaining information elements that concern configuration of traceroute measurementsconforming to a registry mechanism described in [RFC3688]. Two URI assignments are requested. 1. Registration request forand results of completed measurements, the semantics is identical between the DISMAN- TRACEROUTE-MIB module and theIPPMtraceroute measurementsnamespace * URI: urn:ietf:params:xml:ns:traceroute-1.0 * Registrant Contact: TBD. * XML: None. Namespace URIs do not represent an XML 2. Registration request fordata model. There are very few exceptions to this which are listed below. Also naming of information elements is identical between both models with a few exceptions. For theIPPMtraceroute measurementsschema * URI: urn:ietf:params:xml:schema:traceroute-1.0 * Registrant Contact: TBD. * XML: See the section Section 7data model, a few information elements have been added, some because ofthis document. 11. Referencesthe different structure and some to provide additional information on completed measurements. Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page41]43] Internet-Draft Traceroute Storage FormatFebruaryAugust 200711.1. Normative References [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder, "Textual ConventionsC.1. Naming Basically, names in both models are chosen using the same naming conventions. For the traceroute measurement configuration information all names, such as CtlProbesPerHop, are identical in both models except forInternet Network Addresses", RFC 4001, February 2005. 11.2. Informative References [I-D.ietf-disman-remops-mib-v2] Quittek, J.the traceRoute prefix that was removed to avoid unnecessary redundancy in the XML file andK. White, "Definitions of Managed ObjectsforRemote Ping, Traceroute,CtlDataSize which was renamed to CtlProbeDataSize for clarification in the traceroute measurements data model. Results of measurements in the DISMAN-TRACEROUTE-MIB modules are distributed over two tables, the traceRouteResultsTable containing mainly information about ongoing measurements andLookup Operations", draft-ietf-disman-remops-mib-v2-09 (workthe traceRouteProbeHistoryTable containing only information about completed measurements. According to the SMIv2 naming conventions names of information elements inprogress), February 2006. [I-D.ietf-ipfix-architecture] Sadasivan, G., "Architecturethese tables have different prefixes (traceRouteResults and traceRouteProbeHistory). Since the traceroute measurements data model only reports on completed measurements, this separation is not needed anymore and the prefix "Results" is used forIP Flow Information Export", draft-ietf-ipfix-architecture-12 (workall related information elements. Beyond that, there are only a few changes inprogress), September 2006. [I-D.ietf-ipfix-info] Quittek, J., "Information Modelelement names. The renaming actions include: o traceRouteProbeHistoryProbeIndex to IndexPerHop, o traceRouteProbeHistoryResponse to RoundTripTime, o traceRouteProbeHistoryTime to ResultsEndDateAndTime, o traceRouteProbeHistoryLastRC to ResultsHopRawOutputData. C.2. Semantics The semantics was changed forIP Flow Information Export", draft-ietf-ipfix-info-14 (worktwo information elements only. For traceRouteProbeHistoryResponse inprogress), October 2006. [I-D.ietf-ipfix-protocol] Claise, B., "Specificationthe DISMAN-TRACEROUTE-MIB, a value of 0 indicated, that it was not possible to transmit a probe. For theIPFIX Protocoltraceroute measurements data model, a value of 0 for element RoundTripTime indicates that theExchange", draft-ietf-ipfix-protocol-24 (work in progress), November 2006. [RFC1812] Baker, F., "Requirementsmeasured time was less than one millisecond, while forIP Version 4 Routers", RFC 1812, June 1995. [RFC2474] Nichols, K., Blake, S., Baker, F., and D. Black, "Definition oftheDifferentiated Services Field (DS Field)case that it was not possible to transmit a probe a string is used that indicates the problem. For traceRouteCtlIfIndex in theIPv4 and IPv6 Headers", RFC 2474, December 1998. [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "StructureDISMAN-TRACEROUTE-MIB, a value ofManagement Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", RFC 2863, June 2000.0 indicated, that it the option to set the index is not available. This was translated to the traceroute measurements data model, such that a value of 0 for this element indicates that the used interface is unknown. Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page42]44] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007[RFC3032] Rosen, E., Tappan, D., Fedorkow, G., Rekhter, Y., Farinacci, D., Li, T., and A. Conta, "MPLS Label Stack Encoding", RFC 3032, January 2001. [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. [RFC3417] Presuhn, R., "Transport Mappings forThe element traceRouteProbeHistoryLastRC in theSimple Network Management Protocol (SNMP)", STD 62, RFC 3417, December 2002. [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, January 2004. [RFC4560] Quittek, J. and K. White, "DefinitionsDISMAN-TRACEROUTE-MIB was replaced by element ResultsHopRawOutputData. While traceRouteProbeHistoryLastRC just reports a reply code, ResultsHopRawOutputData reports the full raw output data produced by the traceroute measurements that was used. C.3. Additional Information Elements Only a few information elements have been added to the model ofManaged Objects for Remote Ping, Traceroute,the DISMAN-TRACEROUTE-MIB module. o For providing geographical information about hops in the traceroute measurement path, HopGeoLocation was added. o For providing the top MPLS label stack entry of a probe in the traceroute measurement path MPLSTopLabel was added. o For providing additional timestamp beyond ResultsEndDateAndTime, ResultsStartDateAndTime andLookup Operations", RFC 4560, June 2006. [XML] Yergeau et al., F., "Extensible Markup Language (XML) 1.0 (Third Edition)", W3C Recommendation, February 2004.Time were added. Authors' Addresses Saverio Niccolini Network Laboratories, NEC Europe Ltd. Kurfuersten-Anlage 36 Heidelberg 69115 Germany Phone: +49 (0) 6221 4342 118 Email: saverio.niccolini@netlab.nec.de URI: http://www.netlab.nec.de Sandra Tartarelli Network Laboratories, NEC Europe Ltd. Kurfuersten-Anlage 36 Heidelberg 69115 Germany Phone: +49 (0) 6221 4342 132 Email: sandra.tartarelli@netlab.nec.de URI: http://www.netlab.nec.de Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page43]45] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007 Juergen Quittek Network Laboratories, NEC Europe Ltd. Kurfuersten-Anlage 36 Heidelberg 69115 Germany Phone: +49 (0) 6221 4342 115 Email: quittek@netlab.nec.de URI: http://www.netlab.nec.de Martin Swany Dept. of Computer and Information Sciences, University of Delaware Newark DE 19716 U.S.A. Email: swany@UDel.Edu Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page44]46] Internet-Draft Traceroute Storage FormatFebruaryAugust 2007 Full Copyright Statement Copyright (C) The IETF Trust (2007). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Intellectual Property The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org. Acknowledgment Funding for the RFC Editor function is provided by the IETF Administrative Support Activity (IASA). Niccolini, et al. ExpiresAugust 26, 2007February 25, 2008 [Page45]47] ----