diff options
| author | 2021-03-29 17:41:02 +0000 | |
|---|---|---|
| committer | 2021-03-29 17:41:02 +0000 | |
| commit | 02491a7d1c089e8e7f8a723d727652c613ba36cb (patch) | |
| tree | 1866339ecf3b2136aed62a4b8a055ef50e352888 | |
| parent | 6f9f5ea186d9c08d650f2888b61678571130121a (diff) | |
| parent | 21ef24df732e984694097f9174ce44ea968f7d3a (diff) | |
Merge "libbinder_ndk: document #apex service caveats"
| -rw-r--r-- | libs/binder/ndk/include_platform/android/binder_manager.h | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/libs/binder/ndk/include_platform/android/binder_manager.h b/libs/binder/ndk/include_platform/android/binder_manager.h index 5df0012bd3..0668472240 100644 --- a/libs/binder/ndk/include_platform/android/binder_manager.h +++ b/libs/binder/ndk/include_platform/android/binder_manager.h @@ -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. |