27 #ifndef FCML_LAG_ASSEMBLER_HPP_ 28 #define FCML_LAG_ASSEMBLER_HPP_ 64 return _errorContainer;
73 return static_cast<fcml_usize
>(_assembledInstructions.size());
85 if( index > _assembledInstructions.size() ) {
88 return _assembledInstructions[index];
98 return _assembledInstructions;
116 _errorContainer.
clean();
117 _assembledInstructions.clear();
132 return _assembledInstructions;
142 _errorContainer = errorContainer;
150 std::vector<AssembledInstruction> _assembledInstructions;
166 _symbolTable( NULL ) {
176 _entryPoint( operatingMode, ip ),
177 _symbolTable( NULL ) {
239 _entryPoint = entryPoint;
249 _entryPoint.setIP(ip);
259 _entryPoint.incrementIP( ip );
269 _entryPoint.setOpMode( operatingMode );
279 _entryPoint.setAddressSizeAttribute( addressSizeAttribute );
289 _entryPoint.setOperandSizeAttribute( operandSizeAttribute );
319 _symbolTable = symbolTable;
384 context.
symbol_table = symbolTable ? extractSymbolTable( *symbolTable ) : NULL;
402 ErrorTypeConverter::convert( res.
errors, errorContainer );
417 assembledInstructions.clear();
421 while( next_instruction ) {
423 ErrorTypeConverter::convert( instruction_warnings, instructionWarnings );
425 assembledInstructions.push_back( assembledInstruction );
426 next_instruction = next_instruction->
next;
437 }
catch( std::exception &exc ) {
const AssemblerConf & getConfig() const
Gets constant reference to assembler configuration.
Definition: fcml_lag_assembler.hpp:188
C++ wrapper for FCML assembler.
void setEntryPoint(const EntryPoint &entryPoint)
Sets a new entry point.
Definition: fcml_lag_assembler.hpp:238
CodeIterator getCodeIterator()
Gets iterator which allows to iterate through the whole machine code byte by byte.
Definition: fcml_lag_assembler.hpp:107
fcml_usize getSize() const
Gets number of assembled instructions.
Definition: fcml_lag_assembler.hpp:72
void setAddressSizeAttribute(fcml_usize addressSizeAttribute)
Sets a new address size attribute for the entry point.
Definition: fcml_lag_assembler.hpp:278
const std::vector< AssembledInstruction > & getAssembledInstructions() const
Gets constant vector of all assembled instructions.
Definition: fcml_lag_assembler.hpp:97
void setIP(fcml_ip ip)
Sets a new instruction pointer.
Definition: fcml_lag_assembler.hpp:248
std::vector< AssembledInstruction > & getAssembledInstructions()
Gets vector of all assembled instructions.
Definition: fcml_lag_assembler.hpp:131
LIB_EXPORT void LIB_CALL fcml_fn_lag_assembler_result_prepare(fcml_st_lag_assembler_result *result)
Prepares reusable result holder for assembler.
void setErrorContainer(const ErrorContainer &errorContainer)
Sets new error container for the result.
Definition: fcml_lag_assembler.hpp:141
Assembling failed.
Definition: fcml_assembler.hpp:45
fcml_st_assembler_conf configuration
Assembler behavior can be configured here.
Definition: fcml_lag_assembler.h:51
fcml_st_ceh_error_container errors
Error and warning messages from one-line assembler.
Definition: fcml_lag_assembler.h:39
EntryPoint & getEntryPoint()
Gets reference to the entry point.
Definition: fcml_lag_assembler.hpp:228
Container for all collected errors and warnings.
Definition: fcml_errors.h:162
An assembler wrapper, as you can see the assembler context is managed internally and is not exposed o...
Definition: fcml_lag_assembler.hpp:335
#define FCML_TEXT(x)
Used to code literal strings.
Definition: fcml_types.h:61
const EntryPoint & getEntryPoint() const
Gets constant reference to the entry point.
Definition: fcml_lag_assembler.hpp:218
struct fcml_st_assembled_instruction * next
Next assembled instruction in the chain.
Definition: fcml_assembler.h:77
Holds instruction pointer, processor operating mode and memory segment flags.
Definition: fcml_common.hpp:499
Assembler result which contains all assembled instructions.
Definition: fcml_lag_assembler.hpp:38
MultiPassAssembler(Dialect &dialect)
Creates multi-pass assembler for a dialect.
Definition: fcml_lag_assembler.hpp:344
Load-and-go assembler runtime context.
Definition: fcml_lag_assembler.h:47
fcml_st_ceh_error_container warnings
Warning messages related to assembled instruction.
Definition: fcml_assembler.h:79
Definition: fcml_assembler.hpp:39
void setConfig(const AssemblerConf &config)
Sets a new assembler configuration.
Definition: fcml_lag_assembler.hpp:208
MultiPassAssemblerContext(EntryPoint::OperatingMode operatingMode, fcml_ip ip=0)
Creates assembler context for given operating mode and instruction pointer.
Definition: fcml_lag_assembler.hpp:175
fcml_st_assembled_instruction * instructions
Chain of assembled instructions.
Definition: fcml_lag_assembler.h:43
fcml_cstring prepareErrorMessage(const fcml_cstring &message) const
Prepares an error message basing on the first error in the container.
Definition: fcml_errors.hpp:283
Inherit from this class in order to get access to the native FCML dialect structure.
Definition: fcml_dialect.hpp:97
virtual ~MultiPassAssemblerResult()
Virtual destructor.
Definition: fcml_lag_assembler.hpp:52
Used mainly in case of integers and offsets.
Definition: fcml_errors.h:54
LIB_EXPORT void LIB_CALL fcml_fn_lag_assembler_result_free(fcml_st_lag_assembler_result *result)
Cleans result holder.
const SymbolTable * getSymbolTable() const
Gets a pointer to the constant symbol table stored in the context.
Definition: fcml_lag_assembler.hpp:298
fcml_ceh_error assemble(MultiPassAssemblerContext &ctx, const fcml_string *instructions, MultiPassAssemblerResult &result)
Assembles given instruction model.
Definition: fcml_lag_assembler.hpp:375
fcml_st_entry_point entry_point
Instruction entry point configuration.
Definition: fcml_lag_assembler.h:53
LIB_EXPORT fcml_ceh_error LIB_CALL fcml_fn_lag_assemble(fcml_st_lag_assembler_context *context, const fcml_string *source_code, fcml_st_lag_assembler_result *result)
Multipass load-and-go assembler.
fcml_st_symbol_table symbol_table
Symbols table.
Definition: fcml_lag_assembler.h:55
Derive from this class if you really need access to the native symbol table.
Definition: fcml_symbols.hpp:245
MultiPassAssemblerResult()
Default constructor.
Definition: fcml_lag_assembler.hpp:45
fcml_int64_t fcml_ip
General instruction pointer holder.
Definition: fcml_common.h:95
Describes an assembled instruction.
Definition: fcml_assembler.hpp:55
void incrementIP(fcml_ip ip)
Increments the instruction pointer by given number of bytes.
Definition: fcml_lag_assembler.hpp:258
void setOperandSizeAttribute(fcml_usize operandSizeAttribute)
Sets a new operand size attribute for the entry point.
Definition: fcml_lag_assembler.hpp:288
OperatingMode
Supported operating modes.
Definition: fcml_common.hpp:506
void setOperatingMode(EntryPoint::OperatingMode operatingMode)
Sets a new processor operating mode for the entry point.
Definition: fcml_lag_assembler.hpp:268
AssemblerConf & getConfig()
Gets reference to the assembler configuration.
Definition: fcml_lag_assembler.hpp:198
void clear()
Clears the result.
Definition: fcml_lag_assembler.hpp:115
Result holder for load-and-go assembler.
Definition: fcml_lag_assembler.h:37
Wraps multiple errors into one component.
Definition: fcml_errors.hpp:148
Experimental multiline load-and-go assembler implementation.
SymbolTable * getSymbolTable()
Gets a pointer to the symbol table stored in the context.
Definition: fcml_lag_assembler.hpp:308
bool isThrowExceptionOnError() const
Returns true if exception should be thrown when assembling fails.
Definition: fcml_assembler.hpp:465
const AssembledInstruction & operator[](fcml_usize index) const
Gets one assembled instruction by its index.
Definition: fcml_lag_assembler.hpp:84
fcml_uint8_t * code
Instruction machine code.
Definition: fcml_assembler.h:81
Operation succeed.
Definition: fcml_errors.h:42
void clean()
Cleans all errors and warnings.
Definition: fcml_errors.hpp:296
Assembler configuration.
Definition: fcml_assembler.hpp:311
Bad arguments.
Definition: fcml_common.hpp:217
LIB_EXPORT void LIB_CALL fcml_fn_assembler_free(fcml_st_assembler *assembler)
Frees assembler instance.
Encoded instruction.
Definition: fcml_assembler.h:75
An abstract dialect.
Definition: fcml_dialect.hpp:41
void setSymbolTable(SymbolTable *symbolTable)
Sets a new symbol table for the context.
Definition: fcml_lag_assembler.hpp:318
LIB_EXPORT fcml_ceh_error LIB_CALL fcml_fn_assembler_init(const fcml_st_dialect *dialect, fcml_st_assembler **assembler)
Initializes assembler for given dialect.
Definition: fcml_symbols.hpp:142
C++ API for symbols handling.
fcml_st_assembler * assembler
Assembler instance that should be used to assemble instructions.
Definition: fcml_lag_assembler.h:49
struct fcml_st_assembler fcml_st_assembler
Abstract assembler representation.
Definition: fcml_assembler.h:43
Component can not be initialized correctly.
Definition: fcml_common.hpp:206
virtual ~MultiPassAssembler()
Virtual destructor.
Definition: fcml_lag_assembler.hpp:356
fcml_uint16_t fcml_ceh_error
All error codes should be held in variables of this type.
Definition: fcml_errors.h:139
fcml_usize code_length
Instruction code length in bytes.
Definition: fcml_assembler.h:83
MultiPassAssemblerContext()
Default constructor.
Definition: fcml_lag_assembler.hpp:165
Assembler context.
Definition: fcml_lag_assembler.hpp:157
Iterates over machine code bytes from assembled instructions.
Definition: fcml_assembler.hpp:838
Object which shouldn't be copied can inherit from this class.
Definition: fcml_common.hpp:263
const ErrorContainer & getErrorContainer() const
Gets error container.
Definition: fcml_lag_assembler.hpp:63