ServiceManagement.h revision c1813614ec88b080eda68b11175273ef7b432f44 
1/*
2 * Copyright (C) 2016 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#ifndef ANDROID_HARDWARE_ISERVICE_MANAGER_H
18#define ANDROID_HARDWARE_ISERVICE_MANAGER_H
19
20#include <string>
21#include <utils/StrongPointer.h>
22
23namespace android {
24
25namespace hidl {
26namespace manager {
27namespace V1_0 {
28    struct IServiceManager;
29}; // namespace V1_0
30}; // namespace manager
31}; // namespace hidl
32
33namespace hardware {
34
35namespace details {
36// e.x.: android.hardware.foo@1.0, IFoo, default
37void onRegistration(const std::string &packageName,
38                    const std::string &interfaceName,
39                    const std::string &instanceName);
40
41// e.x.: android.hardware.foo@1.0::IFoo, default
42void waitForHwService(const std::string &interface, const std::string &instanceName);
43
44void preloadPassthroughService(const std::string &descriptor);
45};
46
47// These functions are for internal use by hidl. If you want to get ahold
48// of an interface, the best way to do this is by calling IFoo::getService()
49sp<::android::hidl::manager::V1_0::IServiceManager> defaultServiceManager();
50sp<::android::hidl::manager::V1_0::IServiceManager> getPassthroughServiceManager();
51
52/**
53 * Given a service that is in passthrough mode, this function will go ahead and load the
54 * required passthrough module library (but not call HIDL_FETCH_I* functions to instantiate it).
55 *
56 * E.x.: preloadPassthroughService<IFoo>();
57 */
58template<typename I>
59static inline void preloadPassthroughService() {
60    details::preloadPassthroughService(I::descriptor);
61}
62
63}; // namespace hardware
64}; // namespace android
65
66#endif // ANDROID_HARDWARE_ISERVICE_MANAGER_H
67
68