| Index: tools/relocation_packer/src/packer.h
|
| diff --git a/tools/relocation_packer/src/packer.h b/tools/relocation_packer/src/packer.h
|
| index 21e4de1a32e5e3d5f08496ea974b010bd8d52bda..db09ce8cc22f6ed6055a0916c80f9ed494724a67 100644
|
| --- a/tools/relocation_packer/src/packer.h
|
| +++ b/tools/relocation_packer/src/packer.h
|
| @@ -2,21 +2,44 @@
|
| // Use of this source code is governed by a BSD-style license that can be
|
| // found in the LICENSE file.
|
|
|
| -// Pack ARM relative relocations into a more compact form.
|
| +// Pack relative relocations into a more compact form.
|
| +//
|
| +//
|
| +// For relative relocations without addends (32 bit platforms)
|
| +// -----------------------------------------------------------
|
| //
|
| // Applies two packing strategies. The first is run-length encoding, which
|
| -// turns a large set of ARM relative relocations into a much smaller set
|
| +// turns a large set of relative relocations into a much smaller set
|
| // of delta-count pairs, prefixed with a two-word header comprising the
|
| // count of pairs and the initial relocation offset. The second is LEB128
|
| -// encoding, which compacts the result of run-length encoding.
|
| +// encoding, which compresses the result of run-length encoding.
|
| //
|
| // Once packed, data is prefixed by an identifier that allows for any later
|
| // versioning of packing strategies.
|
| //
|
| -// A complete packed stream might look something like:
|
| +// A complete packed stream of relocations without addends might look
|
| +// something like:
|
| //
|
| // "APR1" pairs init_offset count1 delta1 count2 delta2 ...
|
| // 41505231 f2b003 b08ac716 e001 04 01 10 ...
|
| +//
|
| +//
|
| +// For relative relocations with addends (64 bit platforms)
|
| +// --------------------------------------------------------
|
| +//
|
| +// Applies two packing strategies. The first is delta encoding, which
|
| +// turns a large set of relative relocations into a smaller set
|
| +// of offset and addend delta pairs, prefixed with a header indicating the
|
| +// count of pairs. The second is signed LEB128 encoding, which compacts
|
| +// the result of delta encoding.
|
| +//
|
| +// Once packed, data is prefixed by an identifier that allows for any later
|
| +// versioning of packing strategies.
|
| +//
|
| +// A complete packed stream might look something like:
|
| +//
|
| +// "APA1" pairs offset_d1 addend_d1 offset_d2 addend_d2 ...
|
| +// 41505232 f2b018 04 28 08 9f01 ...
|
|
|
| #ifndef TOOLS_RELOCATION_PACKER_SRC_PACKER_H_
|
| #define TOOLS_RELOCATION_PACKER_SRC_PACKER_H_
|
| @@ -29,21 +52,25 @@
|
|
|
| namespace relocation_packer {
|
|
|
| -// A RelocationPacker packs vectors of ARM relative relocations into more
|
| +// A RelocationPacker packs vectors of relative relocations into more
|
| // compact forms, and unpacks them to reproduce the pre-packed data.
|
| class RelocationPacker {
|
| public:
|
| - // Pack ARM relative relocations into a more compact form.
|
| - // |relocations| is a vector of ARM relative relocation structs.
|
| + // Pack relative relocations into a more compact form.
|
| + // |relocations| is a vector of relative relocation structs.
|
| // |packed| is the vector of packed bytes into which relocations are packed.
|
| static void PackRelativeRelocations(const std::vector<ELF::Rel>& relocations,
|
| std::vector<uint8_t>* packed);
|
| + static void PackRelativeRelocations(const std::vector<ELF::Rela>& relocations,
|
| + std::vector<uint8_t>* packed);
|
|
|
| - // Unpack ARM relative relocations from their more compact form.
|
| + // Unpack relative relocations from their more compact form.
|
| // |packed| is the vector of packed relocations.
|
| - // |relocations| is a vector of unpacked ARM relative relocation structs.
|
| + // |relocations| is a vector of unpacked relative relocation structs.
|
| static void UnpackRelativeRelocations(const std::vector<uint8_t>& packed,
|
| std::vector<ELF::Rel>* relocations);
|
| + static void UnpackRelativeRelocations(const std::vector<uint8_t>& packed,
|
| + std::vector<ELF::Rela>* relocations);
|
| };
|
|
|
| } // namespace relocation_packer
|
|
|