122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao//===- ObjectBuilder.h ----------------------------------------------------===// 222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao// 322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao// The MCLinker Project 422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao// 522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao// This file is distributed under the University of Illinois Open Source 622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao// License. See LICENSE.TXT for details. 722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao// 822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao//===----------------------------------------------------------------------===// 922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#ifndef MCLD_OBJECT_OBJECT_BUILDER_H 1022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#define MCLD_OBJECT_OBJECT_BUILDER_H 1122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#ifdef ENABLE_UNITTEST 1222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#include <gtest.h> 1322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#endif 1422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#include <mcld/LD/LDFileFormat.h> 1522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#include <mcld/LD/EhFrame.h> 1622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 1722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#include <llvm/Support/DataTypes.h> 1822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 1922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#include <string> 2022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 2122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaonamespace mcld { 2222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 2322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoclass LinkerConfig; 2422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoclass Module; 2522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoclass LDSection; 2622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoclass SectionData; 2722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoclass RelocData; 2822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoclass Fragment; 2922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoclass Relocation; 3022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 3122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao/** \class ObjectBuilder 3222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao * \brief ObjectBuilder recieve ObjectAction and build the mcld::Module. 3322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao */ 3422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoclass ObjectBuilder 3522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao{ 3622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaopublic: 3722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao ObjectBuilder(const LinkerConfig& pConfig, 3822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao Module& pTheModule); 3922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 4022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao/// @} 4122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao/// @name Section Methods 4222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao/// @{ 4322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// CreateSection - To create an output LDSection in mcld::Module. 4422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// Link scripts and command line options define some SECTIONS commands that 4522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// specify where input sections are placed into output sections. This function 4622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// checks SECTIONS commands to change given name to the output section name. 4722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// This function creates a new LDSection and push the created LDSection into 4822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @ref mcld::Module. 4922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// 5022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// To create an input LDSection in mcld::LDContext, use @ref LDSection::Create(). 5122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// 5222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @see SectionMap 5322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// 5422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @param [in] pName The given name. Returned LDSection used the changed name 5522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// by SectionMap. 5622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao LDSection* CreateSection(const std::string& pInputName, 5722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao LDFileFormat::Kind pKind, 5822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao uint32_t pType, 5922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao uint32_t pFlag, 6022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao uint32_t pAlign = 0x0); 6122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 6222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// MergeSection - merge the pInput section to mcld::Module. 6322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// This function moves all fragments in pInputSection to the corresponding 6422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// output section of mcld::Module. 6522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// 6622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @see SectionMap 6722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @param [in] pInputSection The merged input section. 686f75755c9204b1d8817ae5a65a2f7e5af0ec3f70Stephen Hines /// @return The merged output section. If the corresponding output sections 696f75755c9204b1d8817ae5a65a2f7e5af0ec3f70Stephen Hines /// is not defined, return NULL. 706f75755c9204b1d8817ae5a65a2f7e5af0ec3f70Stephen Hines LDSection* MergeSection(LDSection& pInputSection); 7122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 7222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// MoveSectionData - move the fragment of pFrom to pTo section data. 7322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao static bool MoveSectionData(SectionData& pFrom, SectionData& pTo); 7422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 756f75755c9204b1d8817ae5a65a2f7e5af0ec3f70Stephen Hines /// UpdateSectionAlign - update alignment for input section 766f75755c9204b1d8817ae5a65a2f7e5af0ec3f70Stephen Hines static void UpdateSectionAlign(LDSection& pTo, const LDSection& pFrom); 776f75755c9204b1d8817ae5a65a2f7e5af0ec3f70Stephen Hines 7822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao/// @} 7922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao/// @name Fragment Methods 8022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao/// @{ 8122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// AppendFragment - To append pFrag to the given SectionData pSD. 8222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// In order to keep the alignment of pFrag, This function inserts an 8322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// AlignFragment before pFrag if pAlignConstraint is larger than 1. 8422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// 8522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @note This function does not update the alignment constraint of LDSection. 8622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// 8722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @param [in, out] pFrag The appended fragment. The offset of the appended 8822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// pFrag is set to the offset in pSD. 8922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @param [in, out] pSD The section data being appended. 9022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @param [in] pAlignConstraint The alignment constraint. 9122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao /// @return Total size of the inserted fragments. 9222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao static uint64_t AppendFragment(Fragment& pFrag, SectionData& pSD, 9322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao uint32_t pAlignConstraint = 1); 9422add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 9522add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liaoprivate: 9622add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao const LinkerConfig& m_Config; 9722add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao Module& m_Module; 9822add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao}; 9922add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 10022add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao} // namespace of mcld 10122add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 10222add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao#endif 10322add6ff3426df1a85089fe6a6e1597ee3b6f300Shih-wei Liao 104