api: update documentation about IPv6 bearer methods

Even if the IPv6 bearer method is DHCP, the client should use SLAAC
(eg, IPv6 Router Solicitations, Router Adverisements, and possibly
DHCPv6) to determine the correct prefix and DNS information.  In
some cases, even with the DHCP method, and IPv6 "address" will be
given which should be assigned to the data port before beginning
an IP addressing as the mobile network may expect this address
to be used.
This commit is contained in:
Dan Williams
2014-02-27 13:01:38 -06:00
parent 6e5d013eb1
commit 33eba0393d
2 changed files with 14 additions and 5 deletions

View File

@@ -849,8 +849,12 @@ typedef enum { /*< underscore_name=mm_modem_contacts_storage >*/
* MMBearerIpMethod: * MMBearerIpMethod:
* @MM_BEARER_IP_METHOD_UNKNOWN: Unknown method. * @MM_BEARER_IP_METHOD_UNKNOWN: Unknown method.
* @MM_BEARER_IP_METHOD_PPP: Use PPP to get the address. * @MM_BEARER_IP_METHOD_PPP: Use PPP to get the address.
* @MM_BEARER_IP_METHOD_STATIC: Use the provided static IP configuration given by the modem to configure the IP data interface. * @MM_BEARER_IP_METHOD_STATIC: Use the provided static IP configuration given
* @MM_BEARER_IP_METHOD_DHCP: Begin DHCP on the data interface to obtain necessary IP configuration details. * by the modem to configure the IP data interface.
* @MM_BEARER_IP_METHOD_DHCP: Begin DHCP or IPv6 SLAAC on the data interface to
* obtain necessary IP configuration details. For IPv4 bearers DHCP should
* be used. For IPv6 bearers SLAAC should be used to determine the prefix and
* any additional details.
* *
* Type of IP method configuration to be used in a given Bearer. * Type of IP method configuration to be used in a given Bearer.
*/ */

View File

@@ -186,10 +186,15 @@
</varlistentry> </varlistentry>
</variablelist> </variablelist>
If the bearer specifies configuration via PPP or DHCP, only the If the bearer specifies configuration via PPP or DHCP, often only the
<literal>"method"</literal> item will be present. <literal>"method"</literal> item will be present. IPv6 SLAAC should
be used to retrieve correct addressing and DNS information via Router
Advertisements and DHCPv6. In some cases an IPv6 Link-Local
<literal>"address"</literal> item will be present, which should be
assigned to the data port before performing SLAAC, as the mobile network
may expect SLAAC setup to use this address.
Additional items which are only applicable when using the Additional items which are usually only applicable when using the
<link linkend="MM-BEARER-IP-METHOD-STATIC:CAPS">MM_BEARER_IP_METHOD_STATIC</link> <link linkend="MM-BEARER-IP-METHOD-STATIC:CAPS">MM_BEARER_IP_METHOD_STATIC</link>
method are: method are:
<variablelist> <variablelist>