ROSE 0.11.145.192
SgAsmGenericDLL.h
1
2#ifndef ROSE_SgAsmGenericDLL_H
3#define ROSE_SgAsmGenericDLL_H
4#include <RoseFirst.h>
5#include <Cxx_GrammarDeclarations.h>
6#include <SgAsmExecutableFileFormat.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 SgAsmGenericDLL
23
24/* #line 25 "../../../src/frontend/SageIII//SgAsmGenericDLL.h" */
25/* #line 15968 "/workspace/src/ROSETTA/src/binaryInstruction.C" */
26
27#include <sageContainer.h>
28
29#ifdef ROSE_SgAsmGenericDLL_IMPL
30#include <SgAsmBasicString.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 SgAsmGenericDLL
40class ROSE_DLL_API SgAsmGenericDLL : public SgAsmExecutableFileFormat
41 {
42 public:
43
44
45/* #line 46 "../../../src/frontend/SageIII//SgAsmGenericDLL.h" */
46
47 virtual SgNode* copy ( SgCopyHelp& help) const override;
48// Start of memberFunctionString
49/* #line 15994 "/workspace/src/ROSETTA/src/binaryInstruction.C" */
50
51
52 //----------------------- Boost serialization for SgAsmGenericDLL -----------------------
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("SgAsmGenericDLL");
60 s & BOOST_SERIALIZATION_BASE_OBJECT_NVP(SgAsmExecutableFileFormat);
61 s & BOOST_SERIALIZATION_NVP(p_name);
62 s & BOOST_SERIALIZATION_NVP(p_symbols);
63 debugSerializationEnd("SgAsmGenericDLL");
64 }
65#endif // ROSE_HAVE_BOOST_SERIALIZATION_LIB
66public:
67public:
71 SgAsmGenericString* const& get_name() const;
74public:
78 SgStringList const& get_symbols() const;
79 void set_symbols(SgStringList const&);
81public:
84
86 virtual void dump(FILE*, const char *prefix, ssize_t idx) const;
87
89 void addSymbol(const std::string&);
90
92 // Deprecated 2023-11
94public:
95 void add_symbol(const std::string&) ROSE_DEPRECATED("use addSymbol");
96public:
98 virtual ~SgAsmGenericDLL();
99
100public:
103
104protected:
112
113
114// End of memberFunctionString
115// Start of memberFunctionString
116/* #line 1 "/workspace/src/ROSETTA/Grammar/Common.code" */
117
118// *** COMMON CODE SECTION BEGINS HERE ***
119
120 public:
121
122 // DQ (3/25/3006): I put this back in because it had the logic for where the copy function required
123 // and not required which is required to match the other aspects of the copy mechanism code generation.
124 // Specifically it is a problem to declare the copy function everywhere because it is not implemented
125 // for the SgSymbol IR nodes. I'm not clear why it is not implemented for these IR nodes.
126 /* \brief Copies AST (whole subtree, depending on the SgCopyHelp class */
127 // virtual SgNode* copy ( const SgCopyHelp & help) const;
128
130 virtual std::string class_name() const override;
131
133 virtual VariantT variantT() const override; // MS: new variant used in tree traversal
134
136 // King84 (2010.08.16): Moved this to an enum to save space, since it's only used at compiler-time anyway.
137 // static const VariantT static_variant = V_SgAsmGenericDLL;
138 enum { static_variant = V_SgAsmGenericDLL };
139
140 /* the generated cast function */
142 ROSE_DLL_API friend SgAsmGenericDLL* isSgAsmGenericDLL( SgNode * s );
143
145 ROSE_DLL_API friend const SgAsmGenericDLL* isSgAsmGenericDLL( const SgNode * s );
146
147 // ******************************************
148 // * Memory Pool / New / Delete
149 // ******************************************
150
151 public:
153 static const unsigned pool_size; //
155 static std::vector<unsigned char *> pools; //
157 static SgAsmGenericDLL * next_node; //
158
160 static unsigned long initializeStorageClassArray(SgAsmGenericDLLStorageClass *); //
161
163 static void clearMemoryPool(); //
164 static void deleteMemoryPool(); //
165
167 static void extendMemoryPoolForFileIO(); //
168
170 static SgAsmGenericDLL * getPointerFromGlobalIndex(unsigned long); //
172 static SgAsmGenericDLL * getPointerFromGlobalIndex(AstSpecificDataManagingClass *, unsigned long); //
173
175 static unsigned long getNumberOfValidNodesAndSetGlobalIndexInFreepointer(unsigned long); //
177 static void resetValidFreepointers(); //
179 static unsigned long getNumberOfLastValidPointer(); //
180
181
182#if defined(INLINE_FUNCTIONS)
184 inline void *operator new (size_t size);
185#else
187 void *operator new (size_t size);
188#endif
190 void operator delete (void* pointer, size_t size);
191
192 // DQ (4/5/2007): This is not the correct operator that we want, but appears to be required to compile ROSE with ROSE.
193 void operator delete (void* pointer)
194 {
195 // This is the generated delete operator...
196 SgAsmGenericDLL::operator delete (pointer,sizeof(SgAsmGenericDLL));
197 }
198
200 static size_t numberOfNodes();
201
203 static size_t memoryUsage();
204
205 // End of scope which started in IR nodes specific code
206 /* */
207
208 /* name Internal Functions
209 \brief Internal functions ... incomplete-documentation
210
211 These functions have been made public as part of the design, but they are suggested for internal use
212 or by particularly knowledgeable users for specialized tools or applications.
213
214 \internal We could not make these private because they are required by user for special purposes. And
215 it would be unwieldy to have many of the internal classes in ROSE be explicitly defined as friends.
216
217 */
218
219 // MS: 02/12/02 container of pointers to AST successor nodes used in the traversal
220 // overridden in every class by *generated* implementation
222 virtual std::vector<SgNode*> get_traversalSuccessorContainer() override;
223 // MS: 06/28/02 container of names of variables or container indices
224 // used used in the traversal to access AST successor nodes
225 // overridden in every class by *generated* implementation
228 virtual std::vector<std::string> get_traversalSuccessorNamesContainer() override;
229
230 // GB (09/25/2007): Functions for index-based access to traversal successors; these are hopefully a lot faster
231 // than all the vector copies. The implementation for these functions is generated for each class.
233 virtual size_t get_numberOfTraversalSuccessors() override;
235 virtual SgNode *get_traversalSuccessorByIndex(size_t idx) override;
237 virtual size_t get_childIndex(SgNode *child) override;
238
239#ifndef ROSE_USE_INTERNAL_FRONTEND_DEVELOPMENT
240 // MS: 08/16/2002 method for generating RTI information
242 virtual RTIReturnType roseRTI() override;
243#endif
244 /* */
245
246
247
248 /* name Deprecated Functions
249 \brief Deprecated functions ... incomplete-documentation
250
251 These functions have been deprecated from use.
252 */
253 /* */
254
256 virtual const char* sage_class_name() const override ROSE_DEPRECATED_FUNCTION;
257
258 // JJW (10/16/2008): Changed to a single function in Node.code, and put
259 // getVariant() in #if 0 block to prevent confusing Doxygen
260#if 0
262 virtual int variant() const ROSE_DEPRECATED_FUNCTION;
264 // virtual int getVariant() const ROSE_DEPRECATED_FUNCTION;
265#endif
266 /* */
267
268
269
270
271 public:
272 /* name Traversal Support Functions
273 \brief Traversal support functions ... incomplete-documentation
274
275 These functions have been made public as part of the design, but they are suggested for internal use
276 or by particularly knowledgable users for specialized tools or applications.
277 */
278 /* */
279
280 // DQ (11/26/2005): Support for visitor pattern mechanims
281 // (inferior to ROSE traversal mechanism, experimental).
285
286 /* DXN (08/09/2010): support for the classic visitor pattern done in GoF */
288 virtual void accept (ROSE_VisitorPattern & visitor) override;
289
290 // DQ (12/26/2005): Support for traversal based on the memory pool
293 static void traverseMemoryPoolNodes(ROSE_VisitTraversal & visit);
294
298
299 // DQ (2/9/2006): Added to support traversal over single representative of each IR node
300 // This traversal helps support internal tools that call static member functions.
301 // note: this function operates on the memory pools.
304 static void visitRepresentativeNode (ROSE_VisitTraversal & visit);
305 /* */
306
307 public:
308 /* NodeId support functions */
310 static SgNode* getNodeByNodeId(VariantT variantT, size_t poolIdx, size_t itemIdx);
313 static SgAsmGenericDLL* getNodeByNodeIdInternal(size_t poolIdx, size_t itemIdx);
316 static std::string getNodeIdString(SgAsmGenericDLL* sgnode);
317 static std::string getNodeIdStringInternal(SgAsmGenericDLL* sgnode);
318
319 public:
320 /* name Memory Allocation Functions
321 \brief Memory allocations functions ... incomplete-documentation
322
323 These functions have been made public as part of the design, but they are suggested for internal use
324 or by particularly knowledgable users for specialized tools or applications.
325 */
326 /* */
327
338 virtual bool isInMemoryPool() override;
339
350 virtual void checkDataMemberPointersIfInMemoryPool() override;
351
352 // DQ (4/30/2006): Modified to be a const function.
367 virtual std::vector<std::pair<SgNode*,std::string> > returnDataMemberPointers() const override;
368
379
391 virtual long getChildIndex( SgNode* childNode ) const override;
392
393 // DQ (9/2/2015): Since this function is generated by ROSETTA, we can't define the
394 // comment here (changed to be a C style comment and not be a doxygen comment).
395 /* \brief Constructor for use by AST File I/O Mechanism
396
397 This constructor permits the IR node to be rebuilt from the contiguously arranged data in memory
398 which obtained via fast binary file I/O from disk.
399 */
400 // SgAsmGenericDLL( SgAsmGenericDLLStorageClass& source );
401
402
403
404
405
406 // JH (10/24/2005): methods added to support the ast file IO
407 private:
408
409 /* name AST Memory Allocation Support Functions
410 \brief Memory allocations support....
411
412 These functions handle the low leve support of the memory allocation scheme which permits IR nodes to be allocated
413 in large contiguous blocks to reduce memory fragmentation, improve performance, support specialized access (AST traversals),
414 and support the AST File I/O Mechanism.
415 */
416 /* */
417
418 /* JH (10/24/2005): Two typedefs. The TestType notes the type every pointer is cast to before
419 we compare them. Since I had several problems with this, I decided to make a typdef to ensure
420 that I use the same type everywhere, if any changes are made. THe second one declares the type
421 (actually unsigned long) where teh pointer address gets converted to. On 64 bit platforms this
422 might got changed, but unfortunatly, the return types are still unsigned longs. There exists
423 a correspinding one in the AST_FILE_IO class!
424 */
425 // DQ (9/2/2015): This typedef is no longer used, we can't define the
426 // comment here (changed to be a C style comment and not be a doxygen comment).
427 /* \brief Typedef used for low level memory access.
428 */
429 // typedef unsigned char* TestType;
430
431 // DQ (9/2/2015): This typedef is no longer used, we can't define the
432 // comment here (changed to be a C style comment and not be a doxygen comment).
433 /* \brief Typedef used to hold memory addresses as values.
434 */
435 // typedef unsigned long AddressType;
436
437
438
439 // necessary, to have direct access to the p_freepointer and the private methods !
441 friend class AST_FILE_IO;
442
444 friend class SgAsmGenericDLLStorageClass;
445
447 friend class AstSpecificDataManagingClass;
448
450 friend class AstSpecificDataManagingClassStorageClass;
451 public:
453 SgAsmGenericDLL( const SgAsmGenericDLLStorageClass& source );
454
455 // private: // JJW hack
456 /*
457 name AST Memory Allocation Support Variables
458 Memory allocations support variables
459
460 These variables handle the low level support of the memory allocation scheme which permits IR nodes to be allocated
461 in large contiguous blocks to reduce memory fragmentation, improve performance, support specialized access (AST traversals),
462 and support the AST File I/O Mechanism.
463 */
464 /* */
465
466 public:
467
468 // DQ (11/21/2009): Added function to add new Regular Expression attributes and return pointer
469 // to current node (so that it will work cleanly with build functions to specify patterns).
470 // virtual SgNode* addRegExpAttribute();
477
478#ifndef _MSC_VER
479// Rasmussen (04/17/2019): Support for ATerms has been deprecated as it is no longer needed
480// and likely never fully implemented nor tested. Files remain in the src tree but are no
481// longer built.
482#define BUILD_ATERM_SUPPORT 0
483 #if BUILD_ATERM_SUPPORT
484 #ifdef ROSE_USE_ROSE_ATERM_SUPPORT
485 // DQ (10/4/2014): Adding ATerm support to ROSE.
495 // Rasmussen (1/7/2019): Added override to kill warning messages of overridden virtual function
496 virtual ATerm generate_ATerm() override;
497
499 virtual void generate_ATerm_Annotation(ATerm & term) override;
500 #endif
501 #endif // BUILD_ATERM_SUPPORT
502#endif
503 // These can't be virtual functions since we don't yet know what IR node to build (until we have read the aterm).
504 // virtual generate_AST(ATerm & term);
505 // virtual void read_ATerm_Annotation(ATerm & term);
506
507// *** COMMON CODE SECTION ENDS HERE ***
508
509
510// End of memberFunctionString
511// Start of memberFunctionString
512/* #line 706 "/workspace/src/ROSETTA/Grammar/Node.code" */
513
514 // the generated cast function
515 // friend ROSE_DLL_API SgAsmGenericDLL* isSgAsmGenericDLL ( SgNode* s );
516
517 typedef SgAsmExecutableFileFormat base_node_type;
518
519
520// End of memberFunctionString
521
522
523
524 protected:
525// Start of memberFunctionString
526SgAsmGenericString* p_name;
527
528// End of memberFunctionString
529// Start of memberFunctionString
530SgStringList p_symbols;
531
532// End of memberFunctionString
533
535 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericDLL, SgAsmGenericString*,&SgAsmGenericDLL::p_name>;
536 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericDLL, SgStringList,&SgAsmGenericDLL::p_symbols>;
537
538/* #line 21 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
539
540
541 };
542#endif
543
544// postdeclarations for SgAsmGenericDLL
545
546/* #line 547 "../../../src/frontend/SageIII//SgAsmGenericDLL.h" */
547
548/* #line 27 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro after subst for $POSTDECLARATIONS" */
549
550/* #line 28 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
551
552
553/* #line 554 "../../../src/frontend/SageIII//SgAsmGenericDLL.h" */
554
555#endif // ROSE_SgAsmGenericDLL_H
556
Class holding static data and functions supporting File I/O.
Definition AST_FILE_IO.h:19
Attribute containing a regex expression as a string.
Base class for many binary analysis nodes.
void initializeProperties()
Initialize all properties that have explicit initial values.
Base class for dynamically linked library information.
Base class for strings related to binary specimens.
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 VariantT variantT() const
returns new style SageIII enum values
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...
virtual std::string class_name() const
returns a string representing the class name
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.
ROSE_DLL_API int set_name(SgInitializedName *initializedNameNode, SgName new_name)
set_name of symbol in symbol table.
std::string get_name(const SgNode *node)
Generate a useful name to describe the SgNode.
void copy(const Word *src, const BitRange &srcRange, Word *dst, const BitRange &dstRange)
Copy some bits.