fcml  1.2.2
fcml_optimizers.h
Go to the documentation of this file.
1 /*
2  * FCML - Free Code Manipulation Library.
3  * Copyright (C) 2010-2019 Slawomir Wojtasiak
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2.1 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this library; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18  */
19 
27 #ifndef FCML_OPTIMIZERS_H_
28 #define FCML_OPTIMIZERS_H_
29 
30 #include "fcml_lib_export.h"
31 
32 #include "fcml_types.h"
33 #include "fcml_errors.h"
34 #include "fcml_common.h"
35 
36 #ifdef __cplusplus
37 extern "C" {
38 #endif
39 
45  fcml_uint16_t optimizer_flags;
51  fcml_usize asa;
55  fcml_usize osa;
57 
77  fcml_usize easa;
85  fcml_usize eosa;
87  fcml_usize vector_length;
89  fcml_bool break_optimization;
91 
99 
112  fcml_fnp_asm_optimizer_callback callback, fcml_ptr args);
113 
114 /* Optimizers flags that can be used to configure optimization process. */
115 #define FCML_OPTF_ASA_16 0x01
116 #define FCML_OPTF_ASA_32 0x02
117 #define FCML_OPTF_ASA_64 0x03
118 #define FCML_OPTF_OSA_16 0x10
119 #define FCML_OPTF_OSA_32 0x20
120 #define FCML_OPTF_OSA_64 0x30
121 /* Do not choose the optimal form, but return all possibilities. */
122 #define FCML_OPTF_ALL_FORMS 0xFF
123 
138  fcml_fnp_asm_optimizer_callback callback, fcml_ptr callback_args);
139 
140 #ifdef __cplusplus
141 }
142 #endif
143 
144 #endif /* FCML_OPTIMIZERS_H_ */
fcml_fn_asm_default_optimizer
LIB_EXPORT fcml_ceh_error LIB_CALL fcml_fn_asm_default_optimizer(fcml_st_asm_optimizer_context *context, fcml_st_asm_optimizer_processing_details *ds_flags, fcml_fnp_asm_optimizer_callback callback, fcml_ptr callback_args)
Default optimizer implementation.
fcml_st_nullable_size_flags
Nullable wrapper for mask of size flags.
Definition: fcml_common.h:524
fcml_fnp_asm_optimizer
fcml_ceh_error(LIB_CALL * fcml_fnp_asm_optimizer)(fcml_st_asm_optimizer_context *context, fcml_st_asm_optimizer_processing_details *ds_flags, fcml_fnp_asm_optimizer_callback callback, fcml_ptr args)
Function pointer declaration for optimizers.
Definition: fcml_optimizers.h:109
fcml_st_asm_optimizer_processing_details::eosa
fcml_usize eosa
Effective operand size attribute chosen for currently processed instruction form.
Definition: fcml_optimizers.h:85
fcml_lib_export.h
fcml_st_asm_optimizer_context
Optimizer context used as a connector with the environment.
Definition: fcml_optimizers.h:41
fcml_st_asm_optimizer_context
struct fcml_st_asm_optimizer_context fcml_st_asm_optimizer_context
Optimizer context used as a connector with the environment.
fcml_st_asm_optimizer_context::asa
fcml_usize asa
Default address size attribute not modified by prefixes yet.
Definition: fcml_optimizers.h:51
fcml_ceh_error
fcml_uint16_t fcml_ceh_error
All error codes should be held in variables of this type.
Definition: fcml_errors.h:156
fcml_st_asm_optimizer_processing_details::vector_length
fcml_usize vector_length
Vector length of AVX instructions.
Definition: fcml_optimizers.h:87
fcml_st_asm_optimizer_processing_details
Processing details for optimizers.
Definition: fcml_optimizers.h:59
fcml_st_asm_optimizer_processing_details::allowed_eosa
fcml_st_nullable_size_flags allowed_eosa
Allowed values of the operand size attribute calculated by the assembler engine.
Definition: fcml_optimizers.h:64
fcml_en_operating_mode
fcml_en_operating_mode
Supported processor operating modes.
Definition: fcml_common.h:73
fcml_errors.h
fcml_st_asm_optimizer_processing_details
struct fcml_st_asm_optimizer_processing_details fcml_st_asm_optimizer_processing_details
Processing details for optimizers.
fcml_st_asm_optimizer_context::optimizer_flags
fcml_uint16_t optimizer_flags
Optimizer flags passed through the assembler context.
Definition: fcml_optimizers.h:45
fcml_fnp_asm_optimizer_callback
fcml_ceh_error(* fcml_fnp_asm_optimizer_callback)(fcml_ptr args)
Callback used to invoke encoding process for given processing details configuration.
Definition: fcml_optimizers.h:98
fcml_common.h
fcml_st_asm_optimizer_processing_details::allowed_easa
fcml_st_nullable_size_flags allowed_easa
Allowed values of the address size attribute calculated by the assembler engine.
Definition: fcml_optimizers.h:69
fcml_st_asm_optimizer_context::osa
fcml_usize osa
Default operand size attribute not modified by prefixes yet.
Definition: fcml_optimizers.h:55
fcml_st_asm_optimizer_processing_details::easa
fcml_usize easa
Effective address size attribute chosen for currently processed instruction form.
Definition: fcml_optimizers.h:77
fcml_st_asm_optimizer_context::op_mode
fcml_en_operating_mode op_mode
Processor operating mode 16/32/64-bit.
Definition: fcml_optimizers.h:47
fcml_st_asm_optimizer_processing_details::break_optimization
fcml_bool break_optimization
Set to true in order to break optimization process immediately.
Definition: fcml_optimizers.h:89
fcml_types.h