recovery代码分析（三）

前文分析了recovery的主要流程，在recovery的实际安装阶段，会创建一个新的进程，执行ota包里面的update-binary。recovery进程和update-binary进程通过管道进行通信。
update-binary大致是从/bootable/recovery/updater编译出来的。下面分析一下update-binary的main函数。

main()函数

int main(int argc, char **argv) {
    // Timothy:前三行跟日志打印有关，初始化了日志相关的设置。
    // Various things log information to stdout or stderr more or less
    // at random (though we've tried to standardize on stdout).  The
    // log file makes more sense if buffering is turned off so things
    // appear in the right order.
    setbuf(stdout, nullptr);
    setbuf(stderr, nullptr);

    // We don't have logcat yet under recovery. Update logs will always be written to stdout
    // (which is redirected to recovery.log).
    android::base::InitLogging(argv, &UpdaterLogger);

    if (argc != 4 && argc != 5) {
        LOG(ERROR) << "unexpected number of arguments: " << argc;
        return 1;
    }

    char *version = argv[1];
    if ((version[0] != '1' && version[0] != '2' && version[0] != '3') || version[1] != '\0') {
        // We support version 1, 2, or 3.
        LOG(ERROR) << "wrong updater binary API; expected 1, 2, or 3; got " << argv[1];
        return 2;
    }

	// Timothy:初始化用于和前面提到的主进程通信的通道。
    // Set up the pipe for sending commands back to the parent process.    
	int fd = atoi(argv[2]);
    FILE *cmd_pipe = fdopen(fd, "wb");
    setlinebuf(cmd_pipe);

	// Timothy:从ota包里面释放binary-script
    // Extract the script from the package.
    const char *package_filename = argv[3];
    MemMapping map;
    if (!map.MapFile(package_filename)) {
        LOG(ERROR) << "failed to map package " << argv[3];
        return 3;
    }
    ZipArchiveHandle za;
    int open_err = OpenArchiveFromMemory(map.addr, map.length, argv[3], &za);
    if (open_err != 0) {
        LOG(ERROR) << "failed to open package " << argv[3] << ": " << ErrorCodeString(open_err);
        CloseArchive(za);
        return 3;
    }

    ZipString script_name(SCRIPT_NAME);
    ZipEntry script_entry;
    int find_err = FindEntry(za, script_name, &script_entry);
    if (find_err != 0) {
        LOG(ERROR) << "failed to find " << SCRIPT_NAME << " in " << package_filename << ": "
                   << ErrorCodeString(find_err);
        CloseArchive(za);
        return 4;
    }

    std::string script;
    script.resize(script_entry.uncompressed_length);
    int extract_err = ExtractToMemory(za, &script_entry, reinterpret_cast<uint8_t *>(&script[0]),
                                      script_entry.uncompressed_length);
    if (extract_err != 0) {
        LOG(ERROR) << "failed to read script from package: " << ErrorCodeString(extract_err);
        CloseArchive(za);
        return 5;
    }
#if 1
    set_fs_type_from_property();
    fprintf(stderr, "====== Updater-Script:\n");
    fprintf(stderr, "%s\n\n", script.c_str());
#endif

	// Timothy:这四个函数做的工作都是函数的映射，把update-script脚本中的函数与c++的函数进行一对一的
	// 映射，这样脚本就能调用c++函数了。
    // Configure edify's functions.
    RegisterBuiltins();
    RegisterInstallFunctions();
    RegisterBlockImageFunctions();
    RegisterDeviceExtensions();

    // Parse the script.
    std::unique_ptr<Expr> root;
    int error_count = 0;
    int error = parse_string(script.c_str(), &root, &error_count);
    if (error != 0 || error_count > 0) {
        LOG(ERROR) << error_count << " parse errors";
        CloseArchive(za);
        return 6;
    }

	// Timothy:与selinux相关，暂时不关注。
    sehandle = selinux_android_file_context_handle();
    selinux_android_set_sehandle(sehandle);

    if (!sehandle) {
        fprintf(cmd_pipe, "ui_print Warning: No file_contexts\n");
    }
	
	// Timothy:将升级脚本、通信通道、ota包路径、版本等信息存储在state里面。
    // Evaluate the parsed script.
    UpdaterInfo updater_info;
    updater_info.cmd_pipe = cmd_pipe;
    updater_info.package_zip = za;
    updater_info.version = atoi(version);
    updater_info.package_zip_addr = map.addr;
    updater_info.package_zip_len = map.length;

    State state(script, &updater_info);

    if (argc == 5) {
        if (strcmp(argv[4], "retry") == 0) {
            state.is_retry = true;
        } else {
            printf("unexpected argument: %s", argv[4]);
        }
    }
	// Timothy:大概应该是做一些文件io相关的设置，具体的作用没看懂。
    ota_io_init(za, state.is_retry);

    std::string result;
	// Timothy:执行脚本。
    bool status = Evaluate(&state, root, &result);

    if (have_eio_error) {
        fprintf(cmd_pipe, "retry_update\n");
    }

	// Timothy:升级失败的情况。
    if (!status) {
        if (state.errmsg.empty()) {
            LOG(ERROR) << "script aborted (no error message)";
            fprintf(cmd_pipe, "ui_print script aborted (no error message)\n");
        } else {
            LOG(ERROR) << "script aborted: " << state.errmsg;
            const std::vector<std::string> lines = android::base::Split(state.errmsg, "\n");
            for (const std::string &line : lines) {
                // Parse the error code in abort message.
                // Example: "E30: This package is for bullhead devices."
                if (!line.empty() && line[0] == 'E') {
                    if (sscanf(line.c_str(), "E%d: ", &state.error_code) != 1) {
                        LOG(ERROR) << "Failed to parse error code: [" << line << "]";
                    }
                }
                fprintf(cmd_pipe, "ui_print %s\n", line.c_str());
            }
        }

        // Installation has been aborted. Set the error code to kScriptExecutionFailure unless
        // a more specific code has been set in errmsg.
        if (state.error_code == kNoError) {
            state.error_code = kScriptExecutionFailure;
        }
        fprintf(cmd_pipe, "log error: %d\n", state.error_code);
        // Cause code should provide additional information about the abort.
        if (state.cause_code != kNoCause) {
            fprintf(cmd_pipe, "log cause: %d\n", state.cause_code);
            if (state.cause_code == kPatchApplicationFailure) {
                LOG(INFO) << "Patch application failed, retry update.";
                fprintf(cmd_pipe, "retry_update\n");
            }
        }

        if (updater_info.package_zip) {
            CloseArchive(updater_info.package_zip);
        }
        return 7;
    } else { 
		// Timothy:升级成功。前面提到过，在升级阶段如果按了音量键，会进入文字模式。在文字模式下，升级成功
		// 会在屏幕上打印这句话。
        fprintf(cmd_pipe, "ui_print script succeeded: result was [%s]\n", result.c_str());
    }

    if (updater_info.package_zip) {
        CloseArchive(updater_info.package_zip);
    }

    return 0;
}