1 /*
2  * Copyright (C) 2005 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_PROCESS_STATE_H
18 #define ANDROID_PROCESS_STATE_H
19 
20 #include <binder/IBinder.h>
21 #include <utils/KeyedVector.h>
22 #include <utils/String8.h>
23 #include <utils/String16.h>
24 
25 #include <utils/threads.h>
26 
27 #include <pthread.h>
28 
29 // ---------------------------------------------------------------------------
30 namespace android {
31 
32 class IPCThreadState;
33 
34 class ProcessState : public virtual RefBase
35 {
36 public:
37     static  sp<ProcessState>    self();
38 
39             void                setContextObject(const sp<IBinder>& object);
40             sp<IBinder>         getContextObject(const sp<IBinder>& caller);
41 
42             void                setContextObject(const sp<IBinder>& object,
43                                                  const String16& name);
44             sp<IBinder>         getContextObject(const String16& name,
45                                                  const sp<IBinder>& caller);
46 
47             void                startThreadPool();
48 
49     typedef bool (*context_check_func)(const String16& name,
50                                        const sp<IBinder>& caller,
51                                        void* userData);
52 
53             bool                isContextManager(void) const;
54             bool                becomeContextManager(
55                                     context_check_func checkFunc,
56                                     void* userData);
57 
58             sp<IBinder>         getStrongProxyForHandle(int32_t handle);
59             wp<IBinder>         getWeakProxyForHandle(int32_t handle);
60             void                expungeHandle(int32_t handle, IBinder* binder);
61 
62             void                spawnPooledThread(bool isMain);
63 
64             status_t            setThreadPoolMaxThreadCount(size_t maxThreads);
65             void                giveThreadPoolName();
66 
67 private:
68     friend class IPCThreadState;
69 
70                                 ProcessState();
71                                 ~ProcessState();
72 
73                                 ProcessState(const ProcessState& o);
74             ProcessState&       operator=(const ProcessState& o);
75             String8             makeBinderThreadName();
76 
77             struct handle_entry {
78                 IBinder* binder;
79                 RefBase::weakref_type* refs;
80             };
81 
82             handle_entry*       lookupHandleLocked(int32_t handle);
83 
84             int                 mDriverFD;
85             void*               mVMStart;
86 
87             // Protects thread count variable below.
88             pthread_mutex_t     mThreadCountLock;
89             pthread_cond_t      mThreadCountDecrement;
90             // Number of binder threads current executing a command.
91             size_t              mExecutingThreadsCount;
92             // Maximum number for binder threads allowed for this process.
93             size_t              mMaxThreads;
94 
95     mutable Mutex               mLock;  // protects everything below.
96 
97             Vector<handle_entry>mHandleToObject;
98 
99             bool                mManagesContexts;
100             context_check_func  mBinderContextCheckFunc;
101             void*               mBinderContextUserData;
102 
103             KeyedVector<String16, sp<IBinder> >
104                                 mContexts;
105 
106 
107             String8             mRootDir;
108             bool                mThreadPoolStarted;
109     volatile int32_t            mThreadPoolSeq;
110 };
111 
112 }; // namespace android
113 
114 // ---------------------------------------------------------------------------
115 
116 #endif // ANDROID_PROCESS_STATE_H
117