| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UNPACKER_H_ | 5 #ifndef CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UNPACKER_H_ |
| 6 #define CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UNPACKER_H_ | 6 #define CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UNPACKER_H_ |
| 7 | 7 |
| 8 #include <string> |
| 8 #include <vector> | 9 #include <vector> |
| 9 | 10 #include "base/basictypes.h" |
| 10 #include "base/files/file_path.h" | 11 #include "base/files/file_path.h" |
| 11 | 12 |
| 12 class ComponentInstaller; | 13 class ComponentInstaller; |
| 14 class ComponentPatcher; |
| 13 | 15 |
| 14 // In charge of unpacking the component CRX package and verifying that it is | 16 // In charge of unpacking the component CRX package and verifying that it is |
| 15 // well formed and the cryptographic signature is correct. If there is no | 17 // well formed and the cryptographic signature is correct. If there is no |
| 16 // error the component specific installer will be invoked to proceed with | 18 // error the component specific installer will be invoked to proceed with |
| 17 // the component installation or update. | 19 // the component installation or update. |
| 18 // | 20 // |
| 19 // This class should be used only by the component updater. It is inspired | 21 // This class should be used only by the component updater. It is inspired |
| 20 // and overlaps with code in the extension's SandboxedUnpacker. | 22 // and overlaps with code in the extension's SandboxedUnpacker. |
| 21 // The main differences are: | 23 // The main differences are: |
| 22 // - The public key hash is full SHA256. | 24 // - The public key hash is full SHA256. |
| 23 // - Does not use a sandboxed unpacker. A valid component is fully trusted. | 25 // - Does not use a sandboxed unpacker. A valid component is fully trusted. |
| 24 // - The manifest can have different attributes and resources are not | 26 // - The manifest can have different attributes and resources are not |
| 25 // transcoded. | 27 // transcoded. |
| 26 class ComponentUnpacker { | 28 class ComponentUnpacker { |
| 27 public: | 29 public: |
| 28 // Possible error conditions. | 30 // Possible error conditions. |
| 31 // Add only to the bottom of this enum; the order must be kept stable. |
| 29 enum Error { | 32 enum Error { |
| 30 kNone, | 33 kNone, |
| 31 kInvalidParams, | 34 kInvalidParams, |
| 32 kInvalidFile, | 35 kInvalidFile, |
| 33 kUzipPathError, | 36 kUnzipPathError, |
| 34 kUnzipFailed, | 37 kUnzipFailed, |
| 35 kNoManifest, | 38 kNoManifest, |
| 36 kBadManifest, | 39 kBadManifest, |
| 37 kBadExtension, | 40 kBadExtension, |
| 38 kInvalidId, | 41 kInvalidId, |
| 39 kInstallerError, | 42 kInstallerError, |
| 43 kIoError, |
| 44 kDeltaVerificationFailure, |
| 45 kDeltaBadCommands, |
| 46 kDeltaUnsupportedCommand, |
| 47 kDeltaOperationFailure, |
| 48 kDeltaPatchProcessFailure, |
| 49 kDeltaMissingExistingFile, |
| 50 kFingerprintWriteFailed, |
| 40 }; | 51 }; |
| 41 // Unpacks, verifies and calls the installer. |pk_hash| is the expected | 52 // Unpacks, verifies and calls the installer. |pk_hash| is the expected |
| 42 // public key SHA256 hash. |path| is the current location of the CRX. | 53 // public key SHA256 hash. |path| is the current location of the CRX. |
| 43 ComponentUnpacker(const std::vector<uint8>& pk_hash, | 54 ComponentUnpacker(const std::vector<uint8>& pk_hash, |
| 44 const base::FilePath& path, | 55 const base::FilePath& path, |
| 56 const std::string& fingerprint, |
| 57 ComponentPatcher* patcher, |
| 45 ComponentInstaller* installer); | 58 ComponentInstaller* installer); |
| 46 | 59 |
| 47 // If something went wrong during unpacking or installer invocation, the | 60 // If something went wrong during unpacking or installer invocation, the |
| 48 // destructor will delete the unpacked CRX files. | 61 // destructor will delete the unpacked CRX files. |
| 49 ~ComponentUnpacker(); | 62 ~ComponentUnpacker(); |
| 50 | 63 |
| 51 Error error() const { return error_; } | 64 Error error() const { return error_; } |
| 52 | 65 |
| 66 int extended_error() const { return extended_error_; } |
| 67 |
| 53 private: | 68 private: |
| 54 base::FilePath unpack_path_; | 69 base::FilePath unpack_path_; |
| 55 Error error_; | 70 Error error_; |
| 71 int extended_error_; // Provides additional error information. |
| 56 }; | 72 }; |
| 57 | 73 |
| 58 #endif // CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UNPACKER_H_ | 74 #endif // CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UNPACKER_H_ |
| OLD | NEW |