Merge "libbinder_ndk: document #apex service caveats" (02491a7d) · Commits · e / os / android_frameworks_native-old

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.