| OLD | NEW |
| (Empty) |
| 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 | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef EXTENSIONS_COMMON_CRX_FILE_H_ | |
| 6 #define EXTENSIONS_COMMON_CRX_FILE_H_ | |
| 7 | |
| 8 #include <sys/types.h> | |
| 9 #include "base/basictypes.h" | |
| 10 #include "base/memory/scoped_ptr.h" | |
| 11 | |
| 12 namespace extensions { | |
| 13 | |
| 14 // CRX files have a header that includes a magic key, version number, and | |
| 15 // some signature sizing information. Use CrxFile object to validate whether | |
| 16 // the header is valid or not. | |
| 17 class CrxFile { | |
| 18 public: | |
| 19 // The size of the magic character sequence at the beginning of each crx | |
| 20 // file, in bytes. This should be a multiple of 4. | |
| 21 static const size_t kCrxFileHeaderMagicSize = 4; | |
| 22 | |
| 23 // This header is the first data at the beginning of an extension. Its | |
| 24 // contents are purposely 32-bit aligned so that it can just be slurped into | |
| 25 // a struct without manual parsing. | |
| 26 struct Header { | |
| 27 char magic[kCrxFileHeaderMagicSize]; | |
| 28 uint32 version; | |
| 29 uint32 key_size; // The size of the public key, in bytes. | |
| 30 uint32 signature_size; // The size of the signature, in bytes. | |
| 31 // An ASN.1-encoded PublicKeyInfo structure follows. | |
| 32 // The signature follows. | |
| 33 }; | |
| 34 | |
| 35 enum Error { | |
| 36 kWrongMagic, | |
| 37 kInvalidVersion, | |
| 38 kInvalidKeyTooLarge, | |
| 39 kInvalidKeyTooSmall, | |
| 40 kInvalidSignatureTooLarge, | |
| 41 kInvalidSignatureTooSmall, | |
| 42 }; | |
| 43 | |
| 44 // Construct a new CRX file header object with bytes of a header | |
| 45 // read from a CRX file. If a null scoped_ptr is returned, |error| | |
| 46 // contains an error code with additional information. | |
| 47 static scoped_ptr<CrxFile> Parse(const Header& header, Error* error); | |
| 48 | |
| 49 // Construct a new header for the given key and signature sizes. | |
| 50 // Returns a null scoped_ptr if erroneous values of |key_size| and/or | |
| 51 // |signature_size| are provided. |error| contains an error code with | |
| 52 // additional information. | |
| 53 // Use this constructor and then .header() to obtain the Header | |
| 54 // for writing out to a CRX file. | |
| 55 static scoped_ptr<CrxFile> Create(const uint32 key_size, | |
| 56 const uint32 signature_size, | |
| 57 Error* error); | |
| 58 | |
| 59 // Returns the header structure for writing out to a CRX file. | |
| 60 const Header& header() const { return header_; } | |
| 61 | |
| 62 // Checks a valid |header| to determine whether or not the CRX represents a | |
| 63 // differential CRX. | |
| 64 static bool HeaderIsDelta(const Header& header); | |
| 65 | |
| 66 private: | |
| 67 Header header_; | |
| 68 | |
| 69 // Constructor is private. Clients should use static factory methods above. | |
| 70 explicit CrxFile(const Header& header); | |
| 71 | |
| 72 // Checks the |header| for validity and returns true if the values are valid. | |
| 73 // If false is returned, more detailed error code is returned in |error|. | |
| 74 static bool HeaderIsValid(const Header& header, Error* error); | |
| 75 }; | |
| 76 | |
| 77 } // namespace extensions | |
| 78 | |
| 79 #endif // EXTENSIONS_COMMON_CRX_FILE_H_ | |
| OLD | NEW |