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

Commit 17435d20 authored by Steven Moreland's avatar Steven Moreland Committed by Automerger Merge Worker
Browse files

Merge "libbinder_ndk: document #apex service caveats" am: 02491a7d am: d80ee01b am: ca605a15 

Original change: https://android-review.googlesource.com/c/platform/frameworks/native/+/1653857

Change-Id: Ic6ffb4e615b201c2f321c460d2ff19f30b1e6abb
parents 90debcab ca605a15

libs/binder/ndk/include_platform/android/binder_manager.h

+12 −0
Original line number Diff line number Diff line
@@ -26,6 +26,9 @@ __BEGIN_DECLS 
 * This registers the service with the default service manager under this instance name. This does

 * not take ownership of binder.

 *

 * WARNING: when using this API across an APEX boundary, it should only be used with stable

 * AIDL services. TODO(b/139325195)

 *

 * \param binder object to register globally with the service manager.

 * \param instance identifier of the service. This will be used to lookup the service.

 *
@@ -39,6 +42,9 @@ __attribute__((warn_unused_result)) binder_exception_t AServiceManager_addServic 
 * service is not available This also implicitly calls AIBinder_incStrong (so the caller of this

 * function is responsible for calling AIBinder_decStrong).

 *

 * WARNING: when using this API across an APEX boundary, it should only be used with stable

 * AIDL services. TODO(b/139325195)

 *

 * \param instance identifier of the service used to lookup the service.

 */

__attribute__((warn_unused_result)) AIBinder* AServiceManager_checkService(const char* instance);
@@ -48,6 +54,9 @@ __attribute__((warn_unused_result)) AIBinder* AServiceManager_checkService(const 
 * it. This also implicitly calls AIBinder_incStrong (so the caller of this function is responsible

 * for calling AIBinder_decStrong).

 *

 * WARNING: when using this API across an APEX boundary, it should only be used with stable

 * AIDL services. TODO(b/139325195)

 *

 * \param instance identifier of the service used to lookup the service.

 */

__attribute__((warn_unused_result)) AIBinder* AServiceManager_getService(const char* instance);
@@ -78,6 +87,9 @@ binder_status_t AServiceManager_registerLazyService(AIBinder* binder, const char 
 * This also implicitly calls AIBinder_incStrong (so the caller of this function is responsible

 * for calling AIBinder_decStrong).

 *

 * WARNING: when using this API across an APEX boundary, it should only be used with stable

 * AIDL services. TODO(b/139325195)

 *

 * \param instance identifier of the service used to lookup the service.

 *

 * \return service if registered, null if not.