api,bearer: new 'roaming-allowance' setting

The 'allow-roaming' setting should be considered deprecated for 3GPP
devices that support the new 'roaming-allowance' setting, which is
much more detailed (as it allows to differentiate between partner and
non-partner networks) and may also be stored as part of a profile.

docs/reference/api/ModemManager-sections.txt

@@ -17,6 +17,7 @@ MMBearerAllowedAuth
 MMBearerMultiplexSupport
 MMBearerApnType
 MMBearerAccessTypePreference
+MMBearerRoamingAllowance
 MMCallDirection
 MMCallState
 MMCallStateReason

docs/reference/libmm-glib/libmm-glib-sections.txt

@@ -1706,6 +1706,7 @@ mm_sim_type_get_string
 mm_sim_esim_status_get_string
 mm_sim_removability_get_string
 mm_bearer_access_type_preference_get_string
+mm_bearer_roaming_allowance_build_string_from_mask
 mm_modem_capability_build_string_from_mask
 mm_modem_state_get_string
 mm_modem_state_failed_reason_get_string
@@ -1777,6 +1778,7 @@ mm_sim_type_build_string_from_mask
 mm_sim_esim_status_build_string_from_mask
 mm_sim_removability_build_string_from_mask
 mm_bearer_access_type_preference_build_string_from_mask
+mm_bearer_roaming_allowance_get_string
 mm_modem_cdma_registration_state_build_string_from_mask
 mm_modem_cdma_activation_state_build_string_from_mask
 mm_modem_cdma_rm_protocol_build_string_from_mask
@@ -1810,6 +1812,7 @@ MM_TYPE_SIM_TYPE
 MM_TYPE_ESIM_STATUS
 MM_TYPE_SIM_REMOVAL_STATUS
 MM_TYPE_BEARER_ACCESS_TYPE_PREFERENCE
+MM_TYPE_BEARER_ROAMING_ALLOWANCE
 MM_TYPE_FIRMWARE_IMAGE_TYPE
 MM_TYPE_MODEM_3GPP_FACILITY
 MM_TYPE_MODEM_3GPP_NETWORK_AVAILABILITY
@@ -1861,6 +1864,7 @@ mm_sim_type_get_type
 mm_sim_esim_status_get_type
 mm_sim_removability_get_type
 mm_bearer_access_type_preference_get_type
+mm_bearer_roaming_allowance_get_type
 mm_firmware_image_type_get_type
 mm_modem_3gpp_facility_get_type
 mm_modem_3gpp_network_availability_get_type

include/ModemManager-enums.h

@@ -1840,4 +1840,22 @@ typedef enum { /*< underscore_name=mm_bearer_access_type_preference >*/
     MM_BEARER_ACCESS_TYPE_PREFERENCE_NON_3GPP_ONLY  = 3,
 } MMBearerAccessTypePreference;
 
+/**
+ * MMBearerRoamingAllowance:
+ * @MM_BEARER_ROAMING_ALLOWANCE_NONE: No explicit roaming allowance rules.
+ * @MM_BEARER_ROAMING_ALLOWANCE_HOME: Home network allowed.
+ * @MM_BEARER_ROAMING_ALLOWANCE_PARTNER: Partner network allowed.
+ * @MM_BEARER_ROAMING_ALLOWANCE_NON_PARTNER: Non-parter network allowed.
+ *
+ * Bitmask specifying roaming allowance rules for different network types.
+ *
+ * Since: 1.20
+ */
+typedef enum { /*< underscore_name=mm_bearer_roaming_allowance >*/
+    MM_BEARER_ROAMING_ALLOWANCE_NONE        = 0,
+    MM_BEARER_ROAMING_ALLOWANCE_HOME        = 1 << 0,
+    MM_BEARER_ROAMING_ALLOWANCE_PARTNER     = 1 << 1,
+    MM_BEARER_ROAMING_ALLOWANCE_NON_PARTNER = 1 << 2,
+} MMBearerRoamingAllowance;
+
 #endif /*  _MODEMMANAGER_ENUMS_H_ */

introspection/org.freedesktop.ModemManager1.Bearer.xml

@@ -489,6 +489,14 @@
               value (signature <literal>"u"</literal>. Since 1.20.
             </para></listitem>
           </varlistentry>
+          <varlistentry><term><literal>"roaming-allowance"</literal></term>
+            <listitem><para>
+              Roaming allowance, given as a
+              <link linkend="MMBearerRoamingAllowance">MMBearerRoamingAllowance</link>
+              value (signature <literal>"u"</literal>. If supported, this setting should
+              be used instead of 'allow-roaming'. Since 1.20.
+            </para></listitem>
+          </varlistentry>
           <varlistentry><term><literal>"profile-id"</literal></term>
             <listitem>
               The ID of the 3GPP profile to connect to (signature