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

Commit 0d9eb30b authored by Devin Moore's avatar Devin Moore Committed by Automerger Merge Worker
Browse files

Merge "Clarify details in docs for binderDied()" into main am: eacb2c63 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/3079464



Change-Id: I4176016f06da295a4d7c1140694169861c142868
Signed-off-by: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents 957ca598 eacb2c63

core/java/android/os/IBinder.java

+15 −2
Original line number Diff line number Diff line
@@ -312,8 +312,21 @@ public interface IBinder { 
        public void binderDied();



        /**

         * Interface for receiving a callback when the process hosting an IBinder

         * The function called when the process hosting an IBinder

         * has gone away.

         *

         * This callback will be called from any binder thread like any other binder

         * transaction. If the process receiving this notification is multithreaded

         * then synchronization may be required because other threads may be executing

         * at the same time.

         *

         * No locks are held in libbinder when {@link binderDied} is called.

         *

         * There is no need to call {@link unlinkToDeath} in the binderDied callback.

         * The binder is already dead so {@link unlinkToDeath} is a no-op.

         * It will be unlinked when the last local reference of that binder proxy is

         * dropped.

         *

         * @param who The IBinder that has become invalid

         */

        default void binderDied(@NonNull IBinder who) {