OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 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 COURGETTE_DISASSEMBLER_H_ | 5 #ifndef COURGETTE_DISASSEMBLER_H_ |
6 #define COURGETTE_DISASSEMBLER_H_ | 6 #define COURGETTE_DISASSEMBLER_H_ |
7 | 7 |
8 #include "base/basictypes.h" | 8 #include <stddef.h> |
| 9 #include <stdint.h> |
9 | 10 |
| 11 #include "base/macros.h" |
10 #include "courgette/courgette.h" | 12 #include "courgette/courgette.h" |
11 #include "courgette/image_utils.h" | 13 #include "courgette/image_utils.h" |
12 | 14 |
13 namespace courgette { | 15 namespace courgette { |
14 | 16 |
15 class AssemblyProgram; | 17 class AssemblyProgram; |
16 | 18 |
17 class Disassembler { | 19 class Disassembler { |
18 public: | 20 public: |
19 virtual ~Disassembler(); | 21 virtual ~Disassembler(); |
20 | 22 |
21 virtual ExecutableType kind() { return EXE_UNKNOWN; } | 23 virtual ExecutableType kind() { return EXE_UNKNOWN; } |
22 | 24 |
23 // ok() may always be called but returns 'true' only after ParseHeader | 25 // ok() may always be called but returns 'true' only after ParseHeader |
24 // succeeds. | 26 // succeeds. |
25 bool ok() const { return failure_reason_ == NULL; } | 27 bool ok() const { return failure_reason_ == NULL; } |
26 | 28 |
27 // Returns 'true' if the buffer appears to be a valid executable of the | 29 // Returns 'true' if the buffer appears to be a valid executable of the |
28 // expected type. It is not required that this be called before Disassemble. | 30 // expected type. It is not required that this be called before Disassemble. |
29 virtual bool ParseHeader() = 0; | 31 virtual bool ParseHeader() = 0; |
30 | 32 |
31 // Disassembles the item passed to the factory method into the output | 33 // Disassembles the item passed to the factory method into the output |
32 // parameter 'program'. | 34 // parameter 'program'. |
33 virtual bool Disassemble(AssemblyProgram* program) = 0; | 35 virtual bool Disassemble(AssemblyProgram* program) = 0; |
34 | 36 |
35 // Returns the length of the source executable. May reduce after ParseHeader. | 37 // Returns the length of the source executable. May reduce after ParseHeader. |
36 size_t length() const { return length_; } | 38 size_t length() const { return length_; } |
37 const uint8* start() const { return start_; } | 39 const uint8_t* start() const { return start_; } |
38 const uint8* end() const { return end_; } | 40 const uint8_t* end() const { return end_; } |
39 | 41 |
40 // Returns a pointer into the memory copy of the file format. | 42 // Returns a pointer into the memory copy of the file format. |
41 // FileOffsetToPointer(0) returns a pointer to the start of the file format. | 43 // FileOffsetToPointer(0) returns a pointer to the start of the file format. |
42 const uint8* OffsetToPointer(size_t offset) const; | 44 const uint8_t* OffsetToPointer(size_t offset) const; |
43 | 45 |
44 protected: | 46 protected: |
45 Disassembler(const void* start, size_t length); | 47 Disassembler(const void* start, size_t length); |
46 | 48 |
47 bool Good(); | 49 bool Good(); |
48 bool Bad(const char *reason); | 50 bool Bad(const char *reason); |
49 | 51 |
50 // Returns true if the array lies within our memory region. | 52 // Returns true if the array lies within our memory region. |
51 bool IsArrayInBounds(size_t offset, size_t elements, size_t element_size) { | 53 bool IsArrayInBounds(size_t offset, size_t elements, size_t element_size) { |
52 return offset <= length() && elements <= (length() - offset) / element_size; | 54 return offset <= length() && elements <= (length() - offset) / element_size; |
53 } | 55 } |
54 | 56 |
55 // Reduce the length of the image in memory. Does not actually free | 57 // Reduce the length of the image in memory. Does not actually free |
56 // (or realloc) any memory. Usually only called via ParseHeader() | 58 // (or realloc) any memory. Usually only called via ParseHeader() |
57 void ReduceLength(size_t reduced_length); | 59 void ReduceLength(size_t reduced_length); |
58 | 60 |
59 private: | 61 private: |
60 const char* failure_reason_; | 62 const char* failure_reason_; |
61 | 63 |
62 // | 64 // |
63 // Basic information that is always valid after Construction, though | 65 // Basic information that is always valid after Construction, though |
64 // ParseHeader may shorten the length if the executable is shorter than | 66 // ParseHeader may shorten the length if the executable is shorter than |
65 // the total data. | 67 // the total data. |
66 // | 68 // |
67 size_t length_; // In current memory. | 69 size_t length_; // In current memory. |
68 const uint8* start_; // In current memory, base for 'file offsets'. | 70 const uint8_t* start_; // In current memory, base for 'file offsets'. |
69 const uint8* end_; // In current memory. | 71 const uint8_t* end_; // In current memory. |
70 | 72 |
71 DISALLOW_COPY_AND_ASSIGN(Disassembler); | 73 DISALLOW_COPY_AND_ASSIGN(Disassembler); |
72 }; | 74 }; |
73 | 75 |
74 } // namespace courgette | 76 } // namespace courgette |
75 | 77 |
76 #endif // COURGETTE_DISASSEMBLER_H_ | 78 #endif // COURGETTE_DISASSEMBLER_H_ |
OLD | NEW |