blob: eb4468386c0682522bccb30fc37d7f76afe05faa [file] [log] [blame]
Steven Moreland2e87adc2018-08-20 19:47:00 -07001/*
2 * Copyright (C) 2018 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#include <android/binder_ibinder.h>
Steven Moreland2f405f52020-07-08 22:24:29 +000018#include <android/binder_ibinder_platform.h>
Steven Moreland8afad292020-11-06 22:26:51 +000019#include <android/binder_libbinder.h>
Steven Moreland4d5ad492018-09-13 12:49:16 -070020#include "ibinder_internal.h"
Steven Moreland2e87adc2018-08-20 19:47:00 -070021
Steven Moreland46b5fea2019-10-15 11:22:18 -070022#include <android/binder_stability.h>
Steven Moreland2e87adc2018-08-20 19:47:00 -070023#include <android/binder_status.h>
Steven Moreland4d5ad492018-09-13 12:49:16 -070024#include "parcel_internal.h"
Steven Moreland5d62e442018-09-13 15:01:02 -070025#include "status_internal.h"
Steven Moreland2e87adc2018-08-20 19:47:00 -070026
27#include <android-base/logging.h>
Steven Morelandf3034b02018-11-12 17:37:46 -080028#include <binder/IPCThreadState.h>
Ruchir Rastogicc7a7462020-01-31 14:29:15 -080029#include <binder/IResultReceiver.h>
30#include <private/android_filesystem_config.h>
Steven Moreland2e87adc2018-08-20 19:47:00 -070031
Steven Moreland901c7452018-09-04 16:17:28 -070032using DeathRecipient = ::android::IBinder::DeathRecipient;
33
Steven Moreland2e87adc2018-08-20 19:47:00 -070034using ::android::IBinder;
Ruchir Rastogicc7a7462020-01-31 14:29:15 -080035using ::android::IResultReceiver;
Steven Moreland2e87adc2018-08-20 19:47:00 -070036using ::android::Parcel;
37using ::android::sp;
Steven Moreland5d62e442018-09-13 15:01:02 -070038using ::android::status_t;
Steven Moreland2e87adc2018-08-20 19:47:00 -070039using ::android::String16;
Steven Morelanda194c452019-03-04 16:47:07 -080040using ::android::String8;
Steven Moreland2e87adc2018-08-20 19:47:00 -070041using ::android::wp;
42
Steven Moreland71cddc32018-08-30 23:39:22 -070043namespace ABBinderTag {
44
45static const void* kId = "ABBinder";
46static void* kValue = static_cast<void*>(new bool{true});
Steven Moreland94968952018-09-05 14:42:59 -070047void clean(const void* /*id*/, void* /*obj*/, void* /*cookie*/){/* do nothing */};
Steven Moreland71cddc32018-08-30 23:39:22 -070048
49static void attach(const sp<IBinder>& binder) {
Steven Moreland94968952018-09-05 14:42:59 -070050 binder->attachObject(kId, kValue, nullptr /*cookie*/, clean);
Steven Moreland71cddc32018-08-30 23:39:22 -070051}
52static bool has(const sp<IBinder>& binder) {
53 return binder != nullptr && binder->findObject(kId) == kValue;
54}
55
Steven Moreland6cf66ac2018-11-02 18:14:54 -070056} // namespace ABBinderTag
Steven Moreland71cddc32018-08-30 23:39:22 -070057
Steven Moreland94968952018-09-05 14:42:59 -070058namespace ABpBinderTag {
59
60static std::mutex gLock;
61static const void* kId = "ABpBinder";
62struct Value {
63 wp<ABpBinder> binder;
64};
65void clean(const void* id, void* obj, void* cookie) {
66 CHECK(id == kId) << id << " " << obj << " " << cookie;
67
68 delete static_cast<Value*>(obj);
69};
70
Steven Moreland6cf66ac2018-11-02 18:14:54 -070071} // namespace ABpBinderTag
Steven Moreland94968952018-09-05 14:42:59 -070072
Steven Moreland2e87adc2018-08-20 19:47:00 -070073AIBinder::AIBinder(const AIBinder_Class* clazz) : mClazz(clazz) {}
74AIBinder::~AIBinder() {}
75
Andrei Homescu9556bb12020-09-21 16:59:45 -070076std::optional<bool> AIBinder::associateClassInternal(const AIBinder_Class* clazz,
Steven Moreland63872b52020-10-02 19:28:23 +000077 const String16& newDescriptor, bool set) {
Andrei Homescu9556bb12020-09-21 16:59:45 -070078 std::lock_guard<std::mutex> lock(mClazzMutex);
Steven Moreland71cddc32018-08-30 23:39:22 -070079 if (mClazz == clazz) return true;
Steven Moreland2e87adc2018-08-20 19:47:00 -070080
Steven Moreland2e87adc2018-08-20 19:47:00 -070081 if (mClazz != nullptr) {
Steven Moreland63872b52020-10-02 19:28:23 +000082 const String16& currentDescriptor = mClazz->getInterfaceDescriptor();
Steven Moreland2e87adc2018-08-20 19:47:00 -070083 if (newDescriptor == currentDescriptor) {
84 LOG(ERROR) << __func__ << ": Class descriptors '" << currentDescriptor
85 << "' match during associateClass, but they are different class objects. "
86 "Class descriptor collision?";
Steven Moreland71cddc32018-08-30 23:39:22 -070087 } else {
88 LOG(ERROR) << __func__
89 << ": Class cannot be associated on object which already has a class. "
90 "Trying to associate to '"
Steven Moreland63872b52020-10-02 19:28:23 +000091 << newDescriptor << "' but already set to '" << currentDescriptor << "'.";
Steven Moreland2e87adc2018-08-20 19:47:00 -070092 }
93
Steven Moreland71cddc32018-08-30 23:39:22 -070094 // always a failure because we know mClazz != clazz
95 return false;
Steven Moreland2e87adc2018-08-20 19:47:00 -070096 }
97
Andrei Homescu9556bb12020-09-21 16:59:45 -070098 if (set) {
99 // if this is a local object, it's not one known to libbinder_ndk
100 mClazz = clazz;
Steven Moreland9facfce2020-10-02 17:26:56 +0000101 return true;
Andrei Homescu9556bb12020-09-21 16:59:45 -0700102 }
103
104 return {};
105}
106
107bool AIBinder::associateClass(const AIBinder_Class* clazz) {
108 if (clazz == nullptr) return false;
109
Steven Moreland63872b52020-10-02 19:28:23 +0000110 const String16& newDescriptor = clazz->getInterfaceDescriptor();
Andrei Homescu9556bb12020-09-21 16:59:45 -0700111
112 auto result = associateClassInternal(clazz, newDescriptor, false);
113 if (result.has_value()) return *result;
114
Steven Moreland6cf66ac2018-11-02 18:14:54 -0700115 CHECK(asABpBinder() != nullptr); // ABBinder always has a descriptor
Steven Moreland71cddc32018-08-30 23:39:22 -0700116
Steven Moreland63872b52020-10-02 19:28:23 +0000117 const String16& descriptor = getBinder()->getInterfaceDescriptor();
Steven Moreland2e87adc2018-08-20 19:47:00 -0700118 if (descriptor != newDescriptor) {
Steven Moreland640c4092020-07-08 00:19:58 +0000119 if (getBinder()->isBinderAlive()) {
Steven Moreland63872b52020-10-02 19:28:23 +0000120 LOG(ERROR) << __func__ << ": Expecting binder to have class '" << newDescriptor
121 << "' but descriptor is actually '" << descriptor << "'.";
Steven Moreland640c4092020-07-08 00:19:58 +0000122 } else {
123 // b/155793159
Steven Moreland63872b52020-10-02 19:28:23 +0000124 LOG(ERROR) << __func__ << ": Cannot associate class '" << newDescriptor
Steven Moreland640c4092020-07-08 00:19:58 +0000125 << "' to dead binder.";
126 }
Steven Moreland71cddc32018-08-30 23:39:22 -0700127 return false;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700128 }
129
Steven Moreland9facfce2020-10-02 17:26:56 +0000130 return associateClassInternal(clazz, newDescriptor, true).value();
Steven Moreland2e87adc2018-08-20 19:47:00 -0700131}
132
133ABBinder::ABBinder(const AIBinder_Class* clazz, void* userData)
Steven Moreland6cf66ac2018-11-02 18:14:54 -0700134 : AIBinder(clazz), BBinder(), mUserData(userData) {
Steven Moreland2e87adc2018-08-20 19:47:00 -0700135 CHECK(clazz != nullptr);
136}
137ABBinder::~ABBinder() {
138 getClass()->onDestroy(mUserData);
139}
140
141const String16& ABBinder::getInterfaceDescriptor() const {
142 return getClass()->getInterfaceDescriptor();
143}
144
Steven Morelanda194c452019-03-04 16:47:07 -0800145status_t ABBinder::dump(int fd, const ::android::Vector<String16>& args) {
146 AIBinder_onDump onDump = getClass()->onDump;
147
148 if (onDump == nullptr) {
149 return STATUS_OK;
150 }
151
152 // technically UINT32_MAX would be okay here, but INT32_MAX is expected since this may be
153 // null in Java
154 if (args.size() > INT32_MAX) {
155 LOG(ERROR) << "ABBinder::dump received too many arguments: " << args.size();
156 return STATUS_BAD_VALUE;
157 }
158
159 std::vector<String8> utf8Args; // owns memory of utf8s
160 utf8Args.reserve(args.size());
161 std::vector<const char*> utf8Pointers; // what can be passed over NDK API
162 utf8Pointers.reserve(args.size());
163
164 for (size_t i = 0; i < args.size(); i++) {
165 utf8Args.push_back(String8(args[i]));
166 utf8Pointers.push_back(utf8Args[i].c_str());
167 }
168
169 return onDump(this, fd, utf8Pointers.data(), utf8Pointers.size());
170}
171
Steven Moreland5d62e442018-09-13 15:01:02 -0700172status_t ABBinder::onTransact(transaction_code_t code, const Parcel& data, Parcel* reply,
173 binder_flags_t flags) {
Steven Moreland2e87adc2018-08-20 19:47:00 -0700174 if (isUserCommand(code)) {
175 if (!data.checkInterface(this)) {
Steven Moreland9d089af2018-09-18 08:58:09 -0700176 return STATUS_BAD_TYPE;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700177 }
178
179 const AParcel in = AParcel::readOnly(this, &data);
180 AParcel out = AParcel(this, reply, false /*owns*/);
181
Steven Moreland5d62e442018-09-13 15:01:02 -0700182 binder_status_t status = getClass()->onTransact(this, code, &in, &out);
183 return PruneStatusT(status);
Ruchir Rastogicc7a7462020-01-31 14:29:15 -0800184 } else if (code == SHELL_COMMAND_TRANSACTION) {
185 int in = data.readFileDescriptor();
186 int out = data.readFileDescriptor();
187 int err = data.readFileDescriptor();
188
189 int argc = data.readInt32();
190 std::vector<String8> utf8Args; // owns memory of utf8s
191 std::vector<const char*> utf8Pointers; // what can be passed over NDK API
192 for (int i = 0; i < argc && data.dataAvail() > 0; i++) {
193 utf8Args.push_back(String8(data.readString16()));
194 utf8Pointers.push_back(utf8Args[i].c_str());
195 }
196
197 data.readStrongBinder(); // skip over the IShellCallback
198 sp<IResultReceiver> resultReceiver = IResultReceiver::asInterface(data.readStrongBinder());
199
200 // Shell commands should only be callable by ADB.
201 uid_t uid = AIBinder_getCallingUid();
202 if (uid != AID_ROOT && uid != AID_SHELL) {
203 if (resultReceiver != nullptr) {
204 resultReceiver->send(-1);
205 }
206 return STATUS_PERMISSION_DENIED;
207 }
208
209 // Check that the file descriptors are valid.
210 if (in == STATUS_BAD_TYPE || out == STATUS_BAD_TYPE || err == STATUS_BAD_TYPE) {
211 if (resultReceiver != nullptr) {
212 resultReceiver->send(-1);
213 }
214 return STATUS_BAD_VALUE;
215 }
216
217 binder_status_t status = getClass()->handleShellCommand(
218 this, in, out, err, utf8Pointers.data(), utf8Pointers.size());
219 if (resultReceiver != nullptr) {
220 resultReceiver->send(status);
221 }
222 return status;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700223 } else {
224 return BBinder::onTransact(code, data, reply, flags);
225 }
226}
227
Steven Moreland71cddc32018-08-30 23:39:22 -0700228ABpBinder::ABpBinder(const ::android::sp<::android::IBinder>& binder)
Steven Moreland6cf66ac2018-11-02 18:14:54 -0700229 : AIBinder(nullptr /*clazz*/), BpRefBase(binder) {
Steven Moreland2e87adc2018-08-20 19:47:00 -0700230 CHECK(binder != nullptr);
231}
232ABpBinder::~ABpBinder() {}
233
Steven Moreland94968952018-09-05 14:42:59 -0700234void ABpBinder::onLastStrongRef(const void* id) {
Steven Moreland2505ec42021-06-25 02:08:49 +0000235 // Since ABpBinder is OBJECT_LIFETIME_WEAK, we must remove this weak reference in order for
236 // the ABpBinder to be deleted. Since a strong reference to this ABpBinder object should no
237 // longer be able to exist at the time of this method call, there is no longer a need to
238 // recover it.
Steven Moreland94968952018-09-05 14:42:59 -0700239
Steven Moreland2505ec42021-06-25 02:08:49 +0000240 ABpBinderTag::Value* value =
241 static_cast<ABpBinderTag::Value*>(remote()->detachObject(ABpBinderTag::kId));
242 if (value) ABpBinderTag::clean(ABpBinderTag::kId, value, nullptr /*cookie*/);
Steven Moreland94968952018-09-05 14:42:59 -0700243
244 BpRefBase::onLastStrongRef(id);
245}
246
247sp<AIBinder> ABpBinder::lookupOrCreateFromBinder(const ::android::sp<::android::IBinder>& binder) {
Steven Moreland71cddc32018-08-30 23:39:22 -0700248 if (binder == nullptr) {
249 return nullptr;
250 }
251 if (ABBinderTag::has(binder)) {
252 return static_cast<ABBinder*>(binder.get());
253 }
Steven Moreland94968952018-09-05 14:42:59 -0700254
255 // The following code ensures that for a given binder object (remote or local), if it is not an
256 // ABBinder then at most one ABpBinder object exists in a given process representing it.
257 std::lock_guard<std::mutex> lock(ABpBinderTag::gLock);
258
259 ABpBinderTag::Value* value =
260 static_cast<ABpBinderTag::Value*>(binder->findObject(ABpBinderTag::kId));
261 if (value == nullptr) {
262 value = new ABpBinderTag::Value;
263 binder->attachObject(ABpBinderTag::kId, static_cast<void*>(value), nullptr /*cookie*/,
264 ABpBinderTag::clean);
265 }
266
267 sp<ABpBinder> ret = value->binder.promote();
268 if (ret == nullptr) {
269 ret = new ABpBinder(binder);
270 value->binder = ret;
271 }
272
273 return ret;
Steven Moreland71cddc32018-08-30 23:39:22 -0700274}
275
Steven Moreland2e87adc2018-08-20 19:47:00 -0700276struct AIBinder_Weak {
277 wp<AIBinder> binder;
278};
279AIBinder_Weak* AIBinder_Weak_new(AIBinder* binder) {
Steven Moreland5ccb70f2018-09-04 16:30:21 -0700280 if (binder == nullptr) {
281 return nullptr;
282 }
283
Steven Moreland2e87adc2018-08-20 19:47:00 -0700284 return new AIBinder_Weak{wp<AIBinder>(binder)};
285}
Steven Moreland9b80e282018-09-19 13:57:23 -0700286void AIBinder_Weak_delete(AIBinder_Weak* weakBinder) {
287 delete weakBinder;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700288}
289AIBinder* AIBinder_Weak_promote(AIBinder_Weak* weakBinder) {
Steven Moreland5ccb70f2018-09-04 16:30:21 -0700290 if (weakBinder == nullptr) {
291 return nullptr;
292 }
293
Steven Moreland2e87adc2018-08-20 19:47:00 -0700294 sp<AIBinder> binder = weakBinder->binder.promote();
295 AIBinder_incStrong(binder.get());
296 return binder.get();
297}
298
Steven Morelandc70e0122021-01-08 02:44:53 +0000299AIBinder_Weak* AIBinder_Weak_clone(const AIBinder_Weak* weak) {
300 if (weak == nullptr) {
301 return nullptr;
302 }
303
304 return new AIBinder_Weak{weak->binder};
305}
306
307bool AIBinder_lt(const AIBinder* lhs, const AIBinder* rhs) {
308 if (lhs == nullptr || rhs == nullptr) return lhs < rhs;
309
310 return const_cast<AIBinder*>(lhs)->getBinder() < const_cast<AIBinder*>(rhs)->getBinder();
311}
312
313bool AIBinder_Weak_lt(const AIBinder_Weak* lhs, const AIBinder_Weak* rhs) {
314 if (lhs == nullptr || rhs == nullptr) return lhs < rhs;
315
316 return lhs->binder < rhs->binder;
317}
318
Steven Moreland2e87adc2018-08-20 19:47:00 -0700319AIBinder_Class::AIBinder_Class(const char* interfaceDescriptor, AIBinder_Class_onCreate onCreate,
320 AIBinder_Class_onDestroy onDestroy,
321 AIBinder_Class_onTransact onTransact)
Steven Moreland6cf66ac2018-11-02 18:14:54 -0700322 : onCreate(onCreate),
323 onDestroy(onDestroy),
324 onTransact(onTransact),
Stephen Crane8fde87f2020-11-17 15:06:11 -0800325 mInterfaceDescriptor(interfaceDescriptor),
326 mWideInterfaceDescriptor(interfaceDescriptor) {}
Steven Moreland2e87adc2018-08-20 19:47:00 -0700327
328AIBinder_Class* AIBinder_Class_define(const char* interfaceDescriptor,
329 AIBinder_Class_onCreate onCreate,
330 AIBinder_Class_onDestroy onDestroy,
331 AIBinder_Class_onTransact onTransact) {
332 if (interfaceDescriptor == nullptr || onCreate == nullptr || onDestroy == nullptr ||
333 onTransact == nullptr) {
334 return nullptr;
335 }
336
337 return new AIBinder_Class(interfaceDescriptor, onCreate, onDestroy, onTransact);
338}
339
Steven Morelanda194c452019-03-04 16:47:07 -0800340void AIBinder_Class_setOnDump(AIBinder_Class* clazz, AIBinder_onDump onDump) {
341 CHECK(clazz != nullptr) << "setOnDump requires non-null clazz";
342
343 // this is required to be called before instances are instantiated
344 clazz->onDump = onDump;
345}
346
Ruchir Rastogicc7a7462020-01-31 14:29:15 -0800347void AIBinder_Class_setHandleShellCommand(AIBinder_Class* clazz,
348 AIBinder_handleShellCommand handleShellCommand) {
349 CHECK(clazz != nullptr) << "setHandleShellCommand requires non-null clazz";
350
351 clazz->handleShellCommand = handleShellCommand;
352}
353
Stephen Crane8fde87f2020-11-17 15:06:11 -0800354const char* AIBinder_Class_getDescriptor(const AIBinder_Class* clazz) {
355 CHECK(clazz != nullptr) << "getDescriptor requires non-null clazz";
356
357 return clazz->getInterfaceDescriptorUtf8();
358}
359
Steven Moreland901c7452018-09-04 16:17:28 -0700360void AIBinder_DeathRecipient::TransferDeathRecipient::binderDied(const wp<IBinder>& who) {
Steven Moreland8bcb5032021-04-07 23:06:43 +0000361 CHECK(who == mWho) << who.unsafe_get() << "(" << who.get_refs() << ") vs " << mWho.unsafe_get()
362 << " (" << mWho.get_refs() << ")";
Steven Moreland901c7452018-09-04 16:17:28 -0700363
364 mOnDied(mCookie);
Steven Moreland64127ca2019-03-13 09:25:44 -0700365
366 sp<AIBinder_DeathRecipient> recipient = mParentRecipient.promote();
367 sp<IBinder> strongWho = who.promote();
368
369 // otherwise this will be cleaned up later with pruneDeadTransferEntriesLocked
370 if (recipient != nullptr && strongWho != nullptr) {
371 status_t result = recipient->unlinkToDeath(strongWho, mCookie);
372 if (result != ::android::DEAD_OBJECT) {
373 LOG(WARNING) << "Unlinking to dead binder resulted in: " << result;
374 }
375 }
376
Steven Moreland901c7452018-09-04 16:17:28 -0700377 mWho = nullptr;
378}
379
380AIBinder_DeathRecipient::AIBinder_DeathRecipient(AIBinder_DeathRecipient_onBinderDied onDied)
Steven Moreland6cf66ac2018-11-02 18:14:54 -0700381 : mOnDied(onDied) {
Steven Moreland901c7452018-09-04 16:17:28 -0700382 CHECK(onDied != nullptr);
383}
384
Steven Moreland64127ca2019-03-13 09:25:44 -0700385void AIBinder_DeathRecipient::pruneDeadTransferEntriesLocked() {
386 mDeathRecipients.erase(std::remove_if(mDeathRecipients.begin(), mDeathRecipients.end(),
387 [](const sp<TransferDeathRecipient>& tdr) {
388 return tdr->getWho() == nullptr;
389 }),
390 mDeathRecipients.end());
391}
392
Jiyong Park4f97a8c2020-11-16 18:11:14 +0900393binder_status_t AIBinder_DeathRecipient::linkToDeath(const sp<IBinder>& binder, void* cookie) {
Steven Moreland901c7452018-09-04 16:17:28 -0700394 CHECK(binder != nullptr);
395
396 std::lock_guard<std::mutex> l(mDeathRecipientsMutex);
397
398 sp<TransferDeathRecipient> recipient =
Steven Moreland64127ca2019-03-13 09:25:44 -0700399 new TransferDeathRecipient(binder, cookie, this, mOnDied);
Steven Moreland901c7452018-09-04 16:17:28 -0700400
Steven Moreland64127ca2019-03-13 09:25:44 -0700401 status_t status = binder->linkToDeath(recipient, cookie, 0 /*flags*/);
Steven Moreland5d62e442018-09-13 15:01:02 -0700402 if (status != STATUS_OK) {
403 return PruneStatusT(status);
Steven Moreland901c7452018-09-04 16:17:28 -0700404 }
405
406 mDeathRecipients.push_back(recipient);
Steven Moreland64127ca2019-03-13 09:25:44 -0700407
408 pruneDeadTransferEntriesLocked();
Steven Moreland5d62e442018-09-13 15:01:02 -0700409 return STATUS_OK;
Steven Moreland901c7452018-09-04 16:17:28 -0700410}
411
Jiyong Park4f97a8c2020-11-16 18:11:14 +0900412binder_status_t AIBinder_DeathRecipient::unlinkToDeath(const sp<IBinder>& binder, void* cookie) {
Steven Moreland901c7452018-09-04 16:17:28 -0700413 CHECK(binder != nullptr);
414
415 std::lock_guard<std::mutex> l(mDeathRecipientsMutex);
416
417 for (auto it = mDeathRecipients.rbegin(); it != mDeathRecipients.rend(); ++it) {
418 sp<TransferDeathRecipient> recipient = *it;
419
Steven Moreland64127ca2019-03-13 09:25:44 -0700420 if (recipient->getCookie() == cookie && recipient->getWho() == binder) {
Steven Moreland901c7452018-09-04 16:17:28 -0700421 mDeathRecipients.erase(it.base() - 1);
422
Steven Moreland64127ca2019-03-13 09:25:44 -0700423 status_t status = binder->unlinkToDeath(recipient, cookie, 0 /*flags*/);
Steven Moreland5d62e442018-09-13 15:01:02 -0700424 if (status != ::android::OK) {
Steven Moreland901c7452018-09-04 16:17:28 -0700425 LOG(ERROR) << __func__
426 << ": removed reference to death recipient but unlink failed.";
427 }
Steven Moreland5d62e442018-09-13 15:01:02 -0700428 return PruneStatusT(status);
Steven Moreland901c7452018-09-04 16:17:28 -0700429 }
430 }
431
Steven Moreland5d62e442018-09-13 15:01:02 -0700432 return STATUS_NAME_NOT_FOUND;
Steven Moreland901c7452018-09-04 16:17:28 -0700433}
434
435// start of C-API methods
436
Steven Moreland2e87adc2018-08-20 19:47:00 -0700437AIBinder* AIBinder_new(const AIBinder_Class* clazz, void* args) {
438 if (clazz == nullptr) {
439 LOG(ERROR) << __func__ << ": Must provide class to construct local binder.";
440 return nullptr;
441 }
442
443 void* userData = clazz->onCreate(args);
444
Steven Moreland71cddc32018-08-30 23:39:22 -0700445 sp<AIBinder> ret = new ABBinder(clazz, userData);
446 ABBinderTag::attach(ret->getBinder());
447
448 AIBinder_incStrong(ret.get());
449 return ret.get();
Steven Moreland2e87adc2018-08-20 19:47:00 -0700450}
451
Steven Moreland5ea54da2018-09-04 13:29:55 -0700452bool AIBinder_isRemote(const AIBinder* binder) {
Steven Moreland2e87adc2018-08-20 19:47:00 -0700453 if (binder == nullptr) {
Steven Moreland56f752a2018-11-05 17:23:37 -0800454 return false;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700455 }
456
457 return binder->isRemote();
458}
459
Steven Moreland65867d72018-09-04 14:22:26 -0700460bool AIBinder_isAlive(const AIBinder* binder) {
461 if (binder == nullptr) {
462 return false;
463 }
464
465 return const_cast<AIBinder*>(binder)->getBinder()->isBinderAlive();
466}
467
468binder_status_t AIBinder_ping(AIBinder* binder) {
469 if (binder == nullptr) {
Steven Moreland5d62e442018-09-13 15:01:02 -0700470 return STATUS_UNEXPECTED_NULL;
Steven Moreland65867d72018-09-04 14:22:26 -0700471 }
472
Steven Moreland5d62e442018-09-13 15:01:02 -0700473 return PruneStatusT(binder->getBinder()->pingBinder());
Steven Moreland65867d72018-09-04 14:22:26 -0700474}
475
Steven Morelanda194c452019-03-04 16:47:07 -0800476binder_status_t AIBinder_dump(AIBinder* binder, int fd, const char** args, uint32_t numArgs) {
477 if (binder == nullptr) {
478 return STATUS_UNEXPECTED_NULL;
479 }
480
481 ABBinder* bBinder = binder->asABBinder();
482 if (bBinder != nullptr) {
483 AIBinder_onDump onDump = binder->getClass()->onDump;
484 if (onDump == nullptr) {
485 return STATUS_OK;
486 }
487 return PruneStatusT(onDump(bBinder, fd, args, numArgs));
488 }
489
490 ::android::Vector<String16> utf16Args;
491 utf16Args.setCapacity(numArgs);
492 for (uint32_t i = 0; i < numArgs; i++) {
493 utf16Args.push(String16(String8(args[i])));
494 }
495
496 status_t status = binder->getBinder()->dump(fd, utf16Args);
497 return PruneStatusT(status);
498}
499
Steven Moreland901c7452018-09-04 16:17:28 -0700500binder_status_t AIBinder_linkToDeath(AIBinder* binder, AIBinder_DeathRecipient* recipient,
501 void* cookie) {
502 if (binder == nullptr || recipient == nullptr) {
503 LOG(ERROR) << __func__ << ": Must provide binder and recipient.";
Steven Moreland5d62e442018-09-13 15:01:02 -0700504 return STATUS_UNEXPECTED_NULL;
Steven Moreland901c7452018-09-04 16:17:28 -0700505 }
506
Steven Moreland5d62e442018-09-13 15:01:02 -0700507 // returns binder_status_t
Steven Moreland64127ca2019-03-13 09:25:44 -0700508 return recipient->linkToDeath(binder->getBinder(), cookie);
Steven Moreland901c7452018-09-04 16:17:28 -0700509}
510
511binder_status_t AIBinder_unlinkToDeath(AIBinder* binder, AIBinder_DeathRecipient* recipient,
512 void* cookie) {
513 if (binder == nullptr || recipient == nullptr) {
514 LOG(ERROR) << __func__ << ": Must provide binder and recipient.";
Steven Moreland5d62e442018-09-13 15:01:02 -0700515 return STATUS_UNEXPECTED_NULL;
Steven Moreland901c7452018-09-04 16:17:28 -0700516 }
517
Steven Moreland5d62e442018-09-13 15:01:02 -0700518 // returns binder_status_t
Steven Moreland64127ca2019-03-13 09:25:44 -0700519 return recipient->unlinkToDeath(binder->getBinder(), cookie);
Steven Moreland901c7452018-09-04 16:17:28 -0700520}
521
Steven Morelandf3034b02018-11-12 17:37:46 -0800522uid_t AIBinder_getCallingUid() {
523 return ::android::IPCThreadState::self()->getCallingUid();
524}
525
526pid_t AIBinder_getCallingPid() {
527 return ::android::IPCThreadState::self()->getCallingPid();
528}
529
Steven Moreland2e87adc2018-08-20 19:47:00 -0700530void AIBinder_incStrong(AIBinder* binder) {
531 if (binder == nullptr) {
Steven Moreland2e87adc2018-08-20 19:47:00 -0700532 return;
533 }
534
535 binder->incStrong(nullptr);
536}
537void AIBinder_decStrong(AIBinder* binder) {
538 if (binder == nullptr) {
539 LOG(ERROR) << __func__ << ": on null binder";
540 return;
541 }
542
543 binder->decStrong(nullptr);
544}
545int32_t AIBinder_debugGetRefCount(AIBinder* binder) {
546 if (binder == nullptr) {
547 LOG(ERROR) << __func__ << ": on null binder";
548 return -1;
549 }
550
551 return binder->getStrongCount();
552}
553
Steven Moreland71cddc32018-08-30 23:39:22 -0700554bool AIBinder_associateClass(AIBinder* binder, const AIBinder_Class* clazz) {
555 if (binder == nullptr) {
556 return false;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700557 }
558
Steven Moreland71cddc32018-08-30 23:39:22 -0700559 return binder->associateClass(clazz);
Steven Moreland2e87adc2018-08-20 19:47:00 -0700560}
561
562const AIBinder_Class* AIBinder_getClass(AIBinder* binder) {
563 if (binder == nullptr) {
564 return nullptr;
565 }
566
567 return binder->getClass();
568}
569
570void* AIBinder_getUserData(AIBinder* binder) {
571 if (binder == nullptr) {
572 return nullptr;
573 }
574
575 ABBinder* bBinder = binder->asABBinder();
576 if (bBinder == nullptr) {
577 return nullptr;
578 }
579
580 return bBinder->getUserData();
581}
582
583binder_status_t AIBinder_prepareTransaction(AIBinder* binder, AParcel** in) {
584 if (binder == nullptr || in == nullptr) {
585 LOG(ERROR) << __func__ << ": requires non-null parameters.";
Steven Moreland5d62e442018-09-13 15:01:02 -0700586 return STATUS_UNEXPECTED_NULL;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700587 }
588 const AIBinder_Class* clazz = binder->getClass();
589 if (clazz == nullptr) {
590 LOG(ERROR) << __func__
591 << ": Class must be defined for a remote binder transaction. See "
592 "AIBinder_associateClass.";
Steven Moreland5d62e442018-09-13 15:01:02 -0700593 return STATUS_INVALID_OPERATION;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700594 }
595
596 *in = new AParcel(binder);
Steven Moreland1fda67b2021-04-02 18:35:50 +0000597 (*in)->get()->markForBinder(binder->getBinder());
598
Steven Morelandf18615b2018-09-14 11:43:06 -0700599 status_t status = (*in)->get()->writeInterfaceToken(clazz->getInterfaceDescriptor());
Steven Moreland5d62e442018-09-13 15:01:02 -0700600 binder_status_t ret = PruneStatusT(status);
601
602 if (ret != STATUS_OK) {
Steven Moreland2e87adc2018-08-20 19:47:00 -0700603 delete *in;
604 *in = nullptr;
605 }
606
Steven Moreland5d62e442018-09-13 15:01:02 -0700607 return ret;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700608}
609
Steven Moreland9b80e282018-09-19 13:57:23 -0700610static void DestroyParcel(AParcel** parcel) {
611 delete *parcel;
612 *parcel = nullptr;
613}
614
Steven Moreland2e87adc2018-08-20 19:47:00 -0700615binder_status_t AIBinder_transact(AIBinder* binder, transaction_code_t code, AParcel** in,
616 AParcel** out, binder_flags_t flags) {
617 if (in == nullptr) {
618 LOG(ERROR) << __func__ << ": requires non-null in parameter";
Steven Moreland5d62e442018-09-13 15:01:02 -0700619 return STATUS_UNEXPECTED_NULL;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700620 }
621
Steven Morelandcaa776c2018-09-04 13:48:11 -0700622 using AutoParcelDestroyer = std::unique_ptr<AParcel*, void (*)(AParcel**)>;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700623 // This object is the input to the transaction. This function takes ownership of it and deletes
624 // it.
Steven Moreland9b80e282018-09-19 13:57:23 -0700625 AutoParcelDestroyer forIn(in, DestroyParcel);
Steven Moreland2e87adc2018-08-20 19:47:00 -0700626
627 if (!isUserCommand(code)) {
628 LOG(ERROR) << __func__ << ": Only user-defined transactions can be made from the NDK.";
Steven Moreland5d62e442018-09-13 15:01:02 -0700629 return STATUS_UNKNOWN_TRANSACTION;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700630 }
631
Steven Morelandf183fdd2020-10-27 00:12:12 +0000632 constexpr binder_flags_t kAllFlags = FLAG_PRIVATE_VENDOR | FLAG_ONEWAY | FLAG_CLEAR_BUF;
Steven Moreland46b5fea2019-10-15 11:22:18 -0700633 if ((flags & ~kAllFlags) != 0) {
Steven Moreland2e87adc2018-08-20 19:47:00 -0700634 LOG(ERROR) << __func__ << ": Unrecognized flags sent: " << flags;
Steven Moreland5d62e442018-09-13 15:01:02 -0700635 return STATUS_BAD_VALUE;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700636 }
637
638 if (binder == nullptr || *in == nullptr || out == nullptr) {
639 LOG(ERROR) << __func__ << ": requires non-null parameters.";
Steven Moreland5d62e442018-09-13 15:01:02 -0700640 return STATUS_UNEXPECTED_NULL;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700641 }
642
643 if ((*in)->getBinder() != binder) {
644 LOG(ERROR) << __func__ << ": parcel is associated with binder object " << binder
645 << " but called with " << (*in)->getBinder();
Steven Moreland5d62e442018-09-13 15:01:02 -0700646 return STATUS_BAD_VALUE;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700647 }
648
649 *out = new AParcel(binder);
650
Steven Morelandf18615b2018-09-14 11:43:06 -0700651 status_t status = binder->getBinder()->transact(code, *(*in)->get(), (*out)->get(), flags);
Steven Moreland5d62e442018-09-13 15:01:02 -0700652 binder_status_t ret = PruneStatusT(status);
Steven Moreland2e87adc2018-08-20 19:47:00 -0700653
Steven Moreland5d62e442018-09-13 15:01:02 -0700654 if (ret != STATUS_OK) {
Steven Moreland2e87adc2018-08-20 19:47:00 -0700655 delete *out;
656 *out = nullptr;
657 }
658
Steven Moreland5d62e442018-09-13 15:01:02 -0700659 return ret;
Steven Moreland2e87adc2018-08-20 19:47:00 -0700660}
Steven Moreland901c7452018-09-04 16:17:28 -0700661
662AIBinder_DeathRecipient* AIBinder_DeathRecipient_new(
663 AIBinder_DeathRecipient_onBinderDied onBinderDied) {
664 if (onBinderDied == nullptr) {
665 LOG(ERROR) << __func__ << ": requires non-null onBinderDied parameter.";
666 return nullptr;
667 }
Steven Moreland64127ca2019-03-13 09:25:44 -0700668 auto ret = new AIBinder_DeathRecipient(onBinderDied);
669 ret->incStrong(nullptr);
670 return ret;
Steven Moreland901c7452018-09-04 16:17:28 -0700671}
672
Steven Moreland9b80e282018-09-19 13:57:23 -0700673void AIBinder_DeathRecipient_delete(AIBinder_DeathRecipient* recipient) {
Steven Moreland64127ca2019-03-13 09:25:44 -0700674 if (recipient == nullptr) {
675 return;
676 }
677
678 recipient->decStrong(nullptr);
Steven Moreland901c7452018-09-04 16:17:28 -0700679}
Steven Morelandea14ef22019-08-20 10:50:08 -0700680
681binder_status_t AIBinder_getExtension(AIBinder* binder, AIBinder** outExt) {
682 if (binder == nullptr || outExt == nullptr) {
683 if (outExt != nullptr) {
684 *outExt = nullptr;
685 }
686 return STATUS_UNEXPECTED_NULL;
687 }
688
689 sp<IBinder> ext;
690 status_t res = binder->getBinder()->getExtension(&ext);
691
692 if (res != android::OK) {
693 *outExt = nullptr;
694 return PruneStatusT(res);
695 }
696
697 sp<AIBinder> ret = ABpBinder::lookupOrCreateFromBinder(ext);
698 if (ret != nullptr) ret->incStrong(binder);
699
700 *outExt = ret.get();
701 return STATUS_OK;
702}
703
704binder_status_t AIBinder_setExtension(AIBinder* binder, AIBinder* ext) {
705 if (binder == nullptr || ext == nullptr) {
706 return STATUS_UNEXPECTED_NULL;
707 }
708
709 ABBinder* rawBinder = binder->asABBinder();
710 if (rawBinder == nullptr) {
711 return STATUS_INVALID_OPERATION;
712 }
713
714 rawBinder->setExtension(ext->getBinder());
715 return STATUS_OK;
716}
Steven Moreland2f405f52020-07-08 22:24:29 +0000717
718// platform methods follow
719
720void AIBinder_setRequestingSid(AIBinder* binder, bool requestingSid) {
721 ABBinder* localBinder = binder->asABBinder();
722 if (localBinder == nullptr) {
723 LOG(FATAL) << "AIBinder_setRequestingSid must be called on a local binder";
724 }
725
726 localBinder->setRequestingSid(requestingSid);
727}
728
729const char* AIBinder_getCallingSid() {
730 return ::android::IPCThreadState::self()->getCallingSid();
731}
Steven Morelandb2de9532020-05-29 21:44:41 +0000732
733android::sp<android::IBinder> AIBinder_toPlatformBinder(AIBinder* binder) {
734 if (binder == nullptr) return nullptr;
735 return binder->getBinder();
736}
737
738AIBinder* AIBinder_fromPlatformBinder(const android::sp<android::IBinder>& binder) {
739 sp<AIBinder> ndkBinder = ABpBinder::lookupOrCreateFromBinder(binder);
740 AIBinder_incStrong(ndkBinder.get());
741 return ndkBinder.get();
742}