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

Commit ea2ab0b7 authored by Steven Moreland's avatar Steven Moreland
Browse files

Document linkToDeath behavior on object cleanup. 

Note, this is documentation for behavior that was changed in R (for
sanity but also to make things consistent with Java).

Bug: 152627219
Test: n/A
Change-Id: If48fa48db20b0158989ae8181eb9d4d0b22ce4b8
parent 38e2dd48

libs/binder/include/binder/IBinder.h

+4 −0
Original line number Diff line number Diff line
@@ -173,6 +173,10 @@ public: 
     * The @a cookie is optional -- if non-NULL, it should be a

     * memory address that you own (that is, you know it is unique).

     *

     * @note When all references to the binder being linked to are dropped, the

     * recipient is automatically unlinked. So, you must hold onto a binder in

     * order to receive death notifications about it.

     *

     * @note You will only receive death notifications for remote binders,

     * as local binders by definition can't die without you dying as well.

     * Trying to use this function on a local binder will result in an