From 294d44be33bf6ad6d7d53189d38202a4911f2bd7 Mon Sep 17 00:00:00 2001 From: bohu Date: Tue, 28 Feb 2017 14:58:36 -0800 Subject: [PATCH] DO NOT MERGE ANYWHERE Qemu-pipe: refactor qemu_pipe.h into libqemu_pipe Traditionally, qemu_pipe has both the declaration and implentation of each function in one header file--qemu_pipe.h, and it is getting incovenient to maintain. This CL separates the implementation of functions from the header file, and makes qemu_pipe a static library for other modules to link to. Note that the interface and implementation of qemu_pipe are kept unchanged, and future CLs will enhance the implementation to make it more reliable and more compatible with old and new API levels. Following projects are affected by this refactoring, and they are modified accordingly: device/generic/goldfish device/generic/goldfish-opengl hardware/ril/reference-ril Change-Id: I541ecbf0cc7eadeef9d4e37ffd9ca7bfcc5c94c0 --- adb/Android.mk | 4 +- adb/transport_local.cpp | 2 +- qemu_pipe/Android.mk | 19 ++++++ qemu_pipe/include/qemu_pipe.h | 62 +++++++++++++++++++ .../qemu_pipe.h => qemu_pipe/qemu_pipe.cpp | 16 +++-- 5 files changed, 92 insertions(+), 11 deletions(-) create mode 100644 qemu_pipe/Android.mk create mode 100644 qemu_pipe/include/qemu_pipe.h rename include/system/qemu_pipe.h => qemu_pipe/qemu_pipe.cpp (91%) diff --git a/adb/Android.mk b/adb/Android.mk index b444afad1..a2ea699bc 100644 --- a/adb/Android.mk +++ b/adb/Android.mk @@ -124,11 +124,12 @@ LOCAL_SRC_FILES := \ adbd_auth.cpp \ jdwp_service.cpp \ +LOCAL_C_INCLUDES := system/core/qemu_pipe/include LOCAL_SANITIZE := $(adb_target_sanitize) # Even though we're building a static library (and thus there's no link step for # this to take effect), this adds the includes to our path. -LOCAL_STATIC_LIBRARIES := libcrypto_utils libcrypto libbase +LOCAL_STATIC_LIBRARIES := libcrypto_utils libcrypto libqemu_pipe libbase LOCAL_WHOLE_STATIC_LIBRARIES := libadbd_usb @@ -357,6 +358,7 @@ LOCAL_STRIP_MODULE := keep_symbols LOCAL_STATIC_LIBRARIES := \ libadbd \ libbase \ + libqemu_pipe \ libbootloader_message \ libfs_mgr \ libfec \ diff --git a/adb/transport_local.cpp b/adb/transport_local.cpp index c17f86914..b5d0ef070 100644 --- a/adb/transport_local.cpp +++ b/adb/transport_local.cpp @@ -248,7 +248,7 @@ static void server_socket_thread(void* arg) { #define open adb_open #define read adb_read #define write adb_write -#include +#include #undef open #undef read #undef write diff --git a/qemu_pipe/Android.mk b/qemu_pipe/Android.mk new file mode 100644 index 000000000..6e0144ce1 --- /dev/null +++ b/qemu_pipe/Android.mk @@ -0,0 +1,19 @@ +# Copyright 2011 The Android Open Source Project + +LOCAL_PATH:= $(call my-dir) + +common_static_libraries := \ + libbase +include $(CLEAR_VARS) +LOCAL_CLANG := true +LOCAL_SANITIZE := integer +LOCAL_SRC_FILES:= \ + qemu_pipe.cpp +LOCAL_C_INCLUDES := \ + $(LOCAL_PATH)/include \ + system/base/include +LOCAL_MODULE:= libqemu_pipe +LOCAL_STATIC_LIBRARIES := $(common_static_libraries) +LOCAL_EXPORT_C_INCLUDE_DIRS := $(LOCAL_PATH)/include +LOCAL_CFLAGS := -Werror +include $(BUILD_STATIC_LIBRARY) diff --git a/qemu_pipe/include/qemu_pipe.h b/qemu_pipe/include/qemu_pipe.h new file mode 100644 index 000000000..16486c087 --- /dev/null +++ b/qemu_pipe/include/qemu_pipe.h @@ -0,0 +1,62 @@ +/* + * Copyright (C) 2011 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_CORE_INCLUDE_QEMU_PIPE_H +#define ANDROID_CORE_INCLUDE_QEMU_PIPE_H + +#include + +#ifdef __cplusplus +extern "C" { +#endif +// Try to open a new Qemu fast-pipe. This function returns a file descriptor +// that can be used to communicate with a named service managed by the +// emulator. +// +// This file descriptor can be used as a standard pipe/socket descriptor. +// +// 'pipeName' is the name of the emulator service you want to connect to, +// and must begin with 'pipe:' (e.g. 'pipe:camera' or 'pipe:opengles'). +// +// On success, return a valid file descriptor, or -1/errno on failure. E.g.: +// +// EINVAL -> unknown/unsupported pipeName +// ENOSYS -> fast pipes not available in this system. +// +// ENOSYS should never happen, except if you're trying to run within a +// misconfigured emulator. +// +// You should be able to open several pipes to the same pipe service, +// except for a few special cases (e.g. GSM modem), where EBUSY will be +// returned if more than one client tries to connect to it. +int qemu_pipe_open(const char* pipeName); + +// Send a framed message |buff| of |len| bytes through the |fd| descriptor. +// This really adds a 4-hexchar prefix describing the payload size. +// Returns 0 on success, and -1 on error. +int qemu_pipe_frame_send(int fd, const void* buff, size_t len); + +// Read a frame message from |fd|, and store it into |buff| of |len| bytes. +// If the framed message is larger than |len|, then this returns -1 and the +// content is lost. Otherwise, this returns the size of the message. NOTE: +// empty messages are possible in a framed wire protocol and do not mean +// end-of-stream. +int qemu_pipe_frame_recv(int fd, void* buff, size_t len); + +#ifdef __cplusplus +} +#endif + +#endif /* ANDROID_CORE_INCLUDE_QEMU_PIPE_H */ diff --git a/include/system/qemu_pipe.h b/qemu_pipe/qemu_pipe.cpp similarity index 91% rename from include/system/qemu_pipe.h rename to qemu_pipe/qemu_pipe.cpp index af2507997..a4529deb8 100644 --- a/include/system/qemu_pipe.h +++ b/qemu_pipe/qemu_pipe.cpp @@ -13,13 +13,15 @@ * See the License for the specific language governing permissions and * limitations under the License. */ -#ifndef ANDROID_INCLUDE_SYSTEM_QEMU_PIPE_H -#define ANDROID_INCLUDE_SYSTEM_QEMU_PIPE_H + +#include "qemu_pipe.h" #include #include #include #include +#include + // Define QEMU_PIPE_DEBUG if you want to print error messages when an error // occurs during pipe operations. The macro should simply take a printf-style @@ -48,7 +50,7 @@ // You should be able to open several pipes to the same pipe service, // except for a few special cases (e.g. GSM modem), where EBUSY will be // returned if more than one client tries to connect to it. -static __inline__ int qemu_pipe_open(const char* pipeName) { +int qemu_pipe_open(const char* pipeName) { // Sanity check. if (!pipeName || memcmp(pipeName, "pipe:", 5) != 0) { errno = EINVAL; @@ -81,9 +83,7 @@ static __inline__ int qemu_pipe_open(const char* pipeName) { // Send a framed message |buff| of |len| bytes through the |fd| descriptor. // This really adds a 4-hexchar prefix describing the payload size. // Returns 0 on success, and -1 on error. -static int __inline__ qemu_pipe_frame_send(int fd, - const void* buff, - size_t len) { +int qemu_pipe_frame_send(int fd, const void* buff, size_t len) { char header[5]; snprintf(header, sizeof(header), "%04zx", len); ssize_t ret = TEMP_FAILURE_RETRY(write(fd, header, 4)); @@ -104,7 +104,7 @@ static int __inline__ qemu_pipe_frame_send(int fd, // content is lost. Otherwise, this returns the size of the message. NOTE: // empty messages are possible in a framed wire protocol and do not mean // end-of-stream. -static int __inline__ qemu_pipe_frame_recv(int fd, void* buff, size_t len) { +int qemu_pipe_frame_recv(int fd, void* buff, size_t len) { char header[5]; ssize_t ret = TEMP_FAILURE_RETRY(read(fd, header, 4)); if (ret != 4) { @@ -130,5 +130,3 @@ static int __inline__ qemu_pipe_frame_recv(int fd, void* buff, size_t len) { } return size; } - -#endif /* ANDROID_INCLUDE_HARDWARE_QEMUD_PIPE_H */