One document matched: draft-ietf-dime-qos-attributes-12.xml
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type='text/xsl' href='./rfc2629.xslt' ?>
<?rfc toc="yes"?>
<?rfc symrefs="yes"?>
<?rfc compact="no" ?>
<?rfc sortrefs="yes" ?>
<?rfc strict="yes" ?>
<?rfc linkmailto="yes" ?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
<!ENTITY RFC2119 PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml'>
<!ENTITY RFC4005 PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml/reference.RFC.4005.xml'>
<!ENTITY RFC3588 PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml/reference.RFC.3588.xml'>
<!ENTITY RFC2780 PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2780.xml'>
<!ENTITY RFC2474 PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2474.xml'>
<!ENTITY I-D.ietf-dime-rfc3588bis PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml3/reference.I-D.ietf-dime-rfc3588bis.xml'>
<!ENTITY I-D.ietf-dime-qos-parameters PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml3/reference.I-D.ietf-dime-qos-parameters.xml'>
<!ENTITY I-D.ietf-dime-diameter-qos PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml3/reference.I-D.ietf-dime-diameter-qos.xml'>
<!ENTITY RFC3290 PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml/reference.RFC.3290.xml'>
<!ENTITY RFC2475 PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2475.xml'>
<!ENTITY RFC5226 PUBLIC ''
'http://xml.resource.org/public/rfc/bibxml/reference.RFC.5226.xml'>]>
<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
<?rfc toc="yes" ?>
<?rfc symrefs="yes" ?>
<?rfc sortrefs="yes"?>
<?rfc iprnotified="no" ?>
<?rfc strict="no" ?>
<?rfc compact="yes" ?>
<?rfc subcompact="yes" ?>
<rfc ipr="pre5378Trust200902" category="std" docName="draft-ietf-dime-qos-attributes-12.txt">
<front>
<title abbrev="QoS Attributes for Diameter">Quality of Service Attributes for Diameter</title>
<author initials="J" surname="Korhonen" fullname="Jouni Korhonen">
<organization>Nokia Siemens Networks</organization>
<address>
<postal>
<street>Linnoitustie 6</street>
<city>Espoo</city>
<code>02600</code>
<country>Finland</country>
</postal>
<email>jouni.korhonen@nsn.com</email>
</address>
</author>
<author initials="H." surname="Tschofenig" fullname="Hannes Tschofenig">
<organization>Nokia Siemens Networks</organization>
<address>
<postal>
<street>Linnoitustie 6</street>
<city>Espoo</city>
<code>02600</code>
<country>Finland</country>
</postal>
<phone>+358 (50) 4871445</phone>
<email>Hannes.Tschofenig@gmx.net</email>
<uri>http://www.tschofenig.priv.at</uri>
</address>
</author>
<author initials="M." surname="Arumaithurai" fullname="Mayutan Arumaithurai">
<organization abbrev="University of Goettingen">University of Goettingen</organization>
<address>
<postal>
<street/>
<city> </city>
<region> </region>
<code> </code>
<country> </country>
</postal>
<email>mayutan.arumaithurai@gmail.com</email>
</address>
</author>
<author role="editor" initials="M." surname="Jones" fullname="Mark Jones">
<organization>Bridgewater Systems</organization>
<address>
<postal>
<street>303 Terry Fox Drive, Suite 500</street>
<city>Ottawa</city>
<region>Ontario</region>
<code>K2K 3J1</code>
<country>Canada</country>
</postal>
<phone>+1 613-591-6655</phone>
<email>mark.jones@bridgewatersystems.com</email>
</address>
</author>
<author initials="A" surname="Lior" fullname="Avi Lior">
<organization>Bridgewater Systems</organization>
<address>
<postal>
<street>303 Terry Fox Drive, Suite 500</street>
<city>Ottawa</city>
<region>Ontario</region>
<code>K2K 3J1</code>
<country>Canada</country>
</postal>
<phone>+1 613-591-6655</phone>
<email>avi@bridgewatersystems.com</email>
</address>
</author>
<date year="2009"/>
<area>Operations and Management</area>
<workgroup>Diameter Maintenance and Extensions (DIME)</workgroup>
<keyword>Internet-Draft</keyword>
<keyword>Diameter</keyword>
<keyword>QoS Attributes</keyword>
<abstract>
<t>This document extends the IPFilterRule AVP functionality of the Diameter Base protocol
and the functionality of the QoS-Filter-Rule AVP defined in RFC 4005. The ability to
convey Quality of Service information using the AVPs defined in this document is
available to existing and future Diameter applications where permitted by the command
ABNF.</t>
</abstract>
</front>
<!-- ====================================================================== -->
<middle>
<!-- ====================================================================== -->
<section anchor="introduction" title="Introduction">
<t>This document defines a number of Diameter Quality of Service (QoS) related AVPs that
can be used in existing and future Diameter applications where permitted by the ABNF of
a command. The IPFilterRule AVP, defined in RFC 3588 <xref target="RFC3588"/>, and the
QoS-Filter-Rule AVP, defined in RFC 4005 <xref target="RFC4005"/>, provide basic support
for classification and QoS already. The classification rule syntax is a modified subset
of FreeBSD ipfw packet filter implementation. The QoS functionality provided by the
IPFilterRule AVP was updated by the QoS-Filter-Rule AVP. The QoS-Rule AVP offers an
extended way of expressing classification and QoS capabilities. </t>
<t>The QoS-Resources AVP represents a complete rule set with each rule represented by a
QoS-Rule AVP. Each rule consists of a conditions part and the corresponding actions
to be performed if the conditions are satisfied. The AVPs responsible for expressing a
condition are defined in <xref target="conditions"/>. Capabilities to match all or a
subset of the data traffic is provided. Additionally, time-based conditions can be
expressed based on the functionality offered in <xref target="time-condition"/>. The
action part of a rule contains information for handling conflict resolution, such as a
priority value for each individual rule within a rule set, and further description
regarding QoS related actions.</t>
</section>
<!-- ====================================================================== -->
<section title="Terminology">
<t>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 <xref target="RFC2119"/>. </t>
</section>
<!-- ====================================================================== -->
<section title="Rule Sets and Rules">
<t>As mentioned in the introduction the top-level element is the QoS-Resources AVP that
encapsulates one or more QoS-Rule AVPs.</t>
<section title="QoS-Resources AVP">
<t> The QoS-Resources AVP (AVP Code TBD) is of type Grouped and describes a list of
policies. </t>
<t>
<figure>
<artwork><![CDATA[
QoS-Resources ::= < AVP Header: XXX >
1*{ QoS-Rule }
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<section title="QoS-Rule AVP">
<t>The QoS-Rule AVP (AVP Code TBD) is of type Grouped and defines a specific condition and
action combination.</t>
<t>
<figure>
<artwork><![CDATA[
QoS-Rule ::= < AVP Header: XXX >
[ QoS-Rule-Precedence ]
; Condition part of a Rule
; ------------------------
[ Classifier ]
* [ Time-Of-Day-Condition ]
; Action and Meta-Data
; --------------------
[ QoS-Action ]
; Info about QoS related Actions
; ------------------------------
[ QoS-Semantics ]
[ QoS-Profile-Template ]
[ QoS-Parameters ]
[ Excess-Treatment ]
; Extension Point
; ---------------
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>If the QoS-Profile-Template AVP is not included in the Qos-Rule AVP then the default
setting is assumed, namely a setting of the Vendor-Id AVP to 0 (for IETF) and the
QoS-Profile-Id AVP to zero (0) (for the profile defined in <xref
target="I-D.ietf-dime-qos-parameters"/>). Note that the content of the
QoS-Parameters are defined in the respective specification defining the QoS
parameters. When the Vendor-Id AVP is set to 0 (for IETF) and the QoS-Profile-Id AVP
is set to zero (0) then the AVPs included in the QoS-Parameters AVP are the AVPs
defined in <xref target="I-D.ietf-dime-qos-parameters"/>.</t>
</section>
<section title="QoS-Rule-Precedence AVP">
<t>The QoS-Rule-Precedence AVP (AVP Code TBD) is of type Unsigned32 and specifies the
execution order of the rules expressed in the QoS-Resources AVP. The lower the
numerical value of QoS-Rule-Precedence AVP, the higher the rule precedence.
Rules with equal precedence MAY be executed in parallel if supported by the
Resource Management Function. If the QoS-Rule-Precedence AVP is absent from the
QoS-Rule AVP, the rules SHOULD be executed in the order in which they appear in
the QoS-Resources AVP.</t>
</section>
</section>
<!-- ====================================================================== -->
<section anchor="conditions" title="Conditions">
<t>This section describes the condition part of a rule. Two condition types are introduced
by this document: packet classification conditions represented by the Classifier AVP and
time of day conditions represented by the Time-Of-Day-Condition AVP.</t>
<t>If more than one instance of the Time-Of-Day-Condition AVP is present in the QoS-Rule AVP,
the current time at QoS rule evaluation MUST be within at least one of the time windows
specified in one of the Time-Of-Day-Condition AVPs. </t>
<t>When the Time-Of-Day-Condition AVP and Classifier AVP are present in the same QoS-Rule AVP,
both the time of day and packet classification conditions MUST match for the QoS
specification action to be applied. </t>
<section anchor="classifier" title="Traffic Classifiers">
<t> Classifiers are used in many applications to specify how to select a subset of data
packets for subsequent treatment as indicated in the action part of a rule. For
example in a QoS application, if a packet matches a classifier then that packet will
be treated in accordance with a QoS specification associated with that classifier.
<xref target="classifier-arch"/> shows a typical deployment.</t>
<t>
<figure anchor="classifier-arch" title="Example of a Classifier Architecture">
<artwork><![CDATA[
+-----------+
+-----------+|
+--------+ +-------------+ +------------+||
| | IN | | | |||
| +--------->| +------------->| |||
|Managed | | Classifying | | Unmanaged |||
|Terminal| OUT | Entity | | Terminal |||
| |<---------+ |<-------------+ ||+
| | | | | |+
+--------+ +-------------+ +------------+
^
| Classifiers
|
+------+------+
| |
| AAA |
| |
+-------------+
]]></artwork>
</figure>
</t>
<t>The managed terminal, the terminal for which the classifiers are being specified is
located on the left of the Classifying Entity. The unmanaged terminals, the terminals
that receive packets from the Managed terminal or send packets to the managed
terminal are located to the right side of the Classifying Entity.</t>
<t>The Classifying Entity is responsible for classifying packets that are incoming (IN)
from the Managed Terminal or packets outgoing (OUT) to the Managed Terminal.</t>
<t>A Classifier consists of a group of attributes that specify how to match a packet.
Each set of attributes expresses values about aspects of the packet - typically the
packet header. Different protocols therefore would use different attributes.</t>
<t>In general a Classifier consists of the following:</t>
<t>
<list style="hanging">
<t hangText="Identifier:">
<vspace blankLines="1"/> The identifier uniquely identifies this classifier and
may be used to reference the classifier from another structure. <vspace
blankLines="1"/></t>
<t hangText="From:"><vspace blankLines="1"/> Specifies the rule for matching the
protocol specific source address(es) part of the packet. <vspace blankLines="1"
/></t>
<t hangText="To:"><vspace blankLines="1"/> Specifies the rule for matching the
protocol specific destination address(es) part of the packet. <vspace
blankLines="1"/></t>
<t hangText="Protocol:"><vspace blankLines="1"/> Specifies the matching protocol
of the packet. <vspace blankLines="1"/></t>
<t hangText="Direction:"><vspace blankLines="1"/> Specifies whether the classifier
is to apply to packets flowing from the Managed Terminal (IN) or to packets
flowing to the Managed Terminal (OUT), or packets flowing in both direction.
<vspace blankLines="1"/></t>
<t hangText="Options:"><vspace blankLines="1"/> Attributes or properties
associated with each protocol or layer, or various values specific to the
header of the protocol or layer. Options allow matching on those values.
<vspace blankLines="1"/></t>
</list>
</t>
<t>Each protocol type will have a specific set of attributes that can be used to specify
a classifier for that protocol. These attributes will be grouped under a grouped AVP
called a Classifier AVP.</t>
<section title="Classifier AVP">
<t>The Classifier AVP (AVP Code TBD) is a grouped AVP that consists of a set of
attributes that specify how to match a packet.</t>
<t>
<figure>
<artwork><![CDATA[
Classifier ::= < AVP Header: XXX >
{ Classifier-ID }
[ Protocol ]
[ Direction ]
* [ From-Spec ]
* [ To-Spec ]
* [ Diffserv-Code-Point ]
[ Fragmentation-Flag ]
* [ IP-Option ]
* [ TCP-Option ]
[ TCP-Flags ]
* [ ICMP-Type ]
* [ ETH-Option ]
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<!-- ====================================================================== -->
<section title="Classifier-ID AVP">
<t>The Classifier-ID AVP (AVP Code TBD) is of type OctetString and uniquely
identifies the classifier. Each application will define the uniqueness scope of
this identifier, e.g. unique per terminal or globally unique. Exactly one
Classifier-ID AVP MUST be contained within a Classifier AVP. </t>
</section>
<!-- ====================================================================== -->
<section title="Protocol AVP">
<t>The Protocol AVP (AVP Code TBD) is of type Enumerated and specifies the protocol
being matched. The attributes included in the Classifier AVP MUST be consistent
with the value of the Protocol AVP. Exactly zero or one Protocol AVP may be
contained within a Classifier AVP. If the Protocol AVP is omitted from the
Classifier, then comparison of the protocol of the packet is irrelevant. The
values for this AVP are managed by IANA under the Protocol Numbers registry
as defined in <xref target="RFC2780"/>. </t>
</section>
<!-- ====================================================================== -->
<section title="Direction AVP">
<t>The Direction AVP (AVP Code TBD) is of type Enumerated and specifies in which
direction to apply the Classifier. The values of the enumeration are:
"IN","OUT","BOTH". In the "IN" and "BOTH" directions, the From-Spec refers to the
address of the Managed Terminal and the To-Spec refers to the unmanaged terminal.
In the "OUT" direction, the From-Spec refers to the Unmanaged Terminal whereas the
To-Spec refers to the Managed Terminal. If the Direction AVP is omitted, the
Classifier matches packets flowing in both directions.</t>
<t>
<figure>
<artwork><![CDATA[
Value | Name and Semantic
------+--------------------------------------------------
0 | IN - The classifier applies to flows from the
| Managed Terminal.
1 | OUT - The classifier applies to flows to the
| Managed Terminal.
2 | BOTH - The classifier applies to flows both to
| and from the Managed Terminal.
]]></artwork>
</figure>
</t>
</section>
<!-- ====================================================================== -->
<section title="From-Spec AVP">
<t>The From-Spec AVP (AVP Code TBD) is a grouped AVP that specifies the Source
Specification used to match the packet. Zero or more of these AVPs may appear in
the Classifier. If this AVP is absent from the Classifier then all packets are
matched regardless of the source address. If more than one instance of this AVP
appears in the Classifier then the source of the packet can match any From-Spec
AVP. The contents of this AVP are protocol specific.</t>
<t>If one instance (or multiple instances) of the IP address AVP (IP-Address,
IP-Address-Range, IP-Address-Mask, Use-Assigned-Address) appear in the From-Spec
AVP then the source IP address of the packet MUST match one of the addresses
represented by these AVPs.</t>
<t>If more that one instance of the layer 2 address AVPs (MAC-Address,
MAC-Address-Mask, EUI64-Address, EUI64-Address-Mask) appears in the From-Spec then
the the source layer 2 address of the packet MUST match one of the addresses
represented in these AVPs.</t>
<t>If more that one instance of the port AVPs (Port, Port-Range) appears in the
From-Spec AVP then the source port number MUST match one of the port numbers
represented in these AVPs.</t>
<t>If the IP address, MAC address and port AVPs appear in the same From-Spec AVP then
the source packet MUST match all the specifications, i.e. match the IP address AND
MAC address AND port number.</t>
<t>
<figure>
<artwork><![CDATA[
From-Spec ::= < AVP Header: XXX >
* [ IP-Address ]
* [ IP-Address-Range ]
* [ IP-Address-Mask ]
* [ MAC-Address ]
* [ MAC-Address-Mask]
* [ EUI64-Address ]
* [ EUI64-Address-Mask]
* [ Port ]
* [ Port-Range ]
[ Negated ]
[ Use-Assigned-Address ]
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<!-- ====================================================================== -->
<section title="To-Spec AVP">
<t>The To-Spec AVP (AVP Code TBD) is a grouped AVP that specifies the Destination
Specification used to match the packet. Zero or more of these AVPs may appear in
the Classifier. If this AVP is absent from the Classifier then all packets are
matched regardless of the destination address. If more than one instance of this
AVP appears in the Classifier then the destination of the packet can match any
To-Spec AVP. The contents of this AVP are protocol specific.</t>
<t>If one instance (or multiple instances) of the IP address AVP (IP-Address,
IP-Address-Range, IP-Address-Mask, Use-Assigned-Address) appear in the To-Spec AVP
then the destination IP address of the packet MUST match one of the addresses
represented by these AVPs.</t>
<t>If more that one instance of the layer 2 address AVPs (MAC-Address,
MAC-Address-Mask, EUI64-Address, EUI64-Address-Mask) appears in the To-Spec then
the the destination layer 2 address of the packet MUST match one of the addresses
represented in these AVPs.</t>
<t>If more that one instance of the port AVPs (Port, Port-Range) appears in the
To-Spec AVP then the destination port number MUST match one of the port numbers
represented in these AVPs.</t>
<t>If the IP address, MAC address and port AVPs appear in the same To-Spec AVP then
the destination packet MUST match all the specifications, i.e. match the IP
address AND MAC address AND port number.</t>
<t>
<figure>
<artwork><![CDATA[
To-Spec ::= < AVP Header: XXX >
* [ IP-Address ]
* [ IP-Address-Range ]
* [ IP-Address-Mask ]
* [ MAC-Address ]
* [ MAC-Address-Mask]
* [ EUI64-Address ]
* [ EUI64-Address-Mask]
* [ Port ]
* [ Port-Range ]
[ Negated ]
[ Use-Assigned-Address ]
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<!-- ====================================================================== -->
<section title="Source and Destination AVPs">
<t>For packet classification the contents of the From-Spec and To-Spec can contain
the AVPs listed in the subsections below.</t>
<section title="Negated AVP">
<t>The Negated AVP (AVP Code TBD) of type Enumerated containing the values of True
or False. Exactly zero or one of these AVPs may appear in the From-Spec or
To-Spec AVP.</t>
<t>When set to True the meaning of the match is inverted. Addresses other than
those in the To-Spec and From-Spec are to be matched instead. When set to
False, or when the AVP is not included then the address specified To-Spec and
From-Spec AVP are to be matched.</t>
<t>Note that the negation does not impact the port comparisons.</t>
<t>
<figure>
<artwork><![CDATA[
Value | Name
------+--------
0 | False
1 | True
]]></artwork>
</figure>
</t>
</section>
<!-- ====================================================================== -->
<section title="IP-Address AVP">
<t>The IP-Address AVP (AVP Code TBD) is of type Address and specifies a single IP
address (IPv4 or IPv6) address to match.</t>
</section>
<section title="IP-Address-Range AVP">
<t>The IP-Address-Range AVP (AVP Code TBD) is of type Grouped and specifies an
inclusive IP address range.</t>
<t>
<figure>
<artwork><![CDATA[
IP-Address-Range ::= < AVP Header: XXX >
[ IP-Address-Start ]
[ IP-Address-End ]
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>If the IP-Address-Start AVP is not included then the address range starts from
the first valid IP address up to and including the specified IP-Address-End
address.</t>
<t>If the IP-Address-End AVP is not included then the address range starts at the
address specified by the IP-Address-Start AVP and includes all the remaining
valid IP addresses.</t>
<t>For the IP-Address-Range AVP to be valid, the IP-Address-Start AVP MUST contain
a value that is less than that of the IP-Address-End AVP. </t>
</section>
<section title="IP-Address-Start AVP">
<t>The IP-Address-Start AVP (AVP Code TBD) is of type Address and specifies the
first IP address (IPv4 or IPv6) address of an IP address range. </t>
</section>
<section title="IP-Address-End AVP">
<t>The IP-Address-End AVP (AVP Code TBD) is of type Address and specifies the last
IP address (IPv4 or IPv6) address of an address range. </t>
</section>
<section title="IP-Address-Mask AVP">
<t>The IP-Address-Mask AVP (AVP Code TBD) is of type Grouped and specifies an IP
address range using a base IP address and the bit-width of the mask. For
example, a range expressed as 192.0.2.0/24 will match all IP addresses from
192.0.2.0 up to and including 192.0.2.255. The bit-width MUST be valid for the type
of IP address.</t>
<t>
<figure>
<artwork><![CDATA[
IP-Address-Mask ::= < AVP Header: XXX >
{ IP-Address }
{ IP-Bit-Mask-Width }
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<section title="IP-Mask-Bit-Mask-Width AVP">
<t>The IP-Bit-Mask-Width AVP (AVP Code TBD) is of type Unsigned32.
The value specifies the width of an IP address bit-mask.</t>
</section>
<section title="MAC-Address AVP">
<t>The MAC-Address AVP (AVP Code TBD) is of type OctetString and specifies a
single layer 2 address in MAC-48 format. The value is a 6 octets encoding of
the address as it would appear in the frame header.</t>
</section>
<section title="MAC-Address-Mask AVP">
<t>The MAC-Address-Mask AVP (AVP Code TBD) is of type Grouped and specifies a set
of MAC addresses using a bit mask to indicate the bits of the MAC addresses
which must fit to the specified MAC address attribute. For example, a
MAC-Address-Mask with the MAC-Address as 00-10-A4-23-00-00 and with a
MAC-Address-Mask-Pattern of FF-FF-FF-FF-00-00 will match all MAC addresses from
00-10-A4-23-00-00 up to and including 00-10-A4-23-FF-FF. </t>
<t>
<figure>
<artwork><![CDATA[MAC-Address-Mask ::= < AVP Header: XXX >
{ MAC-Address }
{ MAC-Address-Mask-Pattern }
* [ AVP ]]]></artwork>
</figure>
</t>
</section>
<section title="MAC-Address-Mask-Pattern AVP">
<t>The MAC-Address-Mask-Pattern AVP (AVP Code TBD) is of type OctetString. The
value is a 6 octets specifying the bit positions of a MAC address, that are
taken for matching.</t>
</section>
<section title="EUI64-Address AVP">
<t>The EUI64-Address AVP (AVP Code TBD) is of type OctetString and specifies a
single layer 2 address in EUI-64 format. The value is a 8 octets encoding of
the address as it would appear in the frame header.</t>
</section>
<section title="EUI64-Address-Mask AVP">
<t>The EUI64-Address-Mask AVP (AVP Code TBD) is of type Grouped and specifies a
set of EUI64 addresses using a bit mask to indicate the bits of the EUI64
addresses which must fit to the specified EUI64 address attribute. For example,
a EUI64-Address-Mask with the EUI64-Address as 00-10-A4-FF-FE-23-00-00 and with
a EUI64-Address-Mask-Pattern of FF-FF-FF-FF-FF-FF-00-00 will match all EUI64
addresses from 00-10-A4-FF-FE-23-00-00 up to and including
00-10-A4-FF-FE-23-FF-FF. </t>
<t>
<figure>
<artwork><![CDATA[EUI64-Address-Mask ::= < AVP Header: XXX >
{ EUI64-Address }
{ EUI64-Address-Mask-Pattern }
* [ AVP ]]]></artwork>
</figure>
</t>
</section>
<section title="EUI64-Address-Mask-Pattern AVP">
<t>The EUI64-Address-Mask-Pattern AVP (AVP Code TBD) is of type OctetString. The
value is a 8 octets specifying the bit positions of a EUI64 address, that are
taken for matching.</t>
</section>
<section title="Port AVP">
<t>The Port AVP (AVP Code TBD) is of type Integer32 in the range of 0 to 65535 and
specifies port numbers to match. </t>
</section>
<section title="Port-Range AVP">
<t>The Port-Range AVP (AVP Code TBD) is of type Grouped and specifies an inclusive
range of ports.</t>
<t>
<figure>
<artwork><![CDATA[
Port-Range ::= < AVP Header: XXX >
[ Port-Start ]
[ Port-End ]
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>If the Port-Start AVP is omitted then port 0 is assumed. If the Port-End AVP is
omitted then port 65535 is assumed.</t>
</section>
<section title="Port-Start AVP">
<t>The Port-Start AVP (AVP Code TBD) is of type Integer32 and specifies the first
port number of an IP port range. </t>
</section>
<section title="Port-End AVP">
<t>The Port-End AVP (AVP Code TBD) is of type Integer32 and specifies the last
port number of an IP port range. </t>
</section>
<section title="Use-Assigned-Address AVP">
<t>In some scenarios, the AAA does not know the IP address assigned to the Managed
Terminal at the time that the Classifier is sent to the Classifying Entity. The
Use-Assigned-Address AVP (AVP Code TBD) is of type Enumerated containing the
values of True or False. When present and set to True, it represents the IP
address assigned to the Managed Terminal.</t>
<t>
<figure>
<artwork><![CDATA[
Value | Name
------+--------
0 | False
1 | True
]]></artwork>
</figure>
</t>
</section>
</section>
<!-- ====================================================================== -->
<section title="Header Option AVPs">
<t>The Classifier AVP may contain one or more of the following AVPs to match on the
various possible IP, TCP or ICMP header options.</t>
<section title="Diffserv-Code-Point AVP">
<t>The Diffserv-Code-Point AVP (AVP Code TBD) is of type Enumerated and specifies
the Differentiated Services Field Codepoints to match in the IP header. The
values are managed by IANA under the Differentiated Services Field Codepoints
registry as defined in <xref target="RFC2474"/>.</t>
</section>
<section title="Fragmentation-Flag AVP">
<t>The Fragmentation-Flag AVP (AVP Code TBD) is of type Enumerated and specifies
the packet fragmentation flags to match in the IP header.</t>
<t>
<figure>
<artwork><![CDATA[
Value | Name and Semantic
------+------------------------------------------------------------
0 | Don't Fragment (DF)
1 | More Fragments (MF)
]]></artwork>
</figure>
</t>
</section>
<section title="IP-Option AVP">
<t>The IP-Option AVP (AVP Code TBD) is of type Grouped and specifies an IP header
option that must be matched.</t>
<t>
<figure>
<artwork><![CDATA[
IP-Option ::= < AVP Header: XXX >
{ IP-Option-Type }
* [ IP-Option-Value ]
[ Negated ]
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>If one or more IP-Option-Value AVPs are present, one of the values MUST match
the value in the IP header option. If the IP-Option-Value AVP is absent, the
option type MUST be present in the IP header but the value is wild carded. </t>
<t>The Negated AVP is used in conjunction with the IP-Option-Value AVPs to specify
IP header options which do not match specific values. The Negated AVP is used
without the IP-Option-Value AVP to specify IP headers which do not contain the
option type.</t>
</section>
<section title="IP-Option-Type AVP">
<t>The IP-Option-Type AVP (AVP Code TBD) is of type Enumerated and the values are
managed by IANA under the IP Option Numbers registry as defined in
<xref target="RFC2780"/>. </t>
</section>
<section title="IP-Option-Value AVP">
<t>The IP-Option-Value AVP (AVP Code TBD) is of type OctetString and contains the
option value that must be matched.</t>
</section>
<section title="TCP-Option AVP">
<t>The TCP-Option AVP (AVP Code TBD) is of type Grouped and specifies a TCP header
option that must be matched.</t>
<t>
<figure>
<artwork><![CDATA[
TCP-Option ::= < AVP Header: XXX >
{ TCP-Option-Type }
* [ TCP-Option-Value ]
[ Negated ]
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>If one or more TCP-Option-Value AVPs are present, one of the values MUST match
the value in the TCP header option. If the TCP-Option-Value AVP is absent, the
option type MUST be present in the TCP header but the value is wild carded. </t>
<t>The Negated AVP is used in conjunction which the TCP-Option-Value AVPs to
specify TCP header options which do not match specific values. The Negated AVP
is used without the TCP-Option-Value AVP to specify TCP headers which do not
contain the option type.</t>
</section>
<section title="TCP-Option-Type AVP">
<t>The TCP-Option-Type AVP (AVP Code TBD) is of type Enumerated and the values are
managed by IANA under the TCP Option Numbers registry as defined in
<xref target="RFC2780"/>. </t>
</section>
<section title="TCP-Option-Value AVP">
<t>The TCP-Option-Value AVP (AVP Code TBD) is of type OctetString and contains the
option value that must be matched.</t>
</section>
<section title="TCP-Flags AVP">
<t>The TCP-Flags AVP (AVP Code TBD) is of type Grouped and specifies a set of TCP
control flags that must be matched.</t>
<t>
<figure>
<artwork><![CDATA[
TCP-Flags ::= < AVP Header: XXX >
1* { TCP-Flag-Type }
[ Negated ]
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>If the Negated AVP is not present or present but set to False, the
TCP-Flag-Type AVPs specifies which flags MUST be set. If the Negated AVP is set
to True, the TCP-Flag-Type AVPs specifies which flags MUST be cleared. </t>
</section>
<section title="TCP-Flag-Type AVP">
<t>The TCP-Flag-Type AVP (AVP Code TBD) is of type Enumerated and specifies a TCP
control flag type that must be matched.</t>
<t>
<figure>
<artwork><![CDATA[
Value | Name and Semantic
------+-------------------------------------------
0 | CWR - Congestion Window Reduced.
1 | ECE - ECN-Echo. TCP peer is ECN capable.
2 | URG - URGent pointer field is significant.
3 | ACK - ACKnowledgment field is significant.
4 | PSH - Push function.
5 | RST - Reset the connection.
6 | SYN - Synchronize sequence numbers.
7 | FIN - No more data from sender.
]]></artwork>
</figure>
</t>
</section>
<section title="ICMP-Type">
<t>The ICMP-Type AVP (AVP Code TBD) is of type Grouped and specifies a ICMP
message type that must be matched.</t>
<t>
<figure>
<artwork><![CDATA[
ICMP-Type ::= < AVP Header: XXX >
{ ICMP-Type-Number }
* [ ICMP-Code ]
[ Negated ]
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>If the ICMP-Code AVP is present, the value MUST match that in the ICMP header.
If the ICMP-Code AVP is absent, the ICMP type MUST be present in the ICMP
header but the code is wild carded. </t>
<t>The Negated AVP is used in conjunction with the ICMP-Code AVPs to specify ICMP
codes that do not match specific values. The Negated AVP is used without the
ICMP-Code AVP to specify ICMP headers which do not contain the ICMP type. As
such, the Negated AVP feature applies to ICMP-Code AVP if the ICMP-Code AVP is
present. If the ICMP-Code AVP is absent, the Negated AVP feature applies to the
ICMP-Type-Number.</t>
</section>
<section title="ICMP-Type-Number AVP">
<t>The ICMP-Type-Number AVP (AVP Code TBD) is of type Enumerated and the values
are managed by IANA under the ICMP Type Numbers registry as defined in
<xref target="RFC2780"/>.</t>
</section>
<section title="ICMP-Code AVP">
<t>The ICMP-Code AVP (AVP Code TBD) is of type Enumerated and the values are
managed by IANA under the ICMP Type Numbers registry as defined in
<xref target="RFC2780"/>.</t>
</section>
<section title="ETH-Option AVP">
<t>The ETH-Option AVP (AVP Code TBD) is of type Grouped and specifies Ethernet
specific attributes.</t>
<t>
<figure>
<artwork><![CDATA[
ETH-Option ::= < AVP Header: XXX >
{ ETH-Proto-Type }
* [ VLAN-ID-Range ]
* [ User-Priority-Range ]
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<section title="ETH-Proto-Type AVP">
<t>The Eth-Proto-Type AVP (AVP Code TBD) is of type Grouped and specifies the
encapsulated protocol type. ETH-Ether-Type and ETH-SAP are mutually exclusive.</t>
<t>
<figure>
<artwork><![CDATA[
ETH-Proto-Type ::= < AVP Header: XXX >
* [ ETH-Ether-Type ]
* [ ETH-SAP ]
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<section title="ETH-Ether-Type AVP">
<t>The ETH-Ether-Type AVP (AVP Code TBD) is of type OctetString. The value is a
double octet that contains the value of the Ethertype field in the packet to
match. This AVP MAY be present in the case of DIX or if SNAP is present at
802.2 but the ETH-SAP AVP MUST NOT be present in this case.</t>
</section>
<section title="ETH-SAP AVP">
<t>The ETH-SAP AVP (AVP Code TBD) is of type OctetString. The value is a double
octet representing the 802.2 SAP as specified in <xref target="IEEE802.2"/>.
The first octet contains the DSAP and the second the SSAP.</t>
</section>
<section title="VLAN-ID-Range AVP">
<t>The VLAN-ID-Range AVP (AVP Code TBD) is of type Grouped and specifies the VLAN
range to match. VLAN identities are either specified by a single VLAN-ID
according to <xref target="IEEE802.1Q"/> or by a combination of Customer and
Service VLAN-IDs according to <xref target="IEEE802.1ad"/>.</t>
<t>The single VLAN-ID is represented by the C-VID-Start and C-VID-End AVPs and the
S-VID-Start and S-VID-End AVPs SHALL be ommitted in this case. If the
VLAN-ID-Range AVP is omitted from the Classifier, then comparison of the VLAN
identity of the packet is irrelevant.</t>
<t>
<figure>
<artwork><![CDATA[
VLAN-ID-Range ::= < AVP Header: XXX >
[ S-VID-Start ]
[ S-VID-End ]
[ C-VID-Start ]
[ C-VID-End ]
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>The following is the list of possible combinations of the S-VID-Start and S-VID-End AVPs
and their inference: </t>
<t>
<list style="symbols">
<t>If S-VID-Start AVP is present but the S-VID-End AVP is absent,
the S-VID-Start AVP value MUST equal the value of the IEEE 802.1ad
S-VID bits specified in <xref target="IEEE802.1ad"/> for a successful match.</t>
<t>If S-VID-Start AVP is absent but the S-VID-End AVP is present,
the S-VID-End AVP value MUST equal the value of the IEEE 802.1ad S-VID bits for a successful match.</t>
<t>If both S-VID-Start and S-VID-End AVPs are present and their values are equal,
the S-VID-Start AVP value MUST equal the value of the IEEE 802.1ad
S-VID bits for a successful match.</t>
<t>If both S-VID-Start and S-VID-End AVPs are present and the value of
S-VID-End AVP is greater than the value of the S-VID-Start AVP, the
value of the IEEE 802.1ad S-VID bits MUST be greater than or equal to the S-VID-
Start AVP value and less than or equal to the S-VID-End AVP value for
a successful match. If the S-VID-Start and S-VID-End AVPs are specified,
then Ethernet packets without IEEE 802.1ad encapsulation MUST NOT
match this Classifier. </t>
<t>If the S-VID-Start and S-VID-End AVPs are omitted, then existence
of IEEE802.1ad encapsulation or comparison of the IEEE 802.1ad S-VID
bits is irrelevant for this Classifier.</t>
</list>
</t>
<t>The following is the list of possible combinations of the C-VID-Start and C-VID-End AVPs
and their inference: </t>
<t>
<list style="symbols">
<t>If C-VID-Start AVP is present but the C-VID-End AVP is absent,
the C-VID-Start AVP value MUST equal the value of the IEEE 802.1ad
C-VID bits specified in <xref target="IEEE802.1ad"/> or the IEEE 802.1Q VLAN-ID bits
specified in <xref target="IEEE802.1Q"/> for a successful match.</t>
<t>If C-VID-Start AVP is absent but the C-VID-End AVP is present,
the C-VID-End AVP value MUST equal the value of the IEEE 802.1ad
C-VID bits or the IEEE 802.1Q VLAN-ID bits for a successful match.</t>
<t>If both C-VID-Start and C-VID-End AVPs are present and their values are equal,
the C-VID-Start AVP value MUST equal the value of the IEEE 802.1ad
C-VID bits or the IEEE 802.1Q VLAN-ID bits for a successful match.</t>
<t>If both C-VID-Start and C-VID-End AVPs are present and the value of
C-VID-End AVP is greater than the value of the C-VID-Start AVP, the
value of the IEEE 802.1ad C-VID bits or the IEEE 802.1Q VLAN-ID bits
MUST be greater than or equal to the C-VID-Start AVP value and less
than or equal to the C-VID-End AVP value for a successful match. If
the C-VID-Start and C-VID-End AVPs are specified, then Ethernet packets
without IEEE 802.1ad or IEEE 802.1Q encapsulation MUST NOT
match this Classifier. </t>
<t>If the C-VID-Start and C-VID-End AVPs are omitted, the comparison of
the IEEE 802.1ad C-VID bits or IEEE 802.1Q VLAN-ID bits for this Classifier is irrelevant.</t>
</list>
</t>
</section>
<section title="S-VID-Start AVP">
<t>The S-VID-Start AVP (AVP Code TBD) is of type Unsigned32. The value MUST be in
the range from 0 to 4095. The value of this AVP specifies the start value of
the range of S-VID VLAN-IDs to be matched.</t>
</section>
<section title="S-VID-End AVP">
<t>The S-VID-End AVP (AVP Code TBD) is of type Unsigned32. The value MUST be in
the range from 0 to 4095. The value of this AVP specifies the end value of the
range of S-VID VLAN-IDs to be matched.</t>
</section>
<section title="C-VID-Start AVP">
<t>The C-VID-Start AVP (AVP Code TBD) is of type Unsigned32. The value MUST be in
the range from 0 to 4095. The value of this AVP specifies the start value of
the range of C-VID VLAN-IDs to be matched.</t>
</section>
<section title="C-VID-End AVP">
<t>The C-VID-End AVP (AVP Code TBD) is of type Unsigned32. The value MUST be in
the range from 0 to 4095. The value of this AVP specifies the end value of the
range of C-VID VLAN-IDs to be matched.</t>
</section>
<section title="User-Priority-Range AVP">
<t>The User-Priority-Range AVP (AVP Code TBD) is of type Grouped and specifies an
inclusive range to match the user_priority parameter specified in <xref
target="IEEE802.1D"/>. An Ethernet packet containing the user_priority
parameter matches this Classifier if the value is greater than or equal to
Low-User-Priority and less than or equal to High-User-Priority. If this AVP is
omitted, then comparison of the IEEE 802.1D user_priority parameter for this
Classifier is irrelevant.</t>
<t>
<figure>
<artwork><![CDATA[
User-Priority-Range ::= < AVP Header: XXX >
* [ Low-User-Priority ]
* [ High-User-Priority ]
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<section title="Low-User-Priority AVP">
<t>The Low-User-Priority AVP (AVP Code TBD) is of type Unsigned32. The value MUST
be in the range from 0 to 7.</t>
</section>
<section title="High-User-Priority AVP">
<t>The High-User-Priority AVP (AVP Code TBD) is of type Unsigned32. The value MUST
be in the range from 0 to 7.</t>
</section>
</section>
</section>
<!-- =================================================================================== -->
<section anchor="time-condition" title="Time Of Day AVPs">
<t>In many QoS applications, the QoS specification applied to the traffic flow is
conditional upon the time of day when the flow was observed. The following sections
define AVPs that can be used to express one or more time windows which determine when
a QoS specification is applicable to a traffic flow.</t>
<section title="Time-Of-Day-Condition AVP">
<t>The Time-Of-Day-Condition AVP (AVP Code TBD) is of type Grouped and specifies one
or more time windows.</t>
<t>
<figure>
<artwork><![CDATA[
Time-Of-Day-Condition ::= < AVP Header: XXX >
[ Time-Of-Day-Start ]
[ Time-Of-Day-End ]
[ Day-Of-Week-Mask ]
[ Day-Of-Month-Mask ]
[ Month-Of-Year-Mask ]
[ Absolute-Start-Time ]
[ Absolute-End-Time ]
[ Timezone-Flag ]
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>For example, a time window for 9am to 5pm (local time) from Monday to Friday would
be expressed as: <figure>
<artwork><![CDATA[
Time-Of-Day-Condition = {
Time-Of-Day-Start = 32400;
Time-Of-Day-End = 61200;
Day-Of-Week-Mask =
( MONDAY | TUESDAY | WEDNESDAY | THURSDAY | FRIDAY );
Timezone-Flag = LOCAL;
}
]]></artwork>
</figure>
</t>
</section>
<section title="Time-Of-Day-Start AVP">
<t>The Time-Of-Day-Start AVP (AVP Code TBD) is of type Unsigned32. The value MUST be
in the range from 0 to 86400. The value of this AVP specifies the start of an
inclusive time window expressed as the offset in seconds from midnight. If this
AVP is absent from the Time-Of-Day-Condition AVP, the time window starts at
midnight.</t>
</section>
<section title="Time-Of-Day-End AVP">
<t>The Time-Of-Day-End AVP (AVP Code TBD) is of type Unsigned32. The value MUST be in
the range from 1 to 86400. The value of this AVP specifies the end of an inclusive
time window expressed as the offset in seconds from midnight. If this AVP is
absent from the Time-Of-Day-Condition AVP, the time window ends one second before
midnight.</t>
</section>
<section title="Day-Of-Week-Mask AVP">
<t>The Day-Of-Week-Mask AVP (AVP Code TBD) is of type Unsigned32. The value is a
bitmask which specifies the day of the week for the time window to match. This
document specifies the following bits: <figure>
<artwork><![CDATA[
Bit | Name
------+------------
0 | SUNDAY
1 | MONDAY
2 | TUESDAY
3 | WEDNESDAY
4 | THURSDAY
5 | FRIDAY
6 | SATURDAY
]]></artwork>
</figure>
</t>
<t>The bit MUST be set for the time window to match on the corresponding day of the
week. Bit 0 is the most significant bit and unused bits MUST be cleared. If this
AVP is absent from the Time-Of-Day-Condition AVP, the time windows match on all
days of the week.</t>
</section>
<section title="Day-Of-Month-Mask AVP">
<t>The Day-Of-Week-Month AVP (AVP Code TBD) is of type Unsigned32. The value MUST be
in the range from 0 to 2147483647. The value is a bitmask which specifies the days
of the month where bit 0 represents the first day of the month through to bit 30
which represents the last day of the month. The bit MUST be set for the time
window to match on the corresponding day of the month. Bit 0 is the most
significant bit and unused bits MUST be cleared. If this AVP is absent from the
Time-Of-Day-Condition AVP, the time windows match on all days of the month.</t>
</section>
<section title="Month-Of-Year-Mask AVP">
<t>The Month-Of-Year-Month AVP (AVP Code TBD) is of type Unsigned32. The value is a
bitmask which specifies the months of the year for the time window to match. This
document specifies the following bits: <figure>
<artwork><![CDATA[
Bit | Name
------+-----------
0 | JANUARY
1 | FEBRUARY
2 | MARCH
3 | APRIL
4 | MAY
5 | JUNE
6 | JULY
7 | AUGUST
8 | SEPTEMBER
9 | OCTOBER
10 | NOVEMBER
11 | DECEMBER
]]></artwork>
</figure>
</t>
<t>The bit MUST be set for the time window to match on the corresponding month of the
year. Bit 0 is the most significant bit and unused bits MUST be cleared. If this
AVP is absent from the Time-Of-Day-Condition AVP, the time windows match during
all months of the year.</t>
</section>
<section title="Absolute-Start-Time AVP">
<t>The Absolute-Start-Time AVP (AVP Code TBD) is of type Time. The value of this AVP
specifies the time in seconds since January 1, 1900, 00:00 UTC when the time
window starts. If this AVP is absent from the Time-Of-Day-Condition AVP, the time
window starts on January 1, 1900, 00:00 UTC.</t>
</section>
<section title="Absolute-End-Time AVP">
<t>The Time-Of-Day-End AVP (AVP Code TBD) is of type Time. The value of this AVP
specifies the time in seconds since January 1, 1900, 00:00 UTC when the time
window ends. If this AVP is absent from the Time-Of-Day-Condition AVP, the time
window is open-ended.</t>
</section>
<section title="Timezone-Flag AVP">
<t>The Timezone-Flag AVP (AVP Code TBD) is of type Enumerated and indicates whether
the time windows are specified in UTC, local time at the managed terminal or as an
offset from UTC. If this AVP is absent from the Time-Of-Day-Condition AVP, the
time windows are in UTC.</t>
<t>This document defines the following values: <figure>
<artwork><![CDATA[
Value | Name and Semantic
------+--------------------------------------------------
0 | UTC - The time windows are expressed in UTC.
1 | LOCAL - The time windows are expressed in local
| time at the Managed Terminal.
2 | OFFSET - The time windows are expressed as an
| offset from UTC (see Timezone-Offset AVP).
]]></artwork>
</figure>
</t>
</section>
<section title="Timezone-Offset AVP">
<t>The Timezone-Offset AVP (AVP Code TBD) is of type Integer32. The value of this AVP
MUST be in the range from -43200 to 43200. It specifies the offset in seconds from
UTC that was used to express Time-Of-Day-Start, Time-Of-Day-End, Day-Of-Week-Mask,
Day-Of-Month-Mask and Month-Of-Year-Mask AVPs. This AVP MUST be present if the
Timezone-Flag AVP is set to OFFSET.</t>
</section>
</section>
</section>
<!-- =================================================================================== -->
<section title="Actions">
<t>This section illustrates the actions associated with a rule. This document only defines
QoS specific actions but further actions can be specified as extensions. </t>
<section title="QoS-Action AVP">
<t>The QoS-Action AVP (AVP Code TBD) is of type Enumerated and lists the actions that are
associated with the condition part of a rule. The following actions are defined in
this document:</t>
<t>
<figure>
<artwork><![CDATA[
0: drop
1: shape
2: mark
]]></artwork>
</figure>
</t>
<t>
<list style="hanging">
<t hangText="drop:"><vspace blankLines="1"/>All traffic that is met by the
condition part of a rule MUST be dropped. This action implements firewalling
functionality.<vspace blankLines="1"/></t>
<t hangText="shape:"><vspace blankLines="1"/>
<xref target="RFC2475"/> describes shaping as "the process of delaying packets
within a traffic stream to cause it to conform to some defined traffic
profile". When the action is set to 'shape', it is expected that the
QoS-Parameters AVP carries QoS information to indicate how to shape the traffic
indicated in the condition part of the rule. <vspace blankLines="1"/>
</t>
<t hangText="mark:"><vspace blankLines="1"/>
<xref target="RFC2475"/> describes marking as "the process of setting the DS
codepoint in a packet based on defined rules". When the action is set to 'mark',
it is expected that the QoS-Parameters AVP carries information about the
DiffServ marking.<vspace blankLines="1"/>
</t>
</list>
</t>
<t>Further action values can be registered, as described in <xref target="action-reg"/>.
</t>
<t><xref target="RFC2475"/> also describes an action called "policing" as "the process
of discarding packets (by a dropper) within a traffic stream in accordance with the
state of a corresponding meter enforcing a traffic profile". This behavior in modeled
in the QoS-Rule through the inclusion of the Excess-Treatment AVP containing a
QoS-Action AVP set to "drop".
</t>
</section>
<section title="QoS-Profile-Id AVP" anchor="qos-profile">
<t>The QoS-Profile-Id AVP (AVP Code TBD) is of type Unsigned32 and contains a QoS
profile template identifier. An initial QoS profile template is defined with value of
0 and can be found in <xref target="I-D.ietf-dime-qos-parameters"/>. The registry for
the QoS profile templates is created with the same document. </t>
</section>
<section title="QoS-Profile-Template AVP" anchor="vendor-qos-profile">
<t>The QoS-Profile-Template AVP (AVP Code TBD) is of type Grouped and defines the
namespace of the QoS profile (indicated in the Vendor-ID AVP) followed by the
specific value for the profile. </t>
<t>The Vendor-Id AVP contains a 32 bit IANA Private Enterprise Number (PEN)
and the QoS-Profile-Id AVP contains the template identifier assigned by the
vendor. The vendor identifier of zero (0) is used for the IETF.</t>
<t>
<figure>
<artwork><![CDATA[
QoS-Profile-Template ::= < AVP Header: XXX >
{ Vendor-Id }
{ QoS-Profile-Id }
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<section title="QoS-Semantics">
<t>The QoS-Semantics AVP (AVP Code TBD) is of type Enumerated and provides the semantics
for the QoS-Profile-Template and QoS-Parameters AVPs in the QoS-Rule AVP. </t>
<t>This document defines the following values: <figure>
<artwork><![CDATA[
(0): QoS-Desired
(1): QoS-Available
(2): QoS-Reserved
(3): Minimum-QoS
(4): QoS-Authorized
]]></artwork>
</figure>
</t>
<t>The semantic of the QoS parameters depend on the information provided in the list
above. The semantics of the different values are as follows:</t>
<t>
<figure>
<artwork><![CDATA[
Object Type Direction Semantic
---------------------------------------------------------------------
QoS-Desired C->S Please authorize the indicated QoS
QoS-Desired C<-S NA
QoS-Available C->S Admission Control at interface indicates
that this QoS is available. (note 1)
QoS-Available C<-S Indicated QoS is available. (note 2)
QoS-Reserved C->S Used for reporting during accounting.
QoS-Reserved C<-S NA
Minimum-QoS C->S Indicates that the client is not
interested in authorizing QoS that is
lower than Min. QoS.
Minimum-QoS C<-S The client must not provide QoS
guarantees lower than Min. QoS.
QoS-Authorized C->S NA
QoS-Authorized C<-S Indicated QoS authorized
Legend:
C: Diameter client
S: Diameter server
NA: Not applicable to this document;
no semantic defined in this specification
Notes:
(1) QoS-Available is only useful in relationship with QoS-Desired
(and optionally with Minimum-QoS).
(2) QoS-Available is only useful when the AAA server performs
admission control and knows about the resources in the network.
]]></artwork>
</figure>
</t>
</section>
<section title="QoS-Parameters AVP">
<t> The QoS-Parameters AVP (AVP Code TBD) is of type grouped and contains Quality of
Service parameters. These parameters are defined in separate documents and depend on
the indicated QoS profile template of the QoS-Profile-Template AVP. For an initial
QoS parameter specification see <xref target="I-D.ietf-dime-qos-parameters"/>. </t>
<t>
<figure>
<artwork><![CDATA[
QoS-Parameters ::= < AVP Header: XXX >
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
<section title="Excess-Treatment AVP">
<t> The Excess-Treatment AVP (AVP Code TBD) is of type grouped and indicates how
out-of-profile traffic, i.e. traffic not covered by the original QoS-Profile-Template
and QoS-Parameters AVPs, is treated. The additional QoS-Action, QoS-Profile-Template
and QoS-Parameters AVPs carried inside the Excess-Treatment AVP provide information
about the QoS treatment of the excess traffic. In case the Excess-Treatment AVP is
absent then the treatment of the out-of-profile traffic is left to the discretion of
the node performing QoS treatment.</t>
<t>
<figure>
<artwork><![CDATA[
Excess-Treatment ::= < AVP Header: XXX >
{ QoS-Action }
[ QoS-Profile-Template ]
[ QoS-Parameters ]
* [ AVP ]
]]></artwork>
</figure>
</t>
</section>
</section>
<!-- =================================================================================== -->
<section title="QoS Capability Indication" anchor="capability">
<t>The QoS-Capability AVP (AVP Code TBD) is of type Grouped and contains a list of
supported Quality of Service profile templates (and therefore the support of the
respective parameter AVPs). </t>
<t>The QoS-Capability AVP may be used for a simple announcement of the QoS capabilities and
QoS profiles supported by a peer. It may also be used to negotiate a mutually supported
set of QoS capabilities and QoS profiles between two peers. In such a case, handling of
failed negotiations is application and/or deployment specific.</t>
<t>
<figure>
<artwork><![CDATA[
QoS-Capability ::= < AVP Header: XXX >
1*{ QoS-Profile-Template }
* [ AVP ]
]]></artwork>
</figure>
</t>
<t>The QoS-Profile-Template AVP is defined in <xref target="vendor-qos-profile"/>.</t>
</section>
<!-- =================================================================================== -->
<section title="Examples">
<t>This section shows a number of signaling flows where QoS negotiation and authorization
is part of the conventional NASREQ, EAP or Credit Control applications message
exchanges. The signalling flows for the Diameter QoS Application are described in <xref
target="I-D.ietf-dime-diameter-qos"/>.</t>
<section title="Diameter EAP with QoS Information">
<t><xref target="diameter-eap-message-flow"/> shows a simple signaling flow where a NAS
(Diameter Client) announces its QoS awareness and capabilities included into the DER
message and as part of the access authentication procedure. Upon completion of the
EAP exchange, the Diameter Server provides a pre-provisioned QoS profile with the
QoS-Semantics in the QoS-Rule AVP set to "QoS-Authorized", to the NAS in the final DEA
message. <figure title="Example of a Diameter EAP enhanced with QoS Information"
anchor="diameter-eap-message-flow">
<artwork><![CDATA[
End Diameter Diameter
Host Client Server
| | |
| (initiate EAP) | |
|<----------------------------->| |
| | Diameter-EAP-Request |
| | EAP-Payload(EAP Start) |
| | QoS-Capability |
| |------------------------------->|
| | |
| | Diameter-EAP-Answer |
| Result-Code=DIAMETER_MULTI_ROUND_AUTH |
| | EAP-Payload(EAP Request #1) |
| |<-------------------------------|
| EAP Request(Identity) | |
|<------------------------------| |
: : :
: <<<more message exchanges>>> :
: : :
| | |
| EAP Response #N | |
|------------------------------>| |
| | Diameter-EAP-Request |
| | EAP-Payload(EAP Response #N) |
| |------------------------------->|
| | |
| | Diameter-EAP-Answer |
| | Result-Code=DIAMETER_SUCCESS |
| | EAP-Payload(EAP Success) |
| | (authorization AVPs) |
| | QoS-Resources(QoS-Authorized) |
| |<-------------------------------|
| | |
| EAP Success | |
|<------------------------------| |
| | |
]]></artwork>
</figure>
</t>
</section>
<section title="Diameter NASREQ with QoS Information">
<t><xref target="diameter-nasreq-flow"/> shows a similar pre-provisioned QoS signaling
as in <xref target="diameter-eap-message-flow"/> but using the NASREQ application
instead of EAP application. </t>
<t>
<figure title="Example of a Diameter NASREQ enhanced with QoS Information"
anchor="diameter-nasreq-flow">
<artwork><![CDATA[
End Diameter
Host NAS Server
| | |
| Start Network | |
| Attachment | |
|<---------------->| |
| | |
| |AA-Request |
| |NASREQ-Payload |
| |QoS-Capability |
| +----------------------------->|
| | |
| | AA-Answer|
| Result-Code=DIAMETER_MULTI_ROUND_AUTH|
| NASREQ-Payload(NASREQ Request #1)|
| |<-----------------------------+
| | |
| Request | |
|<-----------------+ |
| | |
: : :
: <<<more message exchanges>>> :
: : :
| Response #N | |
+----------------->| |
| | |
| |AA-Request |
| |NASREQ-Payload ( Response #N )|
| +----------------------------->|
| | |
| | AA-Answer|
| | Result-Code=DIAMETER_SUCCESS|
| | (authorization AVPs)|
| | QoS-Resources(QoS-Authorized)|
| |<-----------------------------+
| | |
| Success | |
|<-----------------+ |
| | |
]]></artwork>
</figure>
</t>
</section>
<section title="QoS Authorization">
<t><xref target="diameter-authz-only-message-flow"/> shows an example of authorization
only QoS signaling as part of the NASREQ message exchange. The NAS provides the
Diameter server with the "QoS-Desired" QoS-Semantics AVP included in the
QoS-Resources AVP. The Diameter server then either authorizes the indicated QoS or
rejects the request and informs the NAS about the result. In this scenario the NAS
does not need to include the QoS-Capability AVP in the AAR message as the
QoS-Resources AVP implicitly does the same and also the NAS is authorizing a specific
QoS profile, not a pre-provisioned one. </t>
<t>
<figure title="Example of an Authorization-Only Message Flow"
anchor="diameter-authz-only-message-flow">
<artwork><![CDATA[
End Diameter
Host NAS Server
| | |
| | |
| QoS Request | |
+----------------->| |
| | |
| |AA-Request |
| |Auth-Request-Type=AUTHORIZE_ONLY
| |NASREQ-Payload |
| |QoS-Resources(QoS-Desired) |
| +----------------------------->|
| | |
| | AA-Answer|
| | NASREQ-Payload(Success)|
| | QoS-Resources(QoS-Authorized)|
| |<-----------------------------+
| Accept | |
|<-----------------+ |
| | |
| | |
| | |
]]></artwork>
</figure>
</t>
</section>
<section title="Diameter Server Initiated Re-authorization of QoS">
<t><xref target="diameter-re-auth-flow"/> shows a message exchange for a Diameter server
initiated QoS re-authorization procedure. The Diameter server sends the NAS a RAR
message requesting re-authorization for an existing session and the NAS acknowledges
it with a RAA message. The NAS is aware of its existing QoS profile and information
for the ongoing session that the Diameter server requested for re-authorization.
Thus, the NAS must initiate re-authorization of the existing QoS profile. The
re-authorization procedure is the same as in <xref
target="diameter-authz-only-message-flow"/>. </t>
<t>
<figure title="Example of a Server-initiated Re-Authorization Procedure"
anchor="diameter-re-auth-flow">
<artwork><![CDATA[
End Diameter
Host NAS Server
| | |
| | |
: : :
: <<<Initial Message Exchanges>>> :
: : :
| | |
| | RA-Request |
| |<-----------------------------+
| | |
| |RA-Answer |
| |Result-Code=DIAMETER_SUCCESS |
| +----------------------------->|
| | |
| | |
| |AA-Request |
| |NASREQ-Payload |
| |Auth-Request-Type=AUTHORIZE_ONLY
| |QoS-Resources(QoS-Desired) |
| +----------------------------->|
| | |
| | AA-Answer|
| | Result-Code=DIAMETER_SUCCESS|
| | (authorization AVPs)|
| | QoS-Resources(QoS-Authorized)|
| |<-----------------------------+
| | |
]]></artwork>
</figure>
</t>
</section>
<section title="Diameter Credit Control with QoS Information">
<t>In this case the User is charged as soon as the Service Element (CC client) receives
the service request. In this case the client uses the "QoS-Desired" QoS-Semantics
parameter in the QoS-Resources AVP that it sends to the Accounitng server. The server
responds with a "QoS-Available" QoS-Semantics parameter in the QoS-Resources AVP
<figure title="Example for a One-Time Diameter Credit Control Charging Event"
anchor="dcc-initial">
<artwork><![CDATA[
Service Element
End User (CC Client) B CC Server
| | | |
|(1) Service Request | | |
|-------------------->| | |
| |(2) CCR (event, DIRECT_DEBITING,|
| | QoS-Resources(QoS-desired)) |
| |-------------------------------->|
| |(3) CCA (Granted-Units, QoS- |
| | Resources(QoS-Authorized)) |
| |<--------------------------------|
|(4) Service Delivery | | |
|<--------------------| | |
|(5) Begin service | | |
|<------------------------------------>| |
| | | |
. . . .
. . . .
]]></artwork>
</figure>
</t>
</section>
<section title="Classifier Examples">
<t>Example: Classify all packets from hosts on subnet 192.0.2.0/24 to ports 80, 8090
or 443 on web servers 192.0.2.123, 192.0.2.124, 192.0.2.125.</t>
<t>
<figure>
<artwork><![CDATA[
Classifier = {
Classifier-Id = "web_svr_example";
Protocol = TCP;
Direction = OUT;
From-Spec = {
IP-Address-Mask = {
IP-Address = 192.0.2.0;
IP-Bit-Mask-Width = 24;
}
}
To-Spec = {
IP-Address = 192.0.2.123;
IP-Address = 192.0.2.124;
IP-Address = 192.0.2.125;
Port = 80;
Port = 8080;
Port = 443;
}
}
]]></artwork>
</figure>
</t>
<t>Example: Any SIP signalling traffic from a device with a MAC address of
01:23:45:67:89:ab to servers with IP addresses in the range 192.0.2.90 to
192.0.2.190.</t>
<t>
<figure>
<artwork><![CDATA[
Classifier = {
Classifier-Id = "web_svr_example";
Protocol = UDP;
Direction = OUT;
From-Spec = {
MAC-Address = 01:23:45:67:89:ab;
}
To-Spec = {
IP-Address-Range = {
IP-Address-Start = 192.0.2.90;
IP-Address-End = 192.0.2.190;
}
Port = 5060;
Port = 3478;
Port-Range = {
Port-Start = 16348;
Port-End = 32768;
}
}
}
]]></artwork>
</figure>
</t>
</section>
<section title="QoS Examples">
<t>The following high level description aims to illustrate the interworking between the
Diameter QoS AVPs defined in this document and the QoS parameters defined in <xref
target="I-D.ietf-dime-qos-parameters"/>.</t>
<t>Consider the following example where a rule should be installed that limits traffic
to 1 Mbit/sec and where out-of-profile traffic shall be dropped.The Classifers are
ignored in this example.</t>
<t>This would require the QoS-Action AVP to be set to 'shape' and the QoS-Parameters
AVP carries the Bandwidth AVP indicating the 1 Mbit/sec limit. The QoS-Action
carried inside the Excess-Treatment AVP would be set to 'drop'.</t>
<t>In a second, more complex scenario, we consider traffic marking with DiffServ.
In-profile traffic (of 5 Mbits/sec in our example) shall be associated with a
particular PHB-Class "X". Out-of-profile traffic shall belong to a different
PHB-Class, in our example "Y".</t>
<t>This configuration would require the QoS-Action AVP to be set to 'mark'. The
QoS-Parameters AVPs for the traffic conforming of the profile contains two AVPs,
namely the TMOD-1 AVP and the PHB-Class AVP. The TMOD-1 AVP describes the traffic
characteristics, namely 5 Mbit/sec, and the PHB-Class AVP is set to class "X". Then,
the Excess-Treatment AVP has to be included with the QoS-Action AVP set
to 'mark' and the QoS-Parameters AVP to carry another PHB-Class AVP indicating
PHB-Class AVP setting to class "Y". </t>
</section>
</section>
<!-- ====================================================================== -->
<section title="Acknowledgments">
<t>We would like to thank Victor Fajardo, Tseno Tsenov, Robert Hancock, Jukka Manner,
Cornelia Kappler, Xiaoming Fu, Frank Alfano, Tolga Asveren, Mike Montemurro, Glen Zorn,
Avri Doria, Dong Sun, Tina Tsou, Pete McCann, Georgios Karagiannis, Elwyn Davies, Max
Riegel and Yong Li for their comments. We thank Victor Fajardo for his job as PROTO
document shepherd.</t>
</section>
<!-- ====================================================================== -->
<section title="Contributors">
<t>Max Riegel contributed the VLAN sections.</t>
</section>
<!-- ====================================================================== -->
<section title="IANA Considerations">
<section toc="exclude" title="AVP Codes">
<t>IANA is requested to allocate AVP codes for the following AVPs that are defined in
this document.</t>
<t>
<figure>
<artwork><![CDATA[
+--------------------------------------------------------------------+
| AVP Section |
| Attribute Name Code Defined Data Type |
+--------------------------------------------------------------------+
|QoS-Resources TBD 3.1 Grouped |
|QoS-Rule TBD 3.2 Grouped |
|QoS-Rule-Precedence TBD 3.3 Unsigned32 |
|Classifier TBD 4.1.1 Grouped |
|Classifier-ID TBD 4.1.2 OctetString |
|Protocol TBD 4.1.3 Enumerated |
|Direction TBD 4.1.4 Enumerated |
|From-Spec TBD 4.1.5 Grouped |
|To-Spec TBD 4.1.6 Grouped |
|Negated TBD 4.1.7.1 Enumerated |
|IP-Address TBD 4.1.7.2 Address |
|IP-Address-Range TBD 4.1.7.3 Grouped |
|IP-Address-Start TBD 4.1.7.4 Address |
|IP-Address-End TBD 4.1.7.5 Address |
|IP-Address-Mask TBD 4.1.7.6 Grouped |
|IP-Mask-Bit-Mask-Width TBD 4.1.7.7 Unsigned32 |
|MAC-Address TBD 4.1.7.8 OctetString |
|MAC-Address-Mask TBD 4.1.7.9 Grouped |
|MAC-Address-Mask-Pattern TBD 4.1.7.10 OctetString |
|EUI64-Address TBD 4.1.7.11 OctetString |
|EUI64-Address-Mask TBD 4.1.7.12 Grouped |
|EUI64-Address-Mask-Pattern TBD 4.1.7.13 OctetString |
|Port TBD 4.1.7.14 Integer32 |
|Port-Range TBD 4.1.7.15 Grouped |
|Port-Start TBD 4.1.7.16 Integer32 |
|Port-End TBD 4.1.7.17 Integer32 |
|Use-Assigned-Address TBD 4.1.7.18 Enumerated |
|Diffserv-Code-Point TBD 4.1.8.1 Enumerated |
|Fragmentation-Flag TBD 4.1.8.2 Enumerated |
|IP-Option TBD 4.1.8.3 Grouped |
|IP-Option-Type TBD 4.1.8.4 Enumerated |
|IP-Option-Value TBD 4.1.8.5 OctetString |
|TCP-Option TBD 4.1.8.6 Grouped |
|TCP-Option-Type TBD 4.1.8.7 Enumerated |
|TCP-Option-Value TBD 4.1.8.8 OctetString |
|TCP-Flags TBD 4.1.8.9 Grouped |
|TCP-Flag-Type TBD 4.1.8.10 Enumerated |
|ICMP-Type TBD 4.1.8.11 Grouped |
|ICMP-Type-Number TBD 4.1.8.12 Enumerated |
|ICMP-Code TBD 4.1.8.13 Enumerated |
|ETH-Option TBD 4.1.8.14 Grouped |
|ETH-Proto-Type TBD 4.1.8.15 Grouped |
|ETH-Ether-Type TBD 4.1.8.16 OctetString |
|ETH-SAP TBD 4.1.8.17 OctetString |
|VLAN-ID-Range TBD 4.1.8.18 Grouped |
|S-VID-Start TBD 4.1.8.19 Unsigned32 |
|S-VID-End TBD 4.1.8.20 Unsigned32 |
|C-VID-Start TBD 4.1.8.21 Unsigned32 |
|C-VID-End TBD 4.1.8.22 Unsigned32 |
|User-Priority-Range TBD 4.1.8.23 Grouped |
|Low-User-Priority TBD 4.1.8.24 Unsigned32 |
|High-User-Priority TBD 4.1.8.25 Unsigned32 |
|Time-Of-Day-Condition TBD 4.2.1 Grouped |
|Time-Of-Day-Start TBD 4.2.2 Unsigned32 |
|Time-Of-Day-End TBD 4.2.3 Unsigned32 |
|Day-Of-Week-Mask TBD 4.2.4 Unsigned32 |
|Day-Of-Month-Mask TBD 4.2.5 Unsigned32 |
|Month-Of-Year-Mask TBD 4.2.6 Unsigned32 |
|Absolute-Start-Time TBD 4.2.7 Time |
|Absolute-End-Time TBD 4.2.8 Time |
|Timezone-Flag TBD 4.2.9 Enumerated |
|Timezone-Offset TBD 4.2.10 Integer32 |
|QoS-Action TBD 5.1 Grouped |
|QoS-Profile-Id TBD 5.2 Unsigned32 |
|QoS-Profile-Template TBD 5.3 Grouped |
|QoS-Semantics TBD 5.4 Enumerated |
|QoS-Parameters TBD 5.5 Grouped |
|Excess-Treatment TBD 5.6 Grouped |
|QoS-Capability TBD 6 Grouped |
+--------------------------------------------------------------------+
]]></artwork>
</figure>
</t>
</section>
<section toc="exclude" title="QoS-Semantics IANA Registry">
<t>IANA is also requested to allocate a registry for the QoS-Semantics AVP. The
following values are allocated by this specification. <figure>
<artwork><![CDATA[
(0): QoS-Desired
(1): QoS-Available
(2): QoS-Reserved
(3): Minimum-QoS
(4): QoS-Authorized
]]></artwork>
</figure>
</t>
<t>The definition of new values is subject to the Specification Required policy
<xref target="RFC5226"/>.
</t>
</section>
<section toc="exclude" anchor="action-reg" title="Action">
<t>IANA is also requested to allocate a registry for the QoS-Action AVP. The following
values are allocated by this specification: <figure>
<artwork><![CDATA[
0: drop
1: shape
2: mark
]]></artwork>
</figure>
</t>
<t>The definition of new values is subject to the Specification Required policy
<xref target="RFC5226"/>.
</t>
</section>
</section>
<!-- ====================================================================== -->
<section title="Security Considerations">
<t> This document describes the extension of Diameter for conveying Quality of Service
information. The security considerations of the Diameter protocol itself have been
discussed in RFC 3588 <xref target="RFC3588"/>. Use of the AVPs defined in this document
MUST take into consideration the security issues and requirements of the Diameter Base
protocol. </t>
</section>
<!-- ====================================================================== -->
</middle>
<back>
<references title="Normative References">&RFC2119; &RFC2780; &RFC2474; &RFC5226;
<reference anchor="IEEE802.1ad">
<front>
<title>IEEE Standard for Local and metropolitan area networks, Virtual Bridged Local
Area Networks, Amendment 4: Provider Bridges</title>
<author>
<organization abbrev="IEEE">IEEE</organization>
</author>
<date year="2005"/>
</front>
</reference>
<reference anchor="IEEE802.1D">
<front>
<title>IEEE Standard for Local and metropolitan area networks, Media Access Control
(MAC) Bridges</title>
<author>
<organization abbrev="IEEE">IEEE</organization>
</author>
<date year="2004"/>
</front>
</reference>
<reference anchor="IEEE802.1Q">
<front>
<title>IEEE Standard for Local and metropolitan area networks, Virtual Bridged Local
Area Networks</title>
<author>
<organization abbrev="IEEE">IEEE</organization>
</author>
<date year="2005"/>
</front>
</reference>
<reference anchor="IEEE802.2">
<front>
<title>IEEE Standard for Information technology, Telecommunications and information
exchange between systems, Local and metropolitan area networks, Specific
requirements, Part 2: Logical Link Control</title>
<author>
<organization abbrev="IEEE">IEEE</organization>
</author>
<date year="1998"/>
</front>
</reference>
</references>
<references title="Informative References">&I-D.ietf-dime-diameter-qos;
&I-D.ietf-dime-qos-parameters; &RFC4005; &RFC3588; &RFC2475;</references>
</back>
<!-- ====================================================================== -->
</rfc>
| PAFTECH AB 2003-2026 | 2026-04-23 19:50:09 |