ROSE 0.11.145.147
SgAsmGenericSymbol.h
1
2#ifndef ROSE_SgAsmGenericSymbol_H
3#define ROSE_SgAsmGenericSymbol_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 SgAsmGenericSymbol
23
24/* #line 25 "../../../src/frontend/SageIII//SgAsmGenericSymbol.h" */
25/* #line 30108 "/workspace/src/ROSETTA/src/binaryInstruction.C" */
26
27/* Base class for symbol tables. */
28
29
30/* #line 13 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro after subst for $PREDECLARATIONS" */
31
32/* #line 14 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
33
34#if !defined(DOCUMENTATION)
35// Class Definition for SgAsmGenericSymbol
36class ROSE_DLL_API SgAsmGenericSymbol : public SgAsmExecutableFileFormat
37 {
38 public:
39
40
41/* #line 42 "../../../src/frontend/SageIII//SgAsmGenericSymbol.h" */
42
43 virtual SgNode* copy ( SgCopyHelp& help) const override;
44// Start of memberFunctionString
45/* #line 30159 "/workspace/src/ROSETTA/src/binaryInstruction.C" */
46
47
48 //----------------------- Boost serialization for SgAsmGenericSymbol -----------------------
49#ifdef ROSE_HAVE_BOOST_SERIALIZATION_LIB
50private:
51 friend class boost::serialization::access;
52
53 template<class S>
54 void serialize(S &s, const unsigned /*version*/) {
55 debugSerializationBegin("SgAsmGenericSymbol");
56 s & BOOST_SERIALIZATION_BASE_OBJECT_NVP(SgAsmExecutableFileFormat);
57 s & BOOST_SERIALIZATION_NVP(p_definitionState);
58 s & BOOST_SERIALIZATION_NVP(p_binding);
59 s & BOOST_SERIALIZATION_NVP(p_type);
60 s & BOOST_SERIALIZATION_NVP(p_value);
61 s & BOOST_SERIALIZATION_NVP(p_size);
62 s & BOOST_SERIALIZATION_NVP(p_bound);
63 s & BOOST_SERIALIZATION_NVP(p_name);
64 debugSerializationEnd("SgAsmGenericSymbol");
65 }
66#endif // ROSE_HAVE_BOOST_SERIALIZATION_LIB
68 // Local types
70public:
72 enum SymbolDefState {
73 SYM_UNDEFINED,
74 SYM_TENTATIVE,
75 SYM_DEFINED
76 };
77
79 enum SymbolType {
80 SYM_NO_TYPE,
81 SYM_DATA,
82 SYM_FUNC,
83 SYM_SECTION,
84 SYM_FILE,
85 SYM_ARRAY,
86 SYM_TLS,
87 SYM_REGISTER,
88 SYM_COMMON,
89 SYM_IFUNC
90 };
91
93 enum SymbolBinding {
94 SYM_NO_BINDING,
95 SYM_LOCAL,
96 SYM_GLOBAL,
97 SYM_WEAK
98 };
99
101 // Properties
103public:
104public:
108 SgAsmGenericSymbol::SymbolDefState const& get_definitionState() const;
109 void set_definitionState(SgAsmGenericSymbol::SymbolDefState const&);
112public:
116 SgAsmGenericSymbol::SymbolBinding const& get_binding() const;
117 void set_binding(SgAsmGenericSymbol::SymbolBinding const&);
120public:
124 SgAsmGenericSymbol::SymbolType const& get_type() const;
125 void set_type(SgAsmGenericSymbol::SymbolType const&);
128public:
132 rose_addr_t const& get_value() const;
133 void set_value(rose_addr_t const&);
136public:
140 rose_addr_t const& get_size() const;
141 void set_size(rose_addr_t const&);
144public:
148 SgAsmGenericSection* const& get_bound() const;
149 void set_bound(SgAsmGenericSection* const&);
152public:
161 // Functions
163public:
165 virtual void dump(FILE*, const char *prefix, ssize_t idx) const;
166
168 // Deprecated 2023-11
170public:
171 SymbolDefState get_def_state() const ROSE_DEPRECATED("use get_definitionState");
172 void set_def_state(SymbolDefState) ROSE_DEPRECATED("use set_definitionState");
173public:
175 virtual ~SgAsmGenericSymbol();
176
177protected:
180
181protected:
188 void initializeProperties();
189
190
191// End of memberFunctionString
192// Start of memberFunctionString
193/* #line 1 "/workspace/src/ROSETTA/Grammar/Common.code" */
194
195// *** COMMON CODE SECTION BEGINS HERE ***
196
197 public:
198
199 // DQ (3/25/3006): I put this back in because it had the logic for where the copy function required
200 // and not required which is required to match the other aspects of the copy mechanism code generation.
201 // Specifically it is a problem to declare the copy function everywhere because it is not implemented
202 // for the SgSymbol IR nodes. I'm not clear why it is not implemented for these IR nodes.
203 /* \brief Copies AST (whole subtree, depending on the SgCopyHelp class */
204 // virtual SgNode* copy ( const SgCopyHelp & help) const;
205
207 virtual std::string class_name() const override;
208
210 virtual VariantT variantT() const override; // MS: new variant used in tree traversal
211
213 // King84 (2010.08.16): Moved this to an enum to save space, since it's only used at compiler-time anyway.
214 // static const VariantT static_variant = V_SgAsmGenericSymbol;
215 enum { static_variant = V_SgAsmGenericSymbol };
216
217 /* the generated cast function */
219 ROSE_DLL_API friend SgAsmGenericSymbol* isSgAsmGenericSymbol( SgNode * s );
220
222 ROSE_DLL_API friend const SgAsmGenericSymbol* isSgAsmGenericSymbol( const SgNode * s );
223
224 // ******************************************
225 // * Memory Pool / New / Delete
226 // ******************************************
227
228 public:
230 static const unsigned pool_size; //
232 static std::vector<unsigned char *> pools; //
234 static SgAsmGenericSymbol * next_node; //
235
237 static unsigned long initializeStorageClassArray(SgAsmGenericSymbolStorageClass *); //
238
240 static void clearMemoryPool(); //
241 static void deleteMemoryPool(); //
242
244 static void extendMemoryPoolForFileIO(); //
245
247 static SgAsmGenericSymbol * getPointerFromGlobalIndex(unsigned long); //
249 static SgAsmGenericSymbol * getPointerFromGlobalIndex(AstSpecificDataManagingClass *, unsigned long); //
250
252 static unsigned long getNumberOfValidNodesAndSetGlobalIndexInFreepointer(unsigned long); //
254 static void resetValidFreepointers(); //
256 static unsigned long getNumberOfLastValidPointer(); //
257
258
259#if defined(INLINE_FUNCTIONS)
261 inline void *operator new (size_t size);
262#else
264 void *operator new (size_t size);
265#endif
267 void operator delete (void* pointer, size_t size);
268
269 // DQ (4/5/2007): This is not the correct operator that we want, but appears to be required to compile ROSE with ROSE.
270 void operator delete (void* pointer)
271 {
272 // This is the generated delete operator...
273 SgAsmGenericSymbol::operator delete (pointer,sizeof(SgAsmGenericSymbol));
274 }
275
277 static size_t numberOfNodes();
278
280 static size_t memoryUsage();
281
282 // End of scope which started in IR nodes specific code
283 /* */
284
285 /* name Internal Functions
286 \brief Internal functions ... incomplete-documentation
287
288 These functions have been made public as part of the design, but they are suggested for internal use
289 or by particularly knowledgeable users for specialized tools or applications.
290
291 \internal We could not make these private because they are required by user for special purposes. And
292 it would be unwieldy to have many of the internal classes in ROSE be explicitly defined as friends.
293
294 */
295
296 // MS: 02/12/02 container of pointers to AST successor nodes used in the traversal
297 // overridden in every class by *generated* implementation
299 virtual std::vector<SgNode*> get_traversalSuccessorContainer() override;
300 // MS: 06/28/02 container of names of variables or container indices
301 // used used in the traversal to access AST successor nodes
302 // overridden in every class by *generated* implementation
305 virtual std::vector<std::string> get_traversalSuccessorNamesContainer() override;
306
307 // GB (09/25/2007): Functions for index-based access to traversal successors; these are hopefully a lot faster
308 // than all the vector copies. The implementation for these functions is generated for each class.
310 virtual size_t get_numberOfTraversalSuccessors() override;
312 virtual SgNode *get_traversalSuccessorByIndex(size_t idx) override;
314 virtual size_t get_childIndex(SgNode *child) override;
315
316#ifndef ROSE_USE_INTERNAL_FRONTEND_DEVELOPMENT
317 // MS: 08/16/2002 method for generating RTI information
319 virtual RTIReturnType roseRTI() override;
320#endif
321 /* */
322
323
324
325 /* name Deprecated Functions
326 \brief Deprecated functions ... incomplete-documentation
327
328 These functions have been deprecated from use.
329 */
330 /* */
331
333 virtual const char* sage_class_name() const override ROSE_DEPRECATED_FUNCTION;
334
335 // JJW (10/16/2008): Changed to a single function in Node.code, and put
336 // getVariant() in #if 0 block to prevent confusing Doxygen
337#if 0
339 virtual int variant() const ROSE_DEPRECATED_FUNCTION;
341 // virtual int getVariant() const ROSE_DEPRECATED_FUNCTION;
342#endif
343 /* */
344
345
346
347
348 public:
349 /* name Traversal Support Functions
350 \brief Traversal support functions ... incomplete-documentation
351
352 These functions have been made public as part of the design, but they are suggested for internal use
353 or by particularly knowledgable users for specialized tools or applications.
354 */
355 /* */
356
357 // DQ (11/26/2005): Support for visitor pattern mechanims
358 // (inferior to ROSE traversal mechanism, experimental).
362
363 /* DXN (08/09/2010): support for the classic visitor pattern done in GoF */
365 virtual void accept (ROSE_VisitorPattern & visitor) override;
366
367 // DQ (12/26/2005): Support for traversal based on the memory pool
370 static void traverseMemoryPoolNodes(ROSE_VisitTraversal & visit);
371
375
376 // DQ (2/9/2006): Added to support traversal over single representative of each IR node
377 // This traversal helps support internal tools that call static member functions.
378 // note: this function operates on the memory pools.
381 static void visitRepresentativeNode (ROSE_VisitTraversal & visit);
382 /* */
383
384 public:
385 /* NodeId support functions */
387 static SgNode* getNodeByNodeId(VariantT variantT, size_t poolIdx, size_t itemIdx);
390 static SgAsmGenericSymbol* getNodeByNodeIdInternal(size_t poolIdx, size_t itemIdx);
393 static std::string getNodeIdString(SgAsmGenericSymbol* sgnode);
394 static std::string getNodeIdStringInternal(SgAsmGenericSymbol* sgnode);
395
396 public:
397 /* name Memory Allocation Functions
398 \brief Memory allocations functions ... incomplete-documentation
399
400 These functions have been made public as part of the design, but they are suggested for internal use
401 or by particularly knowledgable users for specialized tools or applications.
402 */
403 /* */
404
415 virtual bool isInMemoryPool() override;
416
427 virtual void checkDataMemberPointersIfInMemoryPool() override;
428
429 // DQ (4/30/2006): Modified to be a const function.
444 virtual std::vector<std::pair<SgNode*,std::string> > returnDataMemberPointers() const override;
445
456
468 virtual long getChildIndex( SgNode* childNode ) const override;
469
470 // DQ (9/2/2015): Since this function is generated by ROSETTA, we can't define the
471 // comment here (changed to be a C style comment and not be a doxygen comment).
472 /* \brief Constructor for use by AST File I/O Mechanism
473
474 This constructor permits the IR node to be rebuilt from the contiguously arranged data in memory
475 which obtained via fast binary file I/O from disk.
476 */
477 // SgAsmGenericSymbol( SgAsmGenericSymbolStorageClass& source );
478
479
480
481
482
483 // JH (10/24/2005): methods added to support the ast file IO
484 private:
485
486 /* name AST Memory Allocation Support Functions
487 \brief Memory allocations support....
488
489 These functions handle the low leve support of the memory allocation scheme which permits IR nodes to be allocated
490 in large contiguous blocks to reduce memory fragmentation, improve performance, support specialized access (AST traversals),
491 and support the AST File I/O Mechanism.
492 */
493 /* */
494
495 /* JH (10/24/2005): Two typedefs. The TestType notes the type every pointer is cast to before
496 we compare them. Since I had several problems with this, I decided to make a typdef to ensure
497 that I use the same type everywhere, if any changes are made. THe second one declares the type
498 (actually unsigned long) where teh pointer address gets converted to. On 64 bit platforms this
499 might got changed, but unfortunatly, the return types are still unsigned longs. There exists
500 a correspinding one in the AST_FILE_IO class!
501 */
502 // DQ (9/2/2015): This typedef is no longer used, we can't define the
503 // comment here (changed to be a C style comment and not be a doxygen comment).
504 /* \brief Typedef used for low level memory access.
505 */
506 // typedef unsigned char* TestType;
507
508 // DQ (9/2/2015): This typedef is no longer used, we can't define the
509 // comment here (changed to be a C style comment and not be a doxygen comment).
510 /* \brief Typedef used to hold memory addresses as values.
511 */
512 // typedef unsigned long AddressType;
513
514
515
516 // necessary, to have direct access to the p_freepointer and the private methods !
518 friend class AST_FILE_IO;
519
521 friend class SgAsmGenericSymbolStorageClass;
522
524 friend class AstSpecificDataManagingClass;
525
527 friend class AstSpecificDataManagingClassStorageClass;
528 public:
530 SgAsmGenericSymbol( const SgAsmGenericSymbolStorageClass& source );
531
532 // private: // JJW hack
533 /*
534 name AST Memory Allocation Support Variables
535 Memory allocations support variables
536
537 These variables handle the low level support of the memory allocation scheme which permits IR nodes to be allocated
538 in large contiguous blocks to reduce memory fragmentation, improve performance, support specialized access (AST traversals),
539 and support the AST File I/O Mechanism.
540 */
541 /* */
542
543 public:
544
545 // DQ (11/21/2009): Added function to add new Regular Expression attributes and return pointer
546 // to current node (so that it will work cleanly with build functions to specify patterns).
547 // virtual SgNode* addRegExpAttribute();
554
555#ifndef _MSC_VER
556// Rasmussen (04/17/2019): Support for ATerms has been deprecated as it is no longer needed
557// and likely never fully implemented nor tested. Files remain in the src tree but are no
558// longer built.
559#define BUILD_ATERM_SUPPORT 0
560 #if BUILD_ATERM_SUPPORT
561 #ifdef ROSE_USE_ROSE_ATERM_SUPPORT
562 // DQ (10/4/2014): Adding ATerm support to ROSE.
572 // Rasmussen (1/7/2019): Added override to kill warning messages of overridden virtual function
573 virtual ATerm generate_ATerm() override;
574
576 virtual void generate_ATerm_Annotation(ATerm & term) override;
577 #endif
578 #endif // BUILD_ATERM_SUPPORT
579#endif
580 // These can't be virtual functions since we don't yet know what IR node to build (until we have read the aterm).
581 // virtual generate_AST(ATerm & term);
582 // virtual void read_ATerm_Annotation(ATerm & term);
583
584// *** COMMON CODE SECTION ENDS HERE ***
585
586
587// End of memberFunctionString
588// Start of memberFunctionString
589/* #line 706 "/workspace/src/ROSETTA/Grammar/Node.code" */
590
591 // the generated cast function
592 // friend ROSE_DLL_API SgAsmGenericSymbol* isSgAsmGenericSymbol ( SgNode* s );
593
594 typedef SgAsmExecutableFileFormat base_node_type;
595
596
597// End of memberFunctionString
598
599
600
601
602
603
604
605
606 protected:
607// Start of memberFunctionString
608SgAsmGenericSymbol::SymbolDefState p_definitionState;
609
610// End of memberFunctionString
611// Start of memberFunctionString
613
614// End of memberFunctionString
615// Start of memberFunctionString
617
618// End of memberFunctionString
619// Start of memberFunctionString
620rose_addr_t p_value;
621
622// End of memberFunctionString
623// Start of memberFunctionString
624rose_addr_t p_size;
625
626// End of memberFunctionString
627// Start of memberFunctionString
628SgAsmGenericSection* p_bound;
629
630// End of memberFunctionString
631// Start of memberFunctionString
632SgAsmGenericString* p_name;
633
634// End of memberFunctionString
635
637 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericSymbol, SgAsmGenericSymbol::SymbolDefState,&SgAsmGenericSymbol::p_definitionState>;
638 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericSymbol, SgAsmGenericSymbol::SymbolBinding,&SgAsmGenericSymbol::p_binding>;
639 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericSymbol, SgAsmGenericSymbol::SymbolType,&SgAsmGenericSymbol::p_type>;
640 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericSymbol, rose_addr_t,&SgAsmGenericSymbol::p_value>;
641 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericSymbol, rose_addr_t,&SgAsmGenericSymbol::p_size>;
642 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericSymbol, SgAsmGenericSection*,&SgAsmGenericSymbol::p_bound>;
643 friend struct Rose::Traits::generated::describe_field_t<SgAsmGenericSymbol, SgAsmGenericString*,&SgAsmGenericSymbol::p_name>;
644
645/* #line 21 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
646
647
648 };
649#endif
650
651// postdeclarations for SgAsmGenericSymbol
652
653/* #line 654 "../../../src/frontend/SageIII//SgAsmGenericSymbol.h" */
654
655/* #line 27 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro after subst for $POSTDECLARATIONS" */
656
657/* #line 28 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
658
659
660/* #line 661 "../../../src/frontend/SageIII//SgAsmGenericSymbol.h" */
661
662#endif // ROSE_SgAsmGenericSymbol_H
663
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.
Contiguous region of a file.
Base class for strings related to binary specimens.
SymbolBinding
Symbol binding.
SymbolDefState
Symbol definition state.
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.
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.
const char * SymbolType(int64_t)
Convert SgAsmGenericSymbol::SymbolType enum constant to a string.
const char * SymbolDefState(int64_t)
Convert SgAsmGenericSymbol::SymbolDefState enum constant to a string.
const char * SymbolBinding(int64_t)
Convert SgAsmGenericSymbol::SymbolBinding enum constant to a string.