Add comment for RIL_REQUEST_SET_CARRIER_RESTRICTIONS and RIL_REQUEST_GET_CARRIER_RESTRICTIONS am: d5c540fe09
am: d9280860da
Change-Id: If7c72e60488b747e4d1e3bf10f940cc00caddd9c
diff --git a/include/telephony/ril.h b/include/telephony/ril.h
index 90db696..4471e29 100644
--- a/include/telephony/ril.h
+++ b/include/telephony/ril.h
@@ -5128,7 +5128,18 @@
/**
* RIL_REQUEST_SET_CARRIER_RESTRICTIONS
*
- * Set carrier restrictions for this sim slot
+ * Set carrier restrictions for this sim slot. Expected modem behavior:
+ * If never receives this command
+ * - Must allow all carriers
+ * Receives this command with data being NULL
+ * - Must allow all carriers. If a previously allowed SIM is present, modem must not reload
+ * the SIM. If a previously disallowed SIM is present, reload the SIM and notify Android.
+ * Receives this command with a list of carriers
+ * - Only allow specified carriers, persist across power cycles and FDR. If a present SIM
+ * is in the allowed list, modem must not reload the SIM. If a present SIM is *not* in
+ * the allowed list, modem must detach from the registered network and only keep emergency
+ * service, and notify Android SIM refresh reset with new SIM state being
+ * RIL_CARDSTATE_RESTRICTED. Emergency service must be enabled.
*
* "data" is const RIL_CarrierRestrictions *
* A list of allowed carriers and possibly a list of excluded carriers.
@@ -5150,7 +5161,8 @@
/**
* RIL_REQUEST_GET_CARRIER_RESTRICTIONS
*
- * Get carrier restrictions for this sim slot
+ * Get carrier restrictions for this sim slot. Expected modem behavior:
+ * Return list of allowed carriers, or null if all carriers are allowed.
*
* "data" is NULL
*