Parcel.h revision 06673e38983baad380e818c5493b7faccf3b2393
1edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project/* 2edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Copyright (C) 2005 The Android Open Source Project 3edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 4edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * you may not use this file except in compliance with the License. 6edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * You may obtain a copy of the License at 7edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 8edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 10edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * See the License for the specific language governing permissions and 14edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * limitations under the License. 15edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 16edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 17edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#ifndef ANDROID_PARCEL_H 18edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#define ANDROID_PARCEL_H 19edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 20451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin#include <vector> 21451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin 22edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <cutils/native_handle.h> 2306673e38983baad380e818c5493b7faccf3b2393Casey Dahlin#include <nativehelper/ScopedFd.h> 24edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <utils/Errors.h> 25edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <utils/RefBase.h> 26edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <utils/String16.h> 27edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <utils/Vector.h> 288683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian#include <utils/Flattenable.h> 2984e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevåg#include <linux/binder.h> 30edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 31f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin#include <binder/IInterface.h> 3297f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley#include <binder/Parcelable.h> 33f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin 34edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 35edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectnamespace android { 36edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 37e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopiantemplate <typename T> class Flattenable; 388683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopiantemplate <typename T> class LightFlattenable; 39edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass IBinder; 4070081a1511955f53bd0ed7f2aec9a1bf09f0f379Brad Fitzpatrickclass IPCThreadState; 41edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass ProcessState; 42edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass String8; 43edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass TextOutput; 44edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 45e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopianclass Parcel { 46f683e0163a84d93448b9388126902242367cd961Serban Constantinescu friend class IPCThreadState; 47edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 485707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown class ReadableBlob; 495707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown class WritableBlob; 505707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 51edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Parcel(); 52edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project ~Parcel(); 53edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 54edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const uint8_t* data() const; 55edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t dataSize() const; 56edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t dataAvail() const; 57edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t dataPosition() const; 58edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t dataCapacity() const; 598938ed2c8e906fc332301b64787728d4d34da571Dianne Hackborn 60edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setDataSize(size_t size); 61edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void setDataPosition(size_t pos) const; 62edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setDataCapacity(size_t size); 63edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 64edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setData(const uint8_t* buffer, size_t len); 65edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 6651faf46e2958c57dab46d9420e585319125c7c42Andreas Huber status_t appendFrom(const Parcel *parcel, 6751faf46e2958c57dab46d9420e585319125c7c42Andreas Huber size_t start, size_t len); 68edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 6913b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown bool allowFds() const; 707746cc318829358bb2c4dc0a03d40a7856a6d13eDianne Hackborn bool pushAllowFds(bool allowFds); 717746cc318829358bb2c4dc0a03d40a7856a6d13eDianne Hackborn void restoreAllowFds(bool lastValue); 728938ed2c8e906fc332301b64787728d4d34da571Dianne Hackborn 73edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project bool hasFileDescriptors() const; 74edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 75702ea9d42f52fc145090c0f0bfbe64993e4b8b33Brad Fitzpatrick // Writes the RPC header. 76edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeInterfaceToken(const String16& interface); 77a877cd85b5a026384542e3271fc310d6a8fe24c6Brad Fitzpatrick 78702ea9d42f52fc145090c0f0bfbe64993e4b8b33Brad Fitzpatrick // Parses the RPC header, returning true if the interface name 79702ea9d42f52fc145090c0f0bfbe64993e4b8b33Brad Fitzpatrick // in the header matches the expected interface from the caller. 8070081a1511955f53bd0ed7f2aec9a1bf09f0f379Brad Fitzpatrick // 8170081a1511955f53bd0ed7f2aec9a1bf09f0f379Brad Fitzpatrick // Additionally, enforceInterface does part of the work of 8270081a1511955f53bd0ed7f2aec9a1bf09f0f379Brad Fitzpatrick // propagating the StrictMode policy mask, populating the current 8370081a1511955f53bd0ed7f2aec9a1bf09f0f379Brad Fitzpatrick // IPCThreadState, which as an optimization may optionally be 8470081a1511955f53bd0ed7f2aec9a1bf09f0f379Brad Fitzpatrick // passed in. 85a877cd85b5a026384542e3271fc310d6a8fe24c6Brad Fitzpatrick bool enforceInterface(const String16& interface, 8670081a1511955f53bd0ed7f2aec9a1bf09f0f379Brad Fitzpatrick IPCThreadState* threadState = NULL) const; 87702ea9d42f52fc145090c0f0bfbe64993e4b8b33Brad Fitzpatrick bool checkInterface(IBinder*) const; 8883c0446f27b9542d6c2e724817b2b2d8d1f55085Mathias Agopian 89edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void freeData(); 90edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 9184e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevågprivate: 9284e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevåg const binder_size_t* objects() const; 9384e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevåg 9484e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevågpublic: 95edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t objectsCount() const; 96edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 97edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t errorCheck() const; 98edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void setError(status_t err); 99edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 100edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t write(const void* data, size_t len); 101edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void* writeInplace(size_t len); 102edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeUnpadded(const void* data, size_t len); 103edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeInt32(int32_t val); 10441a0f2f86c0ca7d2fef50aef6215987f445a7231Dan Stoza status_t writeUint32(uint32_t val); 105edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeInt64(int64_t val); 1062d13afdfa1f43973bf3cb917c7d6496a38baa446Ronghua Wu status_t writeUint64(uint64_t val); 107edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeFloat(float val); 108edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeDouble(double val); 109edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeCString(const char* str); 110edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeString8(const String8& str); 111edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeString16(const String16& str); 112edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeString16(const char16_t* str, size_t len); 113edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeStrongBinder(const sp<IBinder>& val); 114edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeWeakBinder(const wp<IBinder>& val); 1155c0106e134366312206702f1b072347e20c90374Marco Nelissen status_t writeInt32Array(size_t len, const int32_t *val); 116f0190bff38b6c29abbfc4a877442f71fc3d7dad8Marco Nelissen status_t writeByteArray(size_t len, const uint8_t *val); 117d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin status_t writeBool(bool val); 118d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin status_t writeChar(char16_t val); 119d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin status_t writeByte(int8_t val); 120e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian 121451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t writeByteVector(const std::vector<int8_t>& val); 122451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t writeInt32Vector(const std::vector<int32_t>& val); 123451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t writeInt64Vector(const std::vector<int64_t>& val); 124451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t writeFloatVector(const std::vector<float>& val); 125451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t writeDoubleVector(const std::vector<double>& val); 126451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t writeBoolVector(const std::vector<bool>& val); 127451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t writeCharVector(const std::vector<char16_t>& val); 128451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t writeString16Vector(const std::vector<String16>& val); 129451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin 130eb8e15f9bb29f8794f8be819530631c358fd6a15Casey Dahlin status_t writeStrongBinderVector(const std::vector<sp<IBinder>>& val); 131eb8e15f9bb29f8794f8be819530631c358fd6a15Casey Dahlin 132e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian template<typename T> 13397f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley status_t writeParcelableVector(const std::vector<T>& val); 13497f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley status_t writeParcelable(const Parcelable& parcelable); 13597f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley 13697f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley template<typename T> 137e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian status_t write(const Flattenable<T>& val); 138edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1398683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian template<typename T> 1408683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian status_t write(const LightFlattenable<T>& val); 1418683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian 1428683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian 143a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian // Place a native_handle into the parcel (the native_handle's file- 144a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian // descriptors are dup'ed, so it is safe to delete the native_handle 145451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin // when this function returns). 146a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian // Doesn't take ownership of the native_handle. 147a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian status_t writeNativeHandle(const native_handle* handle); 148edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 149edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Place a file descriptor into the parcel. The given fd must remain 150edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // valid for the lifetime of the parcel. 15193ff1f985e233fe04412a65041e977c9f0c21f5bJeff Brown // The Parcel does not take ownership of the given fd unless you ask it to. 15293ff1f985e233fe04412a65041e977c9f0c21f5bJeff Brown status_t writeFileDescriptor(int fd, bool takeOwnership = false); 153edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 154edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Place a file descriptor into the parcel. A dup of the fd is made, which 155edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // will be closed once the parcel is destroyed. 156edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeDupFileDescriptor(int fd); 1575707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 15806673e38983baad380e818c5493b7faccf3b2393Casey Dahlin // Place a file descriptor into the parcel. This will not affect the 15906673e38983baad380e818c5493b7faccf3b2393Casey Dahlin // semantics of the smart file descriptor. A new descriptor will be 16006673e38983baad380e818c5493b7faccf3b2393Casey Dahlin // created, and will be closed when the parcel is destroyed. 16106673e38983baad380e818c5493b7faccf3b2393Casey Dahlin status_t writeUniqueFileDescriptor( 16206673e38983baad380e818c5493b7faccf3b2393Casey Dahlin const ScopedFd& fd); 16306673e38983baad380e818c5493b7faccf3b2393Casey Dahlin 16406673e38983baad380e818c5493b7faccf3b2393Casey Dahlin // Place a vector of file desciptors into the parcel. Each descriptor is 16506673e38983baad380e818c5493b7faccf3b2393Casey Dahlin // dup'd as in writeDupFileDescriptor 16606673e38983baad380e818c5493b7faccf3b2393Casey Dahlin status_t writeUniqueFileDescriptorVector( 16706673e38983baad380e818c5493b7faccf3b2393Casey Dahlin const std::vector<ScopedFd>& val); 16806673e38983baad380e818c5493b7faccf3b2393Casey Dahlin 1695707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown // Writes a blob to the parcel. 1705707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown // If the blob is small, then it is stored in-place, otherwise it is 17113b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown // transferred by way of an anonymous shared memory region. Prefer sending 17213b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown // immutable blobs if possible since they may be subsequently transferred between 17313b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown // processes without further copying whereas mutable blobs always need to be copied. 1745707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown // The caller should call release() on the blob after writing its contents. 17513b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown status_t writeBlob(size_t len, bool mutableCopy, WritableBlob* outBlob); 17613b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown 17713b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown // Write an existing immutable blob file descriptor to the parcel. 17813b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown // This allows the client to send the same blob to multiple processes 17913b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown // as long as it keeps a dup of the blob file descriptor handy for later. 18013b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown status_t writeDupImmutableBlobFileDescriptor(int fd); 1815707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 182edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t writeObject(const flat_binder_object& val, bool nullMetaData); 183edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 184837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick // Like Parcel.java's writeNoException(). Just writes a zero int32. 185837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick // Currently the native implementation doesn't do any of the StrictMode 186837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick // stack gathering and serialization that the Java implementation does. 187837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick status_t writeNoException(); 188837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick 189edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void remove(size_t start, size_t amt); 190edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 191edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t read(void* outData, size_t len) const; 192edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const void* readInplace(size_t len) const; 193edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project int32_t readInt32() const; 194edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t readInt32(int32_t *pArg) const; 19541a0f2f86c0ca7d2fef50aef6215987f445a7231Dan Stoza uint32_t readUint32() const; 19641a0f2f86c0ca7d2fef50aef6215987f445a7231Dan Stoza status_t readUint32(uint32_t *pArg) const; 197edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project int64_t readInt64() const; 198edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t readInt64(int64_t *pArg) const; 1992d13afdfa1f43973bf3cb917c7d6496a38baa446Ronghua Wu uint64_t readUint64() const; 2002d13afdfa1f43973bf3cb917c7d6496a38baa446Ronghua Wu status_t readUint64(uint64_t *pArg) const; 201edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float readFloat() const; 202edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t readFloat(float *pArg) const; 203edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project double readDouble() const; 204edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t readDouble(double *pArg) const; 20584a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber intptr_t readIntPtr() const; 20684a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber status_t readIntPtr(intptr_t *pArg) const; 207d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin bool readBool() const; 208d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin status_t readBool(bool *pArg) const; 209d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin char16_t readChar() const; 210d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin status_t readChar(char16_t *pArg) const; 211d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin int8_t readByte() const; 212d6848f52e60be17b7f0992be7827dcae4ea2efb1Casey Dahlin status_t readByte(int8_t *pArg) const; 213edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 214edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const char* readCString() const; 215edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project String8 readString8() const; 216edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project String16 readString16() const; 217451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readString16(String16* pArg) const; 218edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const char16_t* readString16Inplace(size_t* outLen) const; 219edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project sp<IBinder> readStrongBinder() const; 220f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin status_t readStrongBinder(sp<IBinder>* val) const; 221edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project wp<IBinder> readWeakBinder() const; 222e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian 223f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin template<typename T> 22497f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley status_t readParcelableVector(std::vector<T>* val) const; 22597f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley status_t readParcelable(Parcelable* parcelable) const; 22697f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley 22797f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley template<typename T> 228eb8e15f9bb29f8794f8be819530631c358fd6a15Casey Dahlin status_t readStrongBinder(sp<T>* val) const; 229eb8e15f9bb29f8794f8be819530631c358fd6a15Casey Dahlin 230eb8e15f9bb29f8794f8be819530631c358fd6a15Casey Dahlin status_t readStrongBinderVector(std::vector<sp<IBinder>>* val) const; 231f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin 232451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readByteVector(std::vector<int8_t>* val) const; 233451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readInt32Vector(std::vector<int32_t>* val) const; 234451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readInt64Vector(std::vector<int64_t>* val) const; 235451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readFloatVector(std::vector<float>* val) const; 236451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readDoubleVector(std::vector<double>* val) const; 237451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readBoolVector(std::vector<bool>* val) const; 238451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readCharVector(std::vector<char16_t>* val) const; 239451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin status_t readString16Vector(std::vector<String16>* val) const; 240451ff582d730e27f4e22d9f158f8ee24d1bc2729Casey Dahlin 241e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian template<typename T> 242e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian status_t read(Flattenable<T>& val) const; 243837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick 2448683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian template<typename T> 2458683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian status_t read(LightFlattenable<T>& val) const; 2468683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian 247837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick // Like Parcel.java's readExceptionCode(). Reads the first int32 248837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick // off of a Parcel's header, returning 0 or the negative error 249837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick // code on exceptions, but also deals with skipping over rich 250837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick // response headers. Callers should use this to read & parse the 251837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick // response headers rather than doing it by hand. 252837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick int32_t readExceptionCode() const; 253837a0d0fb2c3fba8082d47d04cb6120af1eb9a54Brad Fitzpatrick 254a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian // Retrieve native_handle from the parcel. This returns a copy of the 255a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian // parcel's native_handle (the caller takes ownership). The caller 256a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian // must free the native_handle with native_handle_close() and 257a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian // native_handle_delete(). 258a47f02afb1e1f2c4abd9379c13903a5dde89d354Mathias Agopian native_handle* readNativeHandle() const; 259edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 260edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 261edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Retrieve a file descriptor from the parcel. This returns the raw fd 262edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // in the parcel, which you do not own -- use dup() to get your own copy. 263edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project int readFileDescriptor() const; 2645707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 26506673e38983baad380e818c5493b7faccf3b2393Casey Dahlin // Retrieve a smart file descriptor from the parcel. 26606673e38983baad380e818c5493b7faccf3b2393Casey Dahlin status_t readUniqueFileDescriptor( 26706673e38983baad380e818c5493b7faccf3b2393Casey Dahlin ScopedFd* val) const; 26806673e38983baad380e818c5493b7faccf3b2393Casey Dahlin 26906673e38983baad380e818c5493b7faccf3b2393Casey Dahlin 27006673e38983baad380e818c5493b7faccf3b2393Casey Dahlin // Retrieve a vector of smart file descriptors from the parcel. 27106673e38983baad380e818c5493b7faccf3b2393Casey Dahlin status_t readUniqueFileDescriptorVector( 27206673e38983baad380e818c5493b7faccf3b2393Casey Dahlin std::vector<ScopedFd>* val) const; 27306673e38983baad380e818c5493b7faccf3b2393Casey Dahlin 2745707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown // Reads a blob from the parcel. 2755707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown // The caller should call release() on the blob after reading its contents. 2765707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown status_t readBlob(size_t len, ReadableBlob* outBlob) const; 2775707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 278edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const flat_binder_object* readObject(bool nullMetaData) const; 279edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 280edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Explicitly close all file descriptors in the parcel. 281edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void closeFileDescriptors(); 2827e790af756d7891cb1cf1374bb283a8fbcbe6b49Dianne Hackborn 2837e790af756d7891cb1cf1374bb283a8fbcbe6b49Dianne Hackborn // Debugging: get metrics on current allocations. 2847e790af756d7891cb1cf1374bb283a8fbcbe6b49Dianne Hackborn static size_t getGlobalAllocSize(); 2857e790af756d7891cb1cf1374bb283a8fbcbe6b49Dianne Hackborn static size_t getGlobalAllocCount(); 2867e790af756d7891cb1cf1374bb283a8fbcbe6b49Dianne Hackborn 28784e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevågprivate: 288edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project typedef void (*release_func)(Parcel* parcel, 289edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const uint8_t* data, size_t dataSize, 29084e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevåg const binder_size_t* objects, size_t objectsSize, 291edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void* cookie); 292edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 29384e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevåg uintptr_t ipcData() const; 294edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t ipcDataSize() const; 29584e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevåg uintptr_t ipcObjects() const; 296edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t ipcObjectsCount() const; 297edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void ipcSetDataReference(const uint8_t* data, size_t dataSize, 29884e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevåg const binder_size_t* objects, size_t objectsCount, 299edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project release_func relFunc, void* relCookie); 300edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 30184e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevågpublic: 302edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void print(TextOutput& to, uint32_t flags = 0) const; 3035707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 304edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectprivate: 305edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Parcel(const Parcel& o); 306edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Parcel& operator=(const Parcel& o); 307edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 308edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t finishWrite(size_t len); 309edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void releaseObjects(); 310edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void acquireObjects(); 311edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t growData(size_t len); 312edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t restartWrite(size_t desired); 313edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t continueWrite(size_t desired); 314f683e0163a84d93448b9388126902242367cd961Serban Constantinescu status_t writePointer(uintptr_t val); 315f683e0163a84d93448b9388126902242367cd961Serban Constantinescu status_t readPointer(uintptr_t *pArg) const; 316f683e0163a84d93448b9388126902242367cd961Serban Constantinescu uintptr_t readPointer() const; 317edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void freeDataNoInit(); 318edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void initState(); 319edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void scanForFds() const; 320edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 32184a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber template<class T> 32284a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber status_t readAligned(T *pArg) const; 32384a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber 32484a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber template<class T> T readAligned() const; 32584a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber 32684a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber template<class T> 32784a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber status_t writeAligned(T val); 32884a6d041e2c69d4d0b69269a0b59e725c9f119a3Andreas Huber 32903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley template<typename T, typename U> 33003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t unsafeReadTypedVector(std::vector<T>* val, 33103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*read_func)(U*) const) const; 33203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley template<typename T> 33303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t readTypedVector(std::vector<T>* val, 33403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*read_func)(T*) const) const; 33503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley template<typename T, typename U> 33603d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t unsafeWriteTypedVector(const std::vector<T>& val, 33703d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*write_func)(U)); 33803d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley template<typename T> 33903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t writeTypedVector(const std::vector<T>& val, 34003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*write_func)(const T&)); 34103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley template<typename T> 34203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t writeTypedVector(const std::vector<T>& val, 34303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*write_func)(T)); 34403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 345edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t mError; 346edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint8_t* mData; 347edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t mDataSize; 348edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t mDataCapacity; 349edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project mutable size_t mDataPos; 35084e625ac1e01f5a9c3ed16664da6498212ed662bArve Hjønnevåg binder_size_t* mObjects; 351edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t mObjectsSize; 352edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t mObjectsCapacity; 353edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project mutable size_t mNextObjectHint; 354edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 355edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project mutable bool mFdsKnown; 356edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project mutable bool mHasFds; 3578938ed2c8e906fc332301b64787728d4d34da571Dianne Hackborn bool mAllowFds; 358edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 359edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project release_func mOwner; 360edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void* mOwnerCookie; 3615707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 3625707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown class Blob { 3635707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown public: 3645707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown Blob(); 3655707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown ~Blob(); 3665707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 36713b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown void clear(); 3685707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown void release(); 3695707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown inline size_t size() const { return mSize; } 37013b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown inline int fd() const { return mFd; }; 37113b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown inline bool isMutable() const { return mMutable; } 3725707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 3735707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown protected: 37413b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown void init(int fd, void* data, size_t size, bool isMutable); 3755707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 37613b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown int mFd; // owned by parcel so not closed when released 3775707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown void* mData; 3785707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown size_t mSize; 37913b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown bool mMutable; 3805707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown }; 3815707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 382e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian class FlattenableHelperInterface { 383e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian protected: 384e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian ~FlattenableHelperInterface() { } 385e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian public: 386e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian virtual size_t getFlattenedSize() const = 0; 387e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian virtual size_t getFdCount() const = 0; 388e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian virtual status_t flatten(void* buffer, size_t size, int* fds, size_t count) const = 0; 389e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian virtual status_t unflatten(void const* buffer, size_t size, int const* fds, size_t count) = 0; 390e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian }; 391e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian 392e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian template<typename T> 393e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian class FlattenableHelper : public FlattenableHelperInterface { 394e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian friend class Parcel; 395e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian const Flattenable<T>& val; 396e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian explicit FlattenableHelper(const Flattenable<T>& val) : val(val) { } 397e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian 398e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian public: 399e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian virtual size_t getFlattenedSize() const { 400e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian return val.getFlattenedSize(); 401e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian } 402e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian virtual size_t getFdCount() const { 403e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian return val.getFdCount(); 404e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian } 405e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian virtual status_t flatten(void* buffer, size_t size, int* fds, size_t count) const { 406e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian return val.flatten(buffer, size, fds, count); 407e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian } 408e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian virtual status_t unflatten(void const* buffer, size_t size, int const* fds, size_t count) { 409e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian return const_cast<Flattenable<T>&>(val).unflatten(buffer, size, fds, count); 410e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian } 411e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian }; 412e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian status_t write(const FlattenableHelperInterface& val); 413e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian status_t read(FlattenableHelperInterface& val) const; 414e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian 4155707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brownpublic: 4165707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown class ReadableBlob : public Blob { 4175707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown friend class Parcel; 4185707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown public: 4195707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown inline const void* data() const { return mData; } 42013b1604018968408bcc5553e1fa5ea9df3e4e009Jeff Brown inline void* mutableData() { return isMutable() ? mData : NULL; } 4215707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown }; 4225707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown 4235707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown class WritableBlob : public Blob { 4245707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown friend class Parcel; 4255707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown public: 4265707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown inline void* data() { return mData; } 4275707dbf15d0b44c88fbaa6dd271097f2d42932e0Jeff Brown }; 428aa5c2346c7291465aaca53f59878582dccbe4835Dan Sandler 429aa5c2346c7291465aaca53f59878582dccbe4835Dan Sandlerprivate: 430aa5c2346c7291465aaca53f59878582dccbe4835Dan Sandler size_t mBlobAshmemSize; 431aa5c2346c7291465aaca53f59878582dccbe4835Dan Sandler 432aa5c2346c7291465aaca53f59878582dccbe4835Dan Sandlerpublic: 433aa5c2346c7291465aaca53f59878582dccbe4835Dan Sandler size_t getBlobAshmemSize() const; 434edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 435edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 436edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 437edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 4388683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopiantemplate<typename T> 439e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopianstatus_t Parcel::write(const Flattenable<T>& val) { 440e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian const FlattenableHelper<T> helper(val); 441e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian return write(helper); 442e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian} 443e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian 444e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopiantemplate<typename T> 4458683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopianstatus_t Parcel::write(const LightFlattenable<T>& val) { 446e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian size_t size(val.getFlattenedSize()); 4478683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian if (!val.isFixedSize()) { 4488683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian status_t err = writeInt32(size); 4498683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian if (err != NO_ERROR) { 4508683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian return err; 4518683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian } 4528683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian } 4532098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian if (size) { 4542098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian void* buffer = writeInplace(size); 455e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian if (buffer == NULL) 456e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian return NO_MEMORY; 457e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian return val.flatten(buffer, size); 4582098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian } 4592098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian return NO_ERROR; 4608683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian} 4618683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian 4628683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopiantemplate<typename T> 463e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopianstatus_t Parcel::read(Flattenable<T>& val) const { 464e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian FlattenableHelper<T> helper(val); 465e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian return read(helper); 466e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian} 467e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian 468e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopiantemplate<typename T> 4698683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopianstatus_t Parcel::read(LightFlattenable<T>& val) const { 4708683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian size_t size; 4718683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian if (val.isFixedSize()) { 472e142428a9c8b9d2380032cd4d7b55ee440fe8770Mathias Agopian size = val.getFlattenedSize(); 4738683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian } else { 4748683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian int32_t s; 4758683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian status_t err = readInt32(&s); 4768683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian if (err != NO_ERROR) { 4778683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian return err; 4788683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian } 4798683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian size = s; 4808683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian } 4812098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian if (size) { 4822098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian void const* buffer = readInplace(size); 4832098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian return buffer == NULL ? NO_MEMORY : 4842098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian val.unflatten(buffer, size); 4852098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian } 4862098517e3e12a401005d7a7510d6c4943707b98dMathias Agopian return NO_ERROR; 4878683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian} 4888683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian 489f0c13772d95486d98f034361883b2415bb26a614Casey Dahlintemplate<typename T> 490f0c13772d95486d98f034361883b2415bb26a614Casey Dahlinstatus_t Parcel::readStrongBinder(sp<T>* val) const { 491f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin sp<IBinder> tmp; 492f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin status_t ret = readStrongBinder(&tmp); 493f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin 494f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin if (ret == OK) { 495f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin *val = interface_cast<T>(tmp); 496f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin 497f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin if (val->get() == nullptr) { 498f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin return UNKNOWN_ERROR; 499f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin } 500f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin } 501f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin 502f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin return ret; 503f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin} 504f0c13772d95486d98f034361883b2415bb26a614Casey Dahlin 50503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileytemplate<typename T, typename U> 50603d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileystatus_t Parcel::unsafeReadTypedVector( 50703d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley std::vector<T>* val, status_t(Parcel::*read_func)(U*) const) const { 50803d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley val->clear(); 50903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 51003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley int32_t size; 51103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t status = this->readInt32(&size); 51203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 51303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley if (status != OK) { 51403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return status; 51503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley } 51603d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 51703d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley if (size < 0) { 51803d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return UNEXPECTED_NULL; 51903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley } 52003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 52103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley val->resize(size); 52203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 52303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley for (auto& v: *val) { 52403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status = (this->*read_func)(&v); 52503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 52603d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley if (status != OK) { 52703d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return status; 52803d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley } 52903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley } 53003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 53103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return OK; 53203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley} 53303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 53403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileytemplate<typename T> 53503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileystatus_t Parcel::readTypedVector(std::vector<T>* val, 53603d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*read_func)(T*) const) const { 53703d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return unsafeReadTypedVector(val, read_func); 53803d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley} 53903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 54003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileytemplate<typename T, typename U> 54103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileystatus_t Parcel::unsafeWriteTypedVector(const std::vector<T>& val, 54203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*write_func)(U)) { 54303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley if (val.size() > std::numeric_limits<int32_t>::max()) { 54403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return BAD_VALUE; 54503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley } 54603d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 54703d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t status = this->writeInt32(val.size()); 54803d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 54903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley if (status != OK) { 55003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return status; 55103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley } 55203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 55303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley for (const auto& item : val) { 55403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status = (this->*write_func)(item); 55503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 55603d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley if (status != OK) { 55703d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return status; 55803d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley } 55903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley } 56003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 56103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return OK; 56203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley} 56303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 56403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileytemplate<typename T> 56503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileystatus_t Parcel::writeTypedVector(const std::vector<T>& val, 56603d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*write_func)(const T&)) { 56703d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return unsafeWriteTypedVector(val, write_func); 56803d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley} 56903d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 57003d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileytemplate<typename T> 57103d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wileystatus_t Parcel::writeTypedVector(const std::vector<T>& val, 57203d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley status_t(Parcel::*write_func)(T)) { 57303d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley return unsafeWriteTypedVector(val, write_func); 57403d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley} 57503d1eb6bf90bcd0a04b176988478d2e939d3fba0Christopher Wiley 57697f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wileytemplate<typename T> 57797f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wileystatus_t Parcel::readParcelableVector(std::vector<T>* val) const { 57897f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley return unsafeReadTypedVector(val, &Parcel::readParcelable); 57997f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley} 58097f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley 58197f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wileytemplate<typename T> 58297f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wileystatus_t Parcel::writeParcelableVector(const std::vector<T>& val) { 58397f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley return unsafeWriteTypedVector(val, &Parcel::writeParcelable); 58497f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley} 58597f048d19e51da4ea6ff98d8a9daf38f2577f182Christopher Wiley 5868683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian// --------------------------------------------------------------------------- 5878683fca395d01734ec7946e9f0595ec5d7b754c6Mathias Agopian 588edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectinline TextOutput& operator<<(TextOutput& to, const Parcel& parcel) 589edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 590edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project parcel.print(to); 591edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project return to; 592edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project} 593edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 594edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 595edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 596edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// Generic acquire and release of objects. 597edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectvoid acquire_object(const sp<ProcessState>& proc, 598edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const flat_binder_object& obj, const void* who); 599edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectvoid release_object(const sp<ProcessState>& proc, 600edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const flat_binder_object& obj, const void* who); 601edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 602edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectvoid flatten_binder(const sp<ProcessState>& proc, 603edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const sp<IBinder>& binder, flat_binder_object* out); 604edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectvoid flatten_binder(const sp<ProcessState>& proc, 605edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const wp<IBinder>& binder, flat_binder_object* out); 606edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectstatus_t unflatten_binder(const sp<ProcessState>& proc, 607edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const flat_binder_object& flat, sp<IBinder>* out); 608edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectstatus_t unflatten_binder(const sp<ProcessState>& proc, 609edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const flat_binder_object& flat, wp<IBinder>* out); 610edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 611edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 612edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 613edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 614edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 615edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#endif // ANDROID_PARCEL_H 616