2.2.2.15 Requested Address Family

This section follows the behavior described in product behavior note<13>

The Requested Address Family attribute is specified in [RFC6156] section 4.1.1.  It is used by the protocol client to request an allocation of a specific IP address family type from the TURN server. This attribute SHOULD be included in the Allocate request message when the protocol client wants either an IPv4 or an IPv6 address to be allocated.  The absence of this attribute in the Allocate request message indicates that the protocol client wants both an IPv4 and an IPv6 address to be allocated if the TURN server is so configured.  If the protocol client wants both an IPv4 and an IPv6 address to be allocated it SHOULD NOT include this attribute in the Allocate request message.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Attribute Type

Attribute Length

Family

Reserved

Attribute Type (2 bytes): The TURN attributes are specified in [IETFDRAFT-STUN-02] section 10.2 and [IETFDRAFT-TURN-08] section 9.2. Set to "0x0017".

Attribute Length (2 bytes): The length of bytes of following fields. Set to "0x0004" (4).

Family (1 byte): The address family of the attribute. There are two values defined for this field specified in [IETFDRAFT-STUN-02] section 10.2.1: "0x01" for IPv4 addresses and 0x02 for IPv6 addresses.

Reserved (3 bytes): The 24 bits in the Reserved field MUST be set to zero by the client and MUST be ignored by the server.