libbinder_ndk: document association for dead binder
The AIBinder_associateClass method checks interfaceDescriptor and may
invoke an IPC. In this case, if it is called on a binder which is dead,
it will fail, which may be surprising.
Bug: 155793159
Test: N/A
Change-Id: I09b2a0c5346d254fbad46086d47e2385f55ec3a2
diff --git a/libs/binder/ndk/include_ndk/android/binder_ibinder.h b/libs/binder/ndk/include_ndk/android/binder_ibinder.h
index 13dbec1..33763d5 100644
--- a/libs/binder/ndk/include_ndk/android/binder_ibinder.h
+++ b/libs/binder/ndk/include_ndk/android/binder_ibinder.h
@@ -408,6 +408,8 @@
* This returns true if the class association succeeds. If it fails, no change is made to the
* binder object.
*
+ * Warning: this may fail if the binder is dead.
+ *
* Available since API level 29.
*
* \param binder the object to attach the class to.