File: extensions.cpp

package info (click to toggle)
android-platform-system-core 1%3A10.0.0%2Br36-7
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 123,760 kB
  • sloc: cpp: 197,034; ansic: 18,211; asm: 3,606; sh: 3,180; python: 2,671; java: 693; xml: 266; makefile: 237
file content (314 lines) | stat: -rw-r--r-- 13,018 bytes parent folder | download | duplicates (5)
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
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
/*
 * Copyright (C) 2018 The Android Open Source Project
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *  * Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */
#include <ctype.h>
#include <errno.h>
#include <fcntl.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>

#include <csignal>
#include <cstdlib>
#include <fstream>

#include "extensions.h"
#include "test_utils.h"
#include "tinyxml2.h"

namespace fastboot {
namespace extension {

namespace {  // private to this file

// Since exceptions are disabled, a bad regex will trigger an abort in the constructor
// We at least need to print something out
std::regex MakeRegex(const std::string& regex_str, int line_num,
                     std::regex_constants::syntax_option_type type = std::regex::ECMAScript) {
    // The signal handler can only access static vars
    static std::string err_str;
    err_str = android::base::StringPrintf("'%s' is not a valid regex string (line %d)\n",
                                          regex_str.c_str(), line_num);
    const auto sighandler = [](int) {
        int nbytes = write(fileno(stderr), err_str.c_str(), err_str.length());
        static_cast<void>(nbytes);  // need to supress the unused nbytes/ or unused result
    };
    std::signal(SIGABRT, sighandler);
    // Now attempt to create the regex
    std::regex ret(regex_str, type);
    // unregister
    std::signal(SIGABRT, SIG_DFL);

    return ret;
}

bool XMLAssert(bool cond, const tinyxml2::XMLElement* elem, const char* msg) {
    if (!cond) {
        printf("%s (line %d)\n", msg, elem->GetLineNum());
    }
    return !cond;
}

const std::string XMLAttribute(const tinyxml2::XMLElement* elem, const std::string key,
                               const std::string key_default = "") {
    if (!elem->Attribute(key.c_str())) {
        return key_default;
    }

    return elem->Attribute(key.c_str());
}

bool XMLYesNo(const tinyxml2::XMLElement* elem, const std::string key, bool* res,
              bool def = false) {
    if (!elem->Attribute(key.c_str())) {
        *res = def;
        return true;
    }
    const std::string val = elem->Attribute(key.c_str());
    if (val != "yes" && val != "no") {
        return false;
    }
    *res = (val == "yes");
    return true;
}

bool ExtractPartitions(tinyxml2::XMLConstHandle handle, Configuration* config) {
    // Extract partitions
    const tinyxml2::XMLElement* part = handle.FirstChildElement("part").ToElement();
    while (part) {
        Configuration::PartitionInfo part_info;
        const std::string name = XMLAttribute(part, "value");
        const std::string test = XMLAttribute(part, "test");
        if (XMLAssert(!name.empty(), part, "The name of a partition can not be empty") ||
            XMLAssert(XMLYesNo(part, "slots", &part_info.slots), part,
                      "Slots attribute must be 'yes' or 'no'") ||
            XMLAssert(XMLYesNo(part, "hashable", &part_info.hashable, true), part,
                      "Hashable attribute must be 'yes' or 'no'") ||
            XMLAssert(XMLYesNo(part, "parsed", &part_info.parsed), part,
                      "Parsed attribute must be 'yes' or 'no'"))
            return false;

        bool allowed = test == "yes" || test == "no-writes" || test == "no";
        if (XMLAssert(allowed, part, "The test attribute must be 'yes' 'no-writes' or 'no'"))
            return false;
        if (XMLAssert(config->partitions.find(name) == config->partitions.end(), part,
                      "The same partition name is listed twice"))
            return false;
        part_info.test = (test == "yes")
                                 ? Configuration::PartitionInfo::YES
                                 : (test == "no-writes") ? Configuration::PartitionInfo::NO_WRITES
                                                         : Configuration::PartitionInfo::NO;
        config->partitions[name] = part_info;
        part = part->NextSiblingElement("part");
    }
    return true;
}

bool ExtractPacked(tinyxml2::XMLConstHandle handle, Configuration* config) {
    // Extract partitions
    const tinyxml2::XMLElement* part = handle.FirstChildElement("part").ToElement();
    while (part) {
        Configuration::PackedInfo packed_info;
        const std::string name = XMLAttribute(part, "value");

        if (XMLAssert(!name.empty(), part, "The name of a packed partition can not be empty") ||
            XMLAssert(XMLYesNo(part, "slots", &packed_info.slots), part,
                      "Slots attribute must be 'yes' or 'no'") ||
            XMLAssert(config->partitions.find(name) == config->partitions.end(), part,
                      "A packed partition can not have same name as a real one") ||
            XMLAssert(config->partitions.find(name) == config->partitions.end(), part,
                      "The same partition name is listed twice"))
            return false;

        // Extract children partitions
        const tinyxml2::XMLElement* child = part->FirstChildElement("child")
                                                    ? part->FirstChildElement("child")->ToElement()
                                                    : nullptr;
        while (child) {
            const std::string text(child->GetText());
            // Make sure child exists
            if (XMLAssert(config->partitions.find(text) != config->partitions.end(), child,
                          "The child partition was not listed in <partitions>"))
                return false;
            packed_info.children.insert(text);
            child = child->NextSiblingElement("child");
        }

        // Extract tests
        const tinyxml2::XMLElement* test = part->FirstChildElement("test")
                                                   ? part->FirstChildElement("test")->ToElement()
                                                   : nullptr;
        while (test) {
            Configuration::PackedInfoTest packed_test;
            packed_test.packed_img = XMLAttribute(test, "packed");
            packed_test.unpacked_dir = XMLAttribute(test, "unpacked");
            const std::string expect = XMLAttribute(test, "expect", "okay");

            if (XMLAssert(!packed_test.packed_img.empty(), test,
                          "The packed image location must be specified") ||
                XMLAssert(CMD_EXPECTS.find(expect) != CMD_EXPECTS.end(), test,
                          "Expect attribute must be 'okay' or 'fail'"))
                return false;

            packed_test.expect = CMD_EXPECTS.at(expect);
            // The expect is only unpacked directory is only needed if success
            if (packed_test.expect == OKAY &&
                XMLAssert(!packed_test.unpacked_dir.empty(), test,
                          "The unpacked image folder location must be specified"))
                return false;

            packed_info.tests.push_back(packed_test);
            test = test->NextSiblingElement("test");
        }

        config->packed[name] = packed_info;
        part = part->NextSiblingElement("part");
    }
    return true;
}

bool ExtractGetVars(tinyxml2::XMLConstHandle handle, Configuration* config) {
    // Extract getvars
    const tinyxml2::XMLElement* var = handle.FirstChildElement("var").ToElement();
    while (var) {
        const std::string key = XMLAttribute(var, "key");
        const std::string reg = XMLAttribute(var, "assert");
        if (XMLAssert(key.size(), var, "The var key name is empty")) return false;
        if (XMLAssert(config->getvars.find(key) == config->getvars.end(), var,
                      "The same getvar variable name is listed twice"))
            return false;
        Configuration::GetVar getvar{reg, MakeRegex(reg, var->GetLineNum()), var->GetLineNum()};
        config->getvars[key] = std::move(getvar);
        var = var->NextSiblingElement("var");
    }
    return true;
}

bool ExtractOem(tinyxml2::XMLConstHandle handle, Configuration* config) {
    // Extract getvars
    // Extract oem commands
    const tinyxml2::XMLElement* command = handle.FirstChildElement("command").ToElement();
    while (command) {
        const std::string cmd = XMLAttribute(command, "value");
        const std::string permissions = XMLAttribute(command, "permissions");
        if (XMLAssert(cmd.size(), command, "Empty command value")) return false;
        if (XMLAssert(permissions == "none" || permissions == "unlocked", command,
                      "Permissions attribute must be 'none' or 'unlocked'"))
            return false;

        // Each command has tests
        std::vector<Configuration::CommandTest> tests;
        const tinyxml2::XMLElement* test = command->FirstChildElement("test");
        while (test) {  // iterate through tests
            Configuration::CommandTest ctest;

            ctest.line_num = test->GetLineNum();
            const std::string default_name = "XMLTest-line-" + std::to_string(test->GetLineNum());
            ctest.name = XMLAttribute(test, "name", default_name);
            ctest.arg = XMLAttribute(test, "value");
            ctest.input = XMLAttribute(test, "input");
            ctest.output = XMLAttribute(test, "output");
            ctest.validator = XMLAttribute(test, "validate");
            ctest.regex_str = XMLAttribute(test, "assert");

            const std::string expect = XMLAttribute(test, "expect");

            if (XMLAssert(CMD_EXPECTS.find(expect) != CMD_EXPECTS.end(), test,
                          "Expect attribute must be 'okay' or 'fail'"))
                return false;
            ctest.expect = CMD_EXPECTS.at(expect);
            std::regex regex;
            if (expect == "okay" && ctest.regex_str.size()) {
                ctest.regex = MakeRegex(ctest.regex_str, test->GetLineNum());
            }
            tests.push_back(std::move(ctest));
            test = test->NextSiblingElement("test");
        }

        // Build the command struct
        const Configuration::OemCommand oem_cmd{permissions == "unlocked", std::move(tests)};
        config->oem[cmd] = std::move(oem_cmd);

        command = command->NextSiblingElement("command");
    }
    return true;
}

bool ExtractChecksum(tinyxml2::XMLConstHandle handle, Configuration* config) {
    const tinyxml2::XMLElement* checksum = handle.ToElement();
    if (checksum && checksum->Attribute("value")) {
        config->checksum = XMLAttribute(checksum, "value");
        config->checksum_parser = XMLAttribute(checksum, "parser");
        if (XMLAssert(config->checksum_parser != "", checksum,
                      "A checksum parser attribute is mandatory"))
            return false;
    }
    return true;
}

}  // anonymous namespace

bool ParseXml(const std::string& file, Configuration* config) {
    tinyxml2::XMLDocument doc;
    if (doc.LoadFile(file.c_str())) {
        printf("Failed to open/parse XML file '%s'\nXMLError: %s\n", file.c_str(), doc.ErrorStr());
        return false;
    }

    tinyxml2::XMLConstHandle handle(&doc);
    tinyxml2::XMLConstHandle root(handle.FirstChildElement("config"));

    // Extract the getvars
    if (!ExtractGetVars(root.FirstChildElement("getvar"), config)) {
        return false;
    }
    // Extract the partition info
    if (!ExtractPartitions(root.FirstChildElement("partitions"), config)) {
        return false;
    }

    // Extract packed
    if (!ExtractPacked(root.FirstChildElement("packed"), config)) {
        return false;
    }

    // Extract oem commands
    if (!ExtractOem(root.FirstChildElement("oem"), config)) {
        return false;
    }

    // Extract checksum
    if (!ExtractChecksum(root.FirstChildElement("checksum"), config)) {
        return false;
    }

    return true;
}

}  // namespace extension
}  // namespace fastboot