Merge "libbinder(_ndk): document getService" am: 36937323b0 am: 4d50c47b44 am: a0e5b96b6e (cb1a77e5) · Commits · e / os / android_frameworks_native

libs/binder/include/binder/IServiceManager.h

+10 −2

Original line number	Original line	Diff line number	Diff line
	@@ -56,8 +56,16 @@ public:
	static const int DUMP_FLAG_PROTO = 1 << 4;		static const int DUMP_FLAG_PROTO = 1 << 4;

	/**		/**
	* Retrieve an existing service, blocking for a few seconds		* Retrieve an existing service, blocking for a few seconds if it doesn't yet exist. This
	* if it doesn't yet exist.		* does polling. A more efficient way to make sure you unblock as soon as the service is
			* available is to use waitForService or to use service notifications.
			*
			* Warning: when using this API, typically, you should call it in a loop. It's dangerous to
			* assume that nullptr could mean that the service is not available. The service could just
			* be starting. Generally, whether a service exists, this information should be declared
			* externally (for instance, an Android feature might imply the existence of a service,
			* a system property, or in the case of services in the VINTF manifest, it can be checked
			* with isDeclared).
	*/		*/
	virtual sp<IBinder> getService( const String16& name) const = 0;		virtual sp<IBinder> getService( const String16& name) const = 0;

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

+9 −1

Original line number	Original line	Diff line number	Diff line
	@@ -53,11 +53,19 @@ __attribute__((warn_unused_result)) AIBinder* AServiceManager_checkService(const
	/**		/**
	* Gets a binder object with this specific instance name. Blocks for a couple of seconds waiting on		* Gets a binder object with this specific instance name. Blocks for a couple of seconds waiting on
	* it. This also implicitly calls AIBinder_incStrong (so the caller of this function is responsible		* it. This also implicitly calls AIBinder_incStrong (so the caller of this function is responsible
	* for calling AIBinder_decStrong).		* for calling AIBinder_decStrong). This does polling. A more efficient way to make sure you
			* unblock as soon as the service is available is to use AIBinder_waitForService.
	*		*
	* WARNING: when using this API across an APEX boundary, do not use with unstable		* WARNING: when using this API across an APEX boundary, do not use with unstable
	* AIDL services. TODO(b/139325195)		* AIDL services. TODO(b/139325195)
	*		*
			* WARNING: when using this API, typically, you should call it in a loop. It's dangerous to
			* assume that nullptr could mean that the service is not available. The service could just
			* be starting. Generally, whether a service exists, this information should be declared
			* externally (for instance, an Android feature might imply the existence of a service,
			* a system property, or in the case of services in the VINTF manifest, it can be checked
			* with AServiceManager_isDeclared).
			*
	* \param instance identifier of the service used to lookup the service.		* \param instance identifier of the service used to lookup the service.
	*/		*/
	__attribute__((warn_unused_result)) AIBinder* AServiceManager_getService(const char* instance)		__attribute__((warn_unused_result)) AIBinder* AServiceManager_getService(const char* instance)