api,bearer: new 'profile-source' setting

Sometimes it's useful to know how a given stored profile was created,
so devices can store and report this kind of information.

docs/reference/api/ModemManager-sections.txt

@@ -18,6 +18,7 @@ MMBearerMultiplexSupport
 MMBearerApnType
 MMBearerAccessTypePreference
 MMBearerRoamingAllowance
+MMBearerProfileSource
 MMCallDirection
 MMCallState
 MMCallStateReason

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

@@ -1707,6 +1707,7 @@ 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_bearer_profile_source_get_string
 mm_modem_capability_build_string_from_mask
 mm_modem_state_get_string
 mm_modem_state_failed_reason_get_string
@@ -1779,6 +1780,7 @@ 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_bearer_profile_source_build_string_from_mask
 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
@@ -1813,6 +1815,7 @@ MM_TYPE_ESIM_STATUS
 MM_TYPE_SIM_REMOVAL_STATUS
 MM_TYPE_BEARER_ACCESS_TYPE_PREFERENCE
 MM_TYPE_BEARER_ROAMING_ALLOWANCE
+MM_TYPE_BEARER_PROFILE_SOURCE
 MM_TYPE_FIRMWARE_IMAGE_TYPE
 MM_TYPE_MODEM_3GPP_FACILITY
 MM_TYPE_MODEM_3GPP_NETWORK_AVAILABILITY
@@ -1865,6 +1868,7 @@ 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_bearer_profile_source_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

@@ -1858,4 +1858,26 @@ typedef enum { /*< underscore_name=mm_bearer_roaming_allowance >*/
     MM_BEARER_ROAMING_ALLOWANCE_NON_PARTNER = 1 << 2,
 } MMBearerRoamingAllowance;
 
+/**
+ * MMBearerProfileSource:
+ * @MM_BEARER_PROFILE_SOURCE_UNKNOWN: Unknown.
+ * @MM_BEARER_PROFILE_SOURCE_ADMIN: Profile created by an enterprise IT admin from the OS.
+ * @MM_BEARER_PROFILE_SOURCE_USER: Profile created by the user.
+ * @MM_BEARER_PROFILE_SOURCE_OPERATOR: Profile created by the operator through OMA-DM or similar.
+ * @MM_BEARER_PROFILE_SOURCE_MODEM: Profile created by the OEM that was included with the modem firmware.
+ * @MM_BEARER_PROFILE_SOURCE_DEVICE: Profile created by the OS APN database.
+ *
+ * Value specifying how a given context was created, mostly for informative purposes.
+ *
+ * Since: 1.20
+ */
+typedef enum { /*< underscore_name=mm_bearer_profile_source >*/
+    MM_BEARER_PROFILE_SOURCE_UNKNOWN  = 0,
+    MM_BEARER_PROFILE_SOURCE_ADMIN    = 1,
+    MM_BEARER_PROFILE_SOURCE_USER     = 2,
+    MM_BEARER_PROFILE_SOURCE_OPERATOR = 3,
+    MM_BEARER_PROFILE_SOURCE_MODEM    = 4,
+    MM_BEARER_PROFILE_SOURCE_DEVICE   = 5,
+} MMBearerProfileSource;
+
 #endif /*  _MODEMMANAGER_ENUMS_H_ */

introspection/org.freedesktop.ModemManager1.Bearer.xml

@@ -530,6 +530,15 @@
               Since 1.20.
             </para></listitem>
           </varlistentry>
+          <varlistentry><term><literal>"profile-source"</literal></term>
+            <listitem><para>
+              A <link linkend="MMBearerProfileSource">MMBearerProfileSource</link>
+              value (signature <literal>"u"</literal>, specifying how the profile
+              was created. This setting only applies on profile management operations,
+              it should not be used as part of the settings of an explicit connection
+              attempt. Since 1.20.
+            </para></listitem>
+          </varlistentry>
         </variablelist>
 
         The following settings apply to 3GPP2 (CDMA/EVDO) devices: