Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit b6528400 authored by Jordan Liu's avatar Jordan Liu
Browse files

Update getIccAuthentication documentation 

Explain what it means if the function returns null. This is based on the
spec at TS 31.102 section 7.3.1.

Bug: 74392381
Test: manual
Change-Id: Ic84d94589431109079a866027953ab9dbef103b8
Merged-In: Ic84d94589431109079a866027953ab9dbef103b8
parent 2a661bff

telephony/java/android/telephony/TelephonyManager.java

+13 −2
Original line number Diff line number Diff line
@@ -5147,7 +5147,12 @@ public class TelephonyManager { 
     * {@link #AUTHTYPE_EAP_SIM}

     * @param data authentication challenge data, base64 encoded.

     * See 3GPP TS 31.102 7.1.2 for more details.

     * @return the response of authentication, or null if not available

     * @return the response of authentication. This value will be null in the following cases:

     *   Authentication error, incorrect MAC

     *   Authentication error, security context not supported

     *   Key freshness failure

     *   Authentication error, no memory space available

     *   Authentication error, no memory space available in EFMUK

     */

    // TODO(b/73660190): This should probably require MODIFY_PHONE_STATE, not

    // READ_PRIVILEGED_PHONE_STATE. It certainly shouldn't reference the permission in Javadoc since
@@ -5168,7 +5173,13 @@ public class TelephonyManager { 
     * {@link #AUTHTYPE_EAP_SIM}

     * @param data authentication challenge data, base64 encoded.

     * See 3GPP TS 31.102 7.1.2 for more details.

     * @return the response of authentication, or null if not available

     * @return the response of authentication. This value will be null in the following cases only

     * (see 3GPP TS 31.102 7.3.1):

     *   Authentication error, incorrect MAC

     *   Authentication error, security context not supported

     *   Key freshness failure

     *   Authentication error, no memory space available

     *   Authentication error, no memory space available in EFMUK

     * @hide

     */

    public String getIccAuthentication(int subId, int appType, int authType, String data) {