aboutsummaryrefslogtreecommitdiff
path: root/source/Plugins/Platform/Android/AdbClient.h
blob: 37973bbdccf85d561d7792331e72b5abd3e4c550 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
//===-- AdbClient.h ---------------------------------------------*- C++ -*-===//
//
//                     The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//

#ifndef liblldb_AdbClient_h_
#define liblldb_AdbClient_h_

// C Includes

// C++ Includes

#include <functional>
#include <list>
#include <memory>
#include <string>
#include <vector>

// Other libraries and framework includes
// Project includes

#include "lldb/Core/Error.h"

namespace lldb_private {

class FileSpec;

namespace platform_android {

class AdbClient
{
public:
    enum UnixSocketNamespace
    {
        UnixSocketNamespaceAbstract,
        UnixSocketNamespaceFileSystem,
    };

    using DeviceIDList = std::list<std::string>;

    class SyncService
    {
        friend class AdbClient;

    public:
        ~SyncService ();

        Error
        PullFile (const FileSpec &remote_file, const FileSpec &local_file);

        Error
        PushFile (const FileSpec &local_file, const FileSpec &remote_file);

        Error
        Stat (const FileSpec &remote_file, uint32_t &mode, uint32_t &size, uint32_t &mtime);

        bool
        IsConnected () const;

    private:
        explicit SyncService (std::unique_ptr<Connection> &&conn);

        Error
        SendSyncRequest (const char *request_id, const uint32_t data_len, const void *data);

        Error
        ReadSyncHeader (std::string &response_id, uint32_t &data_len); 

        Error
        PullFileChunk (std::vector<char> &buffer, bool &eof);

        Error
        ReadAllBytes (void *buffer, size_t size);

        Error
        internalPullFile (const FileSpec &remote_file, const FileSpec &local_file);

        Error
        internalPushFile (const FileSpec &local_file, const FileSpec &remote_file);

        Error
        internalStat (const FileSpec &remote_file, uint32_t &mode, uint32_t &size, uint32_t &mtime);

        Error
        executeCommand (const std::function<Error()> &cmd);

        std::unique_ptr<Connection> m_conn;   
    };

    static Error
    CreateByDeviceID(const std::string &device_id, AdbClient &adb);

    AdbClient ();
    explicit AdbClient (const std::string &device_id);

    ~AdbClient();

    const std::string&
    GetDeviceID() const;

    Error
    GetDevices (DeviceIDList &device_list);

    Error
    SetPortForwarding (const uint16_t local_port, const uint16_t remote_port);

    Error
    SetPortForwarding (const uint16_t local_port,
                       const char* remote_socket_name,
                       const UnixSocketNamespace socket_namespace);

    Error
    DeletePortForwarding (const uint16_t local_port);

    Error
    Shell (const char* command, uint32_t timeout_ms, std::string* output);

    Error
    ShellToFile(const char *command, uint32_t timeout_ms, const FileSpec &output_file_spec);

    std::unique_ptr<SyncService>
    GetSyncService (Error &error);

    Error
    SwitchDeviceTransport ();

private:
    Error
    Connect ();

    void
    SetDeviceID (const std::string &device_id);

    Error
    SendMessage (const std::string &packet, const bool reconnect = true);

    Error
    SendDeviceMessage (const std::string &packet);

    Error
    ReadMessage (std::vector<char> &message);

    Error
    ReadMessageStream (std::vector<char> &message, uint32_t timeout_ms);

    Error
    GetResponseError (const char *response_id);

    Error
    ReadResponseStatus ();

    Error
    Sync ();

    Error
    StartSync ();

    Error
    internalShell(const char *command, uint32_t timeout_ms, std::vector<char> &output_buf);

    Error
    ReadAllBytes(void *buffer, size_t size);

    std::string m_device_id;
    std::unique_ptr<Connection> m_conn;
};

} // namespace platform_android
} // namespace lldb_private

#endif  // liblldb_AdbClient_h_