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             // Time when thread pool was emptied
95             int64_t             mStarvationStartTimeMs;
96 
97     mutable Mutex               mLock;  // protects everything below.
98 
99             Vector<handle_entry>mHandleToObject;
100 
101             bool                mManagesContexts;
102             context_check_func  mBinderContextCheckFunc;
103             void*               mBinderContextUserData;
104 
105             KeyedVector<String16, sp<IBinder> >
106                                 mContexts;
107 
108 
109             String8             mRootDir;
110             bool                mThreadPoolStarted;
111     volatile int32_t            mThreadPoolSeq;
112 };
113 
114 }; // namespace android
115 
116 // ---------------------------------------------------------------------------
117 
118 #endif // ANDROID_PROCESS_STATE_H
119