1 /*
2  * Copyright (C) 2019 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 #pragma once
18 
19 #include <stdint.h>
20 #include <sys/types.h>
21 
22 #include <android-base/unique_fd.h>
23 
24 extern "C" {
25 
26 struct AdbConnectionClientContext;
27 
28 enum AdbConnectionClientInfoType {
29   pid,
30   debuggable,
31   profileable,
32   architecture,
33 };
34 
35 struct AdbConnectionClientInfo {
36   AdbConnectionClientInfoType type;
37   union {
38     uint64_t pid;
39     bool debuggable;
40     bool profileable;
41     struct {
42       const char* name;
43       size_t size;
44     } architecture;
45   } data;
46 };
47 
48 // Construct a context and connect to adbd.
49 // Returns null if we fail to connect to adbd.
50 // Note this is an apex interface as it's loaded by ART.
51 AdbConnectionClientContext* adbconnection_client_new(
52     const AdbConnectionClientInfo* const* info_elems, size_t info_count);
53 
54 void adbconnection_client_destroy(AdbConnectionClientContext* ctx);
55 
56 // Get an fd which can be polled upon to detect when a jdwp socket is available.
57 // You do not own this fd. Do not close it.
58 int adbconnection_client_pollfd(AdbConnectionClientContext* ctx);
59 
60 // Receive a jdwp client fd.
61 // Ownership is transferred to the caller of this function.
62 int adbconnection_client_receive_jdwp_fd(AdbConnectionClientContext* ctx);
63 }
64