// Copyright 2013 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include "chrome/browser/component_updater/update_manifest.h" #include #include "base/memory/scoped_ptr.h" #include "base/stl_util.h" #include "base/strings/string_number_conversions.h" #include "base/strings/string_util.h" #include "base/strings/stringprintf.h" #include "base/version.h" #include "libxml/tree.h" #include "third_party/libxml/chromium/libxml_utils.h" namespace component_updater { static const char* kExpectedResponseProtocol = "3.0"; UpdateManifest::UpdateManifest() {} UpdateManifest::~UpdateManifest() {} UpdateManifest::Results::Results() : daystart_elapsed_seconds(kNoDaystart) {} UpdateManifest::Results::~Results() {} UpdateManifest::Result::Result() {} UpdateManifest::Result::~Result() {} UpdateManifest::Result::Manifest::Manifest() {} UpdateManifest::Result::Manifest::~Manifest() {} UpdateManifest::Result::Manifest::Package::Package() : size(0), sizediff(0) {} UpdateManifest::Result::Manifest::Package::~Package() {} void UpdateManifest::ParseError(const char* details, ...) { va_list args; va_start(args, details); if (!errors_.empty()) { errors_ += "\r\n"; } base::StringAppendV(&errors_, details, args); va_end(args); } // Checks whether a given node's name matches |expected_name|. static bool TagNameEquals(const xmlNode* node, const char* expected_name) { return 0 == strcmp(expected_name, reinterpret_cast(node->name)); } // Returns child nodes of |root| with name |name|. static std::vector GetChildren(xmlNode* root, const char* name) { std::vector result; for (xmlNode* child = root->children; child != NULL; child = child->next) { if (!TagNameEquals(child, name)) { continue; } result.push_back(child); } return result; } // Returns the value of a named attribute, or the empty string. static std::string GetAttribute(xmlNode* node, const char* attribute_name) { const xmlChar* name = reinterpret_cast(attribute_name); for (xmlAttr* attr = node->properties; attr != NULL; attr = attr->next) { if (!xmlStrcmp(attr->name, name) && attr->children && attr->children->content) { return std::string(reinterpret_cast( attr->children->content)); } } return std::string(); } // This is used for the xml parser to report errors. This assumes the context // is a pointer to a std::string where the error message should be appended. static void XmlErrorFunc(void *context, const char *message, ...) { va_list args; va_start(args, message); std::string* error = static_cast(context); base::StringAppendV(error, message, args); va_end(args); } // Utility class for cleaning up the xml document when leaving a scope. class ScopedXmlDocument { public: explicit ScopedXmlDocument(xmlDocPtr document) : document_(document) {} ~ScopedXmlDocument() { if (document_) xmlFreeDoc(document_); } xmlDocPtr get() { return document_; } private: xmlDocPtr document_; }; // Parses the tag. bool ParsePackageTag(xmlNode* package, UpdateManifest::Result* result, std::string* error) { UpdateManifest::Result::Manifest::Package p; p.name = GetAttribute(package, "name"); if (p.name.empty()) { *error = "Missing name for package."; return false; } p.namediff = GetAttribute(package, "namediff"); // package_fingerprint is optional. It identifies the package, preferably // with a modified sha256 hash of the package in hex format. p.fingerprint = GetAttribute(package, "fp"); p.hash_sha256 = GetAttribute(package, "hash_sha256"); int size = 0; if (base::StringToInt(GetAttribute(package, "size"), &size)) { p.size = size; } p.hashdiff_sha256 = GetAttribute(package, "hashdiff_sha256"); int sizediff = 0; if (base::StringToInt(GetAttribute(package, "sizediff"), &sizediff)) { p.sizediff = sizediff; } result->manifest.packages.push_back(p); return true; } // Parses the tag. bool ParseManifestTag(xmlNode* manifest, UpdateManifest::Result* result, std::string* error) { // Get the version. result->manifest.version = GetAttribute(manifest, "version"); if (result->manifest.version.empty()) { *error = "Missing version for manifest."; return false; } Version version(result->manifest.version); if (!version.IsValid()) { *error = "Invalid version: '"; *error += result->manifest.version; *error += "'."; return false; } // Get the minimum browser version (not required). result->manifest.browser_min_version = GetAttribute(manifest, "prodversionmin"); if (result->manifest.browser_min_version.length()) { Version browser_min_version(result->manifest.browser_min_version); if (!browser_min_version.IsValid()) { *error = "Invalid prodversionmin: '"; *error += result->manifest.browser_min_version; *error += "'."; return false; } } // Get the node. std::vector packages = GetChildren(manifest, "packages"); if (packages.empty()) { *error = "Missing packages tag on manifest."; return false; } // Parse each of the tags. std::vector package = GetChildren(packages[0], "package"); for (size_t i = 0; i != package.size(); ++i) { if (!ParsePackageTag(package[i], result, error)) return false; } return true; } // Parses the tag and its children in the . bool ParseUrlsTag(xmlNode* urls, UpdateManifest::Result* result, std::string* error) { // Get the url nodes. std::vector url = GetChildren(urls, "url"); if (url.empty()) { *error = "Missing url tags on urls."; return false; } // Get the list of urls for full and optionally, for diff updates. // There can only be either a codebase or a codebasediff attribute in a tag. for (size_t i = 0; i != url.size(); ++i) { // Find the url to the crx file. const GURL crx_url(GetAttribute(url[i], "codebase")); if (crx_url.is_valid()) { result->crx_urls.push_back(crx_url); continue; } const GURL crx_diffurl(GetAttribute(url[i], "codebasediff")); if (crx_diffurl.is_valid()) { result->crx_diffurls.push_back(crx_diffurl); continue; } } // Expect at least one url for full update. if (result->crx_urls.empty()) { *error = "Missing valid url for full update."; return false; } return true; } // Parses the tag. bool ParseUpdateCheckTag(xmlNode* updatecheck, UpdateManifest::Result* result, std::string* error) { if (GetAttribute(updatecheck, "status") == "noupdate") { return true; } // Get the tag. std::vector urls = GetChildren(updatecheck, "urls"); if (urls.empty()) { *error = "Missing urls on updatecheck."; return false; } if (!ParseUrlsTag(urls[0], result, error)) { return false; } std::vector manifests = GetChildren(updatecheck, "manifest"); if (urls.empty()) { *error = "Missing urls on updatecheck."; return false; } return ParseManifestTag(manifests[0], result, error); } // Parses a single tag. bool ParseAppTag(xmlNode* app, UpdateManifest::Result* result, std::string* error) { // Read the crx id. result->extension_id = GetAttribute(app, "appid"); if (result->extension_id.empty()) { *error = "Missing appid on app node"; return false; } // Get the tag. std::vector updates = GetChildren(app, "updatecheck"); if (updates.empty()) { *error = "Missing updatecheck on app."; return false; } return ParseUpdateCheckTag(updates[0], result, error); } bool UpdateManifest::Parse(const std::string& manifest_xml) { results_.daystart_elapsed_seconds = kNoDaystart; results_.list.clear(); errors_.clear(); if (manifest_xml.length() < 1) { ParseError("Empty xml"); return false; } std::string xml_errors; ScopedXmlErrorFunc error_func(&xml_errors, &XmlErrorFunc); // Start up the xml parser with the manifest_xml contents. ScopedXmlDocument document(xmlParseDoc( reinterpret_cast(manifest_xml.c_str()))); if (!document.get()) { ParseError("%s", xml_errors.c_str()); return false; } xmlNode* root = xmlDocGetRootElement(document.get()); if (!root) { ParseError("Missing root node"); return false; } if (!TagNameEquals(root, "response")) { ParseError("Missing response tag"); return false; } // Check for the response "protocol" attribute. if (GetAttribute(root, "protocol") != kExpectedResponseProtocol) { ParseError("Missing/incorrect protocol on response tag " "(expected '%s')", kExpectedResponseProtocol); return false; } // Parse the first if it is present. std::vector daystarts = GetChildren(root, "daystart"); if (!daystarts.empty()) { xmlNode* first = daystarts[0]; std::string elapsed_seconds = GetAttribute(first, "elapsed_seconds"); int parsed_elapsed = kNoDaystart; if (base::StringToInt(elapsed_seconds, &parsed_elapsed)) { results_.daystart_elapsed_seconds = parsed_elapsed; } } // Parse each of the tags. std::vector apps = GetChildren(root, "app"); for (size_t i = 0; i != apps.size(); ++i) { Result result; std::string error; if (ParseAppTag(apps[i], &result, &error)) { results_.list.push_back(result); } else { ParseError("%s", error.c_str()); } } return true; } } // namespace component_updater