Move HidlSupport and IServiceManager from libhwbinder.
libhidl will contain data types and functionality that
is independent from libhwbinder, such as hidl_vec,
hidl_string, etc.
libhidl also contains an implementation of the service
manager interface. Initially that implementation is
exactly the same as the servicemanager we had in libhwbinder,
but eventually it should be capable of passing out
pass-through or remote HAL interfaces as well. Therefore,
the servicemanager belongs more in libhidl than in libhwbinder.
This initial version of the library still links against
libhwbinder because of the following dependencies:
- hidl_vec/hidl_string have methods for (de)serialization
to/from a Parcel
- IServiceManager requires instantiation of a proxy for
the hwbinder ServiceManager.
These can be dealt with in the future, if we deem it necessary,
since they don't leak through to clients; clients can link
against libhidl only when we have the other changes to the
class hierarchy in place.
Bug: 30839546
Change-Id: Ib05de8c98ba8a807618a0b2e37d809a29d2de9ca
diff --git a/include/hidl/HidlSupport.h b/include/hidl/HidlSupport.h
new file mode 100644
index 0000000..c36b7ec
--- /dev/null
+++ b/include/hidl/HidlSupport.h
@@ -0,0 +1,224 @@
+/*
+ * Copyright (C) 2016 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef ANDROID_HIDL_SUPPORT_H
+#define ANDROID_HIDL_SUPPORT_H
+
+#include <hwbinder/Parcel.h>
+
+namespace android {
+namespace hardware {
+
+struct hidl_string {
+ hidl_string();
+ ~hidl_string();
+
+ hidl_string(const hidl_string &);
+ hidl_string &operator=(const hidl_string &);
+
+ const char *c_str() const;
+ size_t size() const;
+ bool empty() const;
+
+ hidl_string &operator=(const char *s);
+ void clear();
+
+ // Reference an external char array. Ownership is _not_ transferred.
+ // Caller is responsible for ensuring that underlying memory is valid
+ // for the lifetime of this hidl_string.
+ void setToExternal(const char *data, size_t size);
+
+ status_t readEmbeddedFromParcel(
+ const Parcel &parcel, size_t parentHandle, size_t parentOffset);
+
+ status_t writeEmbeddedToParcel(
+ Parcel *parcel, size_t parentHandle, size_t parentOffset) const;
+
+private:
+ char *mBuffer;
+ size_t mSize; // NOT including the terminating '\0'.
+ bool mOwnsBuffer;
+
+ hidl_string &setTo(const char *data, size_t size);
+};
+
+template<typename T>
+struct hidl_vec {
+ hidl_vec()
+ : mBuffer(NULL),
+ mSize(0),
+ mOwnsBuffer(true) {
+ }
+
+ hidl_vec(const hidl_vec<T> &other)
+ : mBuffer(NULL),
+ mSize(0),
+ mOwnsBuffer(true) {
+ *this = other;
+ }
+
+ ~hidl_vec() {
+ if (mOwnsBuffer) {
+ delete[] mBuffer;
+ }
+ mBuffer = NULL;
+ }
+
+ // Reference an existing array _WITHOUT_ taking ownership. It is the
+ // caller's responsibility to ensure that the underlying memory stays
+ // valid for the lifetime of this hidl_vec.
+ void setToExternal(T *data, size_t size) {
+ if (mOwnsBuffer) {
+ delete [] mBuffer;
+ }
+ mBuffer = data;
+ mSize = size;
+ mOwnsBuffer = false;
+ }
+
+ hidl_vec &operator=(const hidl_vec &other) {
+ if (this != &other) {
+ if (mOwnsBuffer) {
+ delete[] mBuffer;
+ }
+ mBuffer = NULL;
+ mSize = other.mSize;
+ mOwnsBuffer = true;
+ if (mSize > 0) {
+ mBuffer = new T[mSize];
+ for (size_t i = 0; i < mSize; ++i) {
+ mBuffer[i] = other.mBuffer[i];
+ }
+ }
+ }
+
+ return *this;
+ }
+
+ size_t size() const {
+ return mSize;
+ }
+
+ T &operator[](size_t index) {
+ return mBuffer[index];
+ }
+
+ const T &operator[](size_t index) const {
+ return mBuffer[index];
+ }
+
+ void resize(size_t size) {
+ T *newBuffer = new T[size];
+
+ for (size_t i = 0; i < std::min(size, mSize); ++i) {
+ newBuffer[i] = mBuffer[i];
+ }
+
+ if (mOwnsBuffer) {
+ delete[] mBuffer;
+ }
+ mBuffer = newBuffer;
+
+ mSize = size;
+ mOwnsBuffer = true;
+ }
+
+ status_t readEmbeddedFromParcel(
+ const Parcel &parcel,
+ size_t parentHandle,
+ size_t parentOffset,
+ size_t *handle);
+
+ status_t writeEmbeddedToParcel(
+ Parcel *parcel,
+ size_t parentHandle,
+ size_t parentOffset,
+ size_t *handle) const;
+
+private:
+ T *mBuffer;
+ size_t mSize;
+ bool mOwnsBuffer;
+};
+
+template<typename T>
+status_t hidl_vec<T>::readEmbeddedFromParcel(
+ const Parcel &parcel,
+ size_t parentHandle,
+ size_t parentOffset,
+ size_t *handle) {
+ const void *ptr = parcel.readEmbeddedBuffer(
+ handle,
+ parentHandle,
+ parentOffset + offsetof(hidl_vec<T>, mBuffer));
+
+ return ptr != NULL ? OK : UNKNOWN_ERROR;
+}
+
+template<typename T>
+status_t hidl_vec<T>::writeEmbeddedToParcel(
+ Parcel *parcel,
+ size_t parentHandle,
+ size_t parentOffset,
+ size_t *handle) const {
+ return parcel->writeEmbeddedBuffer(
+ mBuffer,
+ sizeof(T) * mSize,
+ handle,
+ parentHandle,
+ parentOffset + offsetof(hidl_vec<T>, mBuffer));
+}
+
+// ----------------------------------------------------------------------
+// Version functions
+struct hidl_version {
+public:
+ hidl_version(uint16_t major, uint16_t minor) : mMajor(major), mMinor(minor) {};
+
+ bool operator==(const hidl_version& other) {
+ return (mMajor == other.get_major() && mMinor == other.get_minor());
+ }
+ uint16_t get_major() const { return mMajor; }
+ uint16_t get_minor() const { return mMinor; }
+
+ android::status_t writeToParcel(android::hardware::Parcel& parcel) const {
+ return parcel.writeUint32((uint32_t) mMajor << 16 | mMinor);
+ }
+
+ static hidl_version* readFromParcel(const android::hardware::Parcel& parcel) {
+ uint32_t version;
+ android::status_t status = parcel.readUint32(&version);
+ if (status != OK) {
+ return nullptr;
+ } else {
+ return new hidl_version(version >> 16, version & 0xFFFF);
+ }
+ }
+
+private:
+ uint16_t mMajor;
+ uint16_t mMinor;
+};
+
+inline android::hardware::hidl_version make_hidl_version(uint16_t major, uint16_t minor) {
+ return hidl_version(major,minor);
+}
+
+} // namespace hardware
+} // namespace android
+
+#endif // ANDROID_HIDL_SUPPORT_H
+