ROSE 0.11.145.147
SgAsmPEImportSection.h
1
2#ifndef ROSE_SgAsmPEImportSection_H
3#define ROSE_SgAsmPEImportSection_H
4#include <RoseFirst.h>
5#include <Cxx_GrammarDeclarations.h>
6#include <SgAsmPESection.h>
7
8
9
10/* #line 1 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
11
12// WARNING -- GENERATED CODE -- DO NOT MODIFY THIS CODE -- WARNING!
13// This code is automatically generated for each
14// terminal and non-terminal within the defined
15// grammar. There is a simple way to change the
16// code to fix bugs etc. See the ROSE README file
17// for directions.
18
19// tps: (02/22/2010): Adding DLL export requirements
20#include "rosedll.h"
21
22// predeclarations for SgAsmPEImportSection
23
24/* #line 25 "../../../src/frontend/SageIII//SgAsmPEImportSection.h" */
25/* #line 2710 "/workspace/src/ROSETTA/src/binaryInstruction.C" */
26
27#include <Rose/BinaryAnalysis/RelativeVirtualAddress.h>
28
29#ifdef ROSE_SgAsmPEImportSection_IMPL
30#include <SgAsmPEImportDirectoryList.h>
31#endif
32
33
34/* #line 13 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro after subst for $PREDECLARATIONS" */
35
36/* #line 14 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
37
38#if !defined(DOCUMENTATION)
39// Class Definition for SgAsmPEImportSection
40class ROSE_DLL_API SgAsmPEImportSection : public SgAsmPESection
41 {
42 public:
43
44
45/* #line 46 "../../../src/frontend/SageIII//SgAsmPEImportSection.h" */
46
47 virtual SgNode* copy ( SgCopyHelp& help) const override;
48// Start of memberFunctionString
49/* #line 2871 "/workspace/src/ROSETTA/src/binaryInstruction.C" */
50
51
52 //----------------------- Boost serialization for SgAsmPEImportSection -----------------------
53#ifdef ROSE_HAVE_BOOST_SERIALIZATION_LIB
54private:
55 friend class boost::serialization::access;
56
57 template<class S>
58 void serialize(S &s, const unsigned /*version*/) {
59 debugSerializationBegin("SgAsmPEImportSection");
60 s & BOOST_SERIALIZATION_BASE_OBJECT_NVP(SgAsmPESection);
61 s & BOOST_SERIALIZATION_NVP(p_importDirectories);
62 debugSerializationEnd("SgAsmPEImportSection");
63 }
64#endif // ROSE_HAVE_BOOST_SERIALIZATION_LIB
65public:
66public:
72 SgAsmPEImportDirectoryList* const& get_importDirectories() const;
73 void set_importDirectories(SgAsmPEImportDirectoryList* const&);
75public:
77 virtual SgAsmPEImportSection *parse() override;
78 virtual bool reallocate() override;
79 virtual void unparse(std::ostream&) const override;
80 virtual void dump(FILE*, const char *prefix, ssize_t idx) const override;
81
83 void addImportDirectory(SgAsmPEImportDirectory*);
84
86 void removeImportDirectory(SgAsmPEImportDirectory*);
87 static bool showImportMessage();
88 static void importMessageReset();
89
97 size_t reallocateIats(Rose::BinaryAnalysis::RelativeVirtualAddress start_at);
98
99private:
100 static size_t mesg_nprinted; //counter for import_mesg()
101
103 // Deprecated 2023-11
105public:
106 SgAsmPEImportDirectoryList* get_import_directories() const ROSE_DEPRECATED("use get_importDirectories");
107 void set_import_directories(SgAsmPEImportDirectoryList*) ROSE_DEPRECATED("use set_importDirectories");
108 void add_import_directory(SgAsmPEImportDirectory*) ROSE_DEPRECATED("use addImportDirectory");
109 void remove_import_directory(SgAsmPEImportDirectory*) ROSE_DEPRECATED("use removeImportDirectory");
110 static bool show_import_mesg() ROSE_DEPRECATED("use showImportMessage");
111 static void import_mesg_reset() ROSE_DEPRECATED("use importMessageReset");
112 size_t reallocate_iats(Rose::BinaryAnalysis::RelativeVirtualAddress) ROSE_DEPRECATED("use reallocateIats");
113public:
115 virtual ~SgAsmPEImportSection();
116
117public:
120
121protected:
128 void initializeProperties();
129
130
131// End of memberFunctionString
132// Start of memberFunctionString
133/* #line 1 "/workspace/src/ROSETTA/Grammar/Common.code" */
134
135// *** COMMON CODE SECTION BEGINS HERE ***
136
137 public:
138
139 // DQ (3/25/3006): I put this back in because it had the logic for where the copy function required
140 // and not required which is required to match the other aspects of the copy mechanism code generation.
141 // Specifically it is a problem to declare the copy function everywhere because it is not implemented
142 // for the SgSymbol IR nodes. I'm not clear why it is not implemented for these IR nodes.
143 /* \brief Copies AST (whole subtree, depending on the SgCopyHelp class */
144 // virtual SgNode* copy ( const SgCopyHelp & help) const;
145
147 virtual std::string class_name() const override;
148
150 virtual VariantT variantT() const override; // MS: new variant used in tree traversal
151
153 // King84 (2010.08.16): Moved this to an enum to save space, since it's only used at compiler-time anyway.
154 // static const VariantT static_variant = V_SgAsmPEImportSection;
155 enum { static_variant = V_SgAsmPEImportSection };
156
157 /* the generated cast function */
159 ROSE_DLL_API friend SgAsmPEImportSection* isSgAsmPEImportSection( SgNode * s );
160
162 ROSE_DLL_API friend const SgAsmPEImportSection* isSgAsmPEImportSection( const SgNode * s );
163
164 // ******************************************
165 // * Memory Pool / New / Delete
166 // ******************************************
167
168 public:
170 static const unsigned pool_size; //
172 static std::vector<unsigned char *> pools; //
174 static SgAsmPEImportSection * next_node; //
175
177 static unsigned long initializeStorageClassArray(SgAsmPEImportSectionStorageClass *); //
178
180 static void clearMemoryPool(); //
181 static void deleteMemoryPool(); //
182
184 static void extendMemoryPoolForFileIO(); //
185
187 static SgAsmPEImportSection * getPointerFromGlobalIndex(unsigned long); //
189 static SgAsmPEImportSection * getPointerFromGlobalIndex(AstSpecificDataManagingClass *, unsigned long); //
190
192 static unsigned long getNumberOfValidNodesAndSetGlobalIndexInFreepointer(unsigned long); //
194 static void resetValidFreepointers(); //
196 static unsigned long getNumberOfLastValidPointer(); //
197
198
199#if defined(INLINE_FUNCTIONS)
201 inline void *operator new (size_t size);
202#else
204 void *operator new (size_t size);
205#endif
207 void operator delete (void* pointer, size_t size);
208
209 // DQ (4/5/2007): This is not the correct operator that we want, but appears to be required to compile ROSE with ROSE.
210 void operator delete (void* pointer)
211 {
212 // This is the generated delete operator...
213 SgAsmPEImportSection::operator delete (pointer,sizeof(SgAsmPEImportSection));
214 }
215
217 static size_t numberOfNodes();
218
220 static size_t memoryUsage();
221
222 // End of scope which started in IR nodes specific code
223 /* */
224
225 /* name Internal Functions
226 \brief Internal functions ... incomplete-documentation
227
228 These functions have been made public as part of the design, but they are suggested for internal use
229 or by particularly knowledgeable users for specialized tools or applications.
230
231 \internal We could not make these private because they are required by user for special purposes. And
232 it would be unwieldy to have many of the internal classes in ROSE be explicitly defined as friends.
233
234 */
235
236 // MS: 02/12/02 container of pointers to AST successor nodes used in the traversal
237 // overridden in every class by *generated* implementation
239 virtual std::vector<SgNode*> get_traversalSuccessorContainer() override;
240 // MS: 06/28/02 container of names of variables or container indices
241 // used used in the traversal to access AST successor nodes
242 // overridden in every class by *generated* implementation
245 virtual std::vector<std::string> get_traversalSuccessorNamesContainer() override;
246
247 // GB (09/25/2007): Functions for index-based access to traversal successors; these are hopefully a lot faster
248 // than all the vector copies. The implementation for these functions is generated for each class.
250 virtual size_t get_numberOfTraversalSuccessors() override;
252 virtual SgNode *get_traversalSuccessorByIndex(size_t idx) override;
254 virtual size_t get_childIndex(SgNode *child) override;
255
256#ifndef ROSE_USE_INTERNAL_FRONTEND_DEVELOPMENT
257 // MS: 08/16/2002 method for generating RTI information
259 virtual RTIReturnType roseRTI() override;
260#endif
261 /* */
262
263
264
265 /* name Deprecated Functions
266 \brief Deprecated functions ... incomplete-documentation
267
268 These functions have been deprecated from use.
269 */
270 /* */
271
273 virtual const char* sage_class_name() const override ROSE_DEPRECATED_FUNCTION;
274
275 // JJW (10/16/2008): Changed to a single function in Node.code, and put
276 // getVariant() in #if 0 block to prevent confusing Doxygen
277#if 0
279 virtual int variant() const ROSE_DEPRECATED_FUNCTION;
281 // virtual int getVariant() const ROSE_DEPRECATED_FUNCTION;
282#endif
283 /* */
284
285
286
287
288 public:
289 /* name Traversal Support Functions
290 \brief Traversal support functions ... incomplete-documentation
291
292 These functions have been made public as part of the design, but they are suggested for internal use
293 or by particularly knowledgable users for specialized tools or applications.
294 */
295 /* */
296
297 // DQ (11/26/2005): Support for visitor pattern mechanims
298 // (inferior to ROSE traversal mechanism, experimental).
302
303 /* DXN (08/09/2010): support for the classic visitor pattern done in GoF */
305 virtual void accept (ROSE_VisitorPattern & visitor) override;
306
307 // DQ (12/26/2005): Support for traversal based on the memory pool
310 static void traverseMemoryPoolNodes(ROSE_VisitTraversal & visit);
311
315
316 // DQ (2/9/2006): Added to support traversal over single representative of each IR node
317 // This traversal helps support internal tools that call static member functions.
318 // note: this function operates on the memory pools.
321 static void visitRepresentativeNode (ROSE_VisitTraversal & visit);
322 /* */
323
324 public:
325 /* NodeId support functions */
327 static SgNode* getNodeByNodeId(VariantT variantT, size_t poolIdx, size_t itemIdx);
330 static SgAsmPEImportSection* getNodeByNodeIdInternal(size_t poolIdx, size_t itemIdx);
333 static std::string getNodeIdString(SgAsmPEImportSection* sgnode);
334 static std::string getNodeIdStringInternal(SgAsmPEImportSection* sgnode);
335
336 public:
337 /* name Memory Allocation Functions
338 \brief Memory allocations functions ... incomplete-documentation
339
340 These functions have been made public as part of the design, but they are suggested for internal use
341 or by particularly knowledgable users for specialized tools or applications.
342 */
343 /* */
344
355 virtual bool isInMemoryPool() override;
356
367 virtual void checkDataMemberPointersIfInMemoryPool() override;
368
369 // DQ (4/30/2006): Modified to be a const function.
384 virtual std::vector<std::pair<SgNode*,std::string> > returnDataMemberPointers() const override;
385
396
408 virtual long getChildIndex( SgNode* childNode ) const override;
409
410 // DQ (9/2/2015): Since this function is generated by ROSETTA, we can't define the
411 // comment here (changed to be a C style comment and not be a doxygen comment).
412 /* \brief Constructor for use by AST File I/O Mechanism
413
414 This constructor permits the IR node to be rebuilt from the contiguously arranged data in memory
415 which obtained via fast binary file I/O from disk.
416 */
417 // SgAsmPEImportSection( SgAsmPEImportSectionStorageClass& source );
418
419
420
421
422
423 // JH (10/24/2005): methods added to support the ast file IO
424 private:
425
426 /* name AST Memory Allocation Support Functions
427 \brief Memory allocations support....
428
429 These functions handle the low leve support of the memory allocation scheme which permits IR nodes to be allocated
430 in large contiguous blocks to reduce memory fragmentation, improve performance, support specialized access (AST traversals),
431 and support the AST File I/O Mechanism.
432 */
433 /* */
434
435 /* JH (10/24/2005): Two typedefs. The TestType notes the type every pointer is cast to before
436 we compare them. Since I had several problems with this, I decided to make a typdef to ensure
437 that I use the same type everywhere, if any changes are made. THe second one declares the type
438 (actually unsigned long) where teh pointer address gets converted to. On 64 bit platforms this
439 might got changed, but unfortunatly, the return types are still unsigned longs. There exists
440 a correspinding one in the AST_FILE_IO class!
441 */
442 // DQ (9/2/2015): This typedef is no longer used, we can't define the
443 // comment here (changed to be a C style comment and not be a doxygen comment).
444 /* \brief Typedef used for low level memory access.
445 */
446 // typedef unsigned char* TestType;
447
448 // DQ (9/2/2015): This typedef is no longer used, we can't define the
449 // comment here (changed to be a C style comment and not be a doxygen comment).
450 /* \brief Typedef used to hold memory addresses as values.
451 */
452 // typedef unsigned long AddressType;
453
454
455
456 // necessary, to have direct access to the p_freepointer and the private methods !
458 friend class AST_FILE_IO;
459
461 friend class SgAsmPEImportSectionStorageClass;
462
464 friend class AstSpecificDataManagingClass;
465
467 friend class AstSpecificDataManagingClassStorageClass;
468 public:
470 SgAsmPEImportSection( const SgAsmPEImportSectionStorageClass& source );
471
472 // private: // JJW hack
473 /*
474 name AST Memory Allocation Support Variables
475 Memory allocations support variables
476
477 These variables handle the low level support of the memory allocation scheme which permits IR nodes to be allocated
478 in large contiguous blocks to reduce memory fragmentation, improve performance, support specialized access (AST traversals),
479 and support the AST File I/O Mechanism.
480 */
481 /* */
482
483 public:
484
485 // DQ (11/21/2009): Added function to add new Regular Expression attributes and return pointer
486 // to current node (so that it will work cleanly with build functions to specify patterns).
487 // virtual SgNode* addRegExpAttribute();
494
495#ifndef _MSC_VER
496// Rasmussen (04/17/2019): Support for ATerms has been deprecated as it is no longer needed
497// and likely never fully implemented nor tested. Files remain in the src tree but are no
498// longer built.
499#define BUILD_ATERM_SUPPORT 0
500 #if BUILD_ATERM_SUPPORT
501 #ifdef ROSE_USE_ROSE_ATERM_SUPPORT
502 // DQ (10/4/2014): Adding ATerm support to ROSE.
512 // Rasmussen (1/7/2019): Added override to kill warning messages of overridden virtual function
513 virtual ATerm generate_ATerm() override;
514
516 virtual void generate_ATerm_Annotation(ATerm & term) override;
517 #endif
518 #endif // BUILD_ATERM_SUPPORT
519#endif
520 // These can't be virtual functions since we don't yet know what IR node to build (until we have read the aterm).
521 // virtual generate_AST(ATerm & term);
522 // virtual void read_ATerm_Annotation(ATerm & term);
523
524// *** COMMON CODE SECTION ENDS HERE ***
525
526
527// End of memberFunctionString
528// Start of memberFunctionString
529/* #line 706 "/workspace/src/ROSETTA/Grammar/Node.code" */
530
531 // the generated cast function
532 // friend ROSE_DLL_API SgAsmPEImportSection* isSgAsmPEImportSection ( SgNode* s );
533
534 typedef SgAsmPESection base_node_type;
535
536
537// End of memberFunctionString
538
539
540 protected:
541// Start of memberFunctionString
542SgAsmPEImportDirectoryList* p_importDirectories;
543
544// End of memberFunctionString
545
547 friend struct Rose::Traits::generated::describe_field_t<SgAsmPEImportSection, SgAsmPEImportDirectoryList*,&SgAsmPEImportSection::p_importDirectories>;
548
549/* #line 21 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
550
551
552 };
553#endif
554
555// postdeclarations for SgAsmPEImportSection
556
557/* #line 558 "../../../src/frontend/SageIII//SgAsmPEImportSection.h" */
558
559/* #line 27 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro after subst for $POSTDECLARATIONS" */
560
561/* #line 28 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
562
563
564/* #line 565 "../../../src/frontend/SageIII//SgAsmPEImportSection.h" */
565
566#endif // ROSE_SgAsmPEImportSection_H
567
Class holding static data and functions supporting File I/O.
Definition AST_FILE_IO.h:19
Attribute containing a regex expression as a string.
Optionally bound relative virtual address.
virtual SgAsmGenericSection * parse()
Parse contents of the section.
virtual void unparse(std::ostream &) const
Write a section back to the file.
Windows PE file header.
A list of PE Import Directories.
One import directory per library.
Portable Executable Import Section.
Base class for PE sections.
virtual bool reallocate() override
Called prior to unparse to make things consistent.
virtual void dump(FILE *, const char *prefix, ssize_t idx) const override
Print some debugging info.
Supporting class from copy mechanism within ROSE.
Definition sageCopy.h:26
This class represents the base class for all IR nodes within Sage III.
virtual size_t get_numberOfTraversalSuccessors()
return number of children in the traversal successor list
virtual RTIReturnType roseRTI()
return C++ Runtime-Time-Information
virtual std::vector< std::string > get_traversalSuccessorNamesContainer()
container of names of variables or container indices used used in the traversal to access AST success...
virtual void debugSerializationEnd(const char *className)
Called by generated serializers.
static std::string getNodeIdString(SgNode *sgnode)
compute the NodeId for a particular SgNode*.
virtual bool isInMemoryPool()
FOR INTERNAL USE This is used in internal tests to verify that all IR nodes are allocated from the he...
int variant() const
Older version function returns enum value "NODE".
virtual void processDataMemberReferenceToPointers(ReferenceToPointerHandler *)
FOR INTERNAL USE Processes pairs of references to SgNode* and strings for use in AST tools
virtual long getChildIndex(SgNode *childNode) const
FOR INTERNAL USE Returns a unique index value for the childNode in the list of children at this IR no...
virtual size_t get_childIndex(SgNode *child)
index-based access to traversal successors by child node
virtual void debugSerializationBegin(const char *className)
Called by generated serializers.
virtual std::vector< SgNode * > get_traversalSuccessorContainer()
container of pointers to AST successor nodes used in the traversal overridden in every class by gener...
static void visitRepresentativeNode(ROSE_VisitTraversal &visit)
FOR INTERNAL USE Support for type-based traversal.
virtual void checkDataMemberPointersIfInMemoryPool()
FOR INTERNAL USE This is used in internal tests to verify that all IR nodes are allocated from the he...
static size_t numberOfNodes()
Returns the total number of IR nodes of this type.
virtual void accept(ROSE_VisitorPattern &visitor)
support for the classic visitor pattern done in GoF
virtual SgNode * get_traversalSuccessorByIndex(size_t idx)
index-based access to traversal successors by index number
static void traverseMemoryPoolVisitorPattern(ROSE_VisitorPattern &visitor)
FOR INTERNAL USE Support for visitor pattern.
void executeVisitorMemberFunction(ROSE_VisitorPattern &visitor)
FOR INTERNAL USE Support for visitor pattern.
static SgNode * getNodeByNodeId(VariantT variantT, size_t poolIdx, size_t itemIdx)
Find a node by its variant type, pool index, and item index.
static size_t memoryUsage()
Returns the size in bytes of the total memory allocated for all IR nodes of this type.
static void traverseMemoryPoolNodes(ROSE_VisitTraversal &visit)
FOR INTERNAL USE Support for visitor pattern over all IR nodes by type of IR node.
virtual const char * sage_class_name() const
generates string representing the class name: (e.g. for SgNode returns "SgNode").
virtual std::vector< std::pair< SgNode *, std::string > > returnDataMemberPointers() const
FOR INTERNAL USE Returns STL vector of pairs of SgNode* and strings for use in AST tools
static SgNode * getNodeByNodeIdInternal(size_t poolIdx, size_t itemIdx)
FOR INTERNAL USE Find an SgNode from its memory pool and location therin.
SgNode * addRegExpAttribute(std::string s, AstRegExAttribute *a)
Support for AST matching using regular expression.
void serialize(std::ostream &output, Graph &graph)
Serialize a graph into a stream of bytes.
The ROSE library.
void copy(const Word *src, const BitRange &srcRange, Word *dst, const BitRange &dstRange)
Copy some bits.