diff options
| author | 2021-03-29 19:10:46 +0000 | |
|---|---|---|
| committer | 2021-03-29 19:10:46 +0000 | |
| commit | 17435d200c45336bca4578b5e02538d2d228aedf (patch) | |
| tree | d94301081fdb95a6050a60159cf7959e635e4cd6 | |
| parent | 90debcab6a6716183fb8f8562d708245307dd723 (diff) | |
| parent | ca605a15af4a7dfaaec4255aa6a962099cd05370 (diff) | |
Merge "libbinder_ndk: document #apex service caveats" am: 02491a7d1c am: d80ee01bf8 am: ca605a15af
Original change: https://android-review.googlesource.com/c/platform/frameworks/native/+/1653857
Change-Id: Ic6ffb4e615b201c2f321c460d2ff19f30b1e6abb
| -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. |