Crate mir_sys

Expand description

§MIR project bindings for Rust

This is the low-level binding that only exposes raw C types and functions, and handles compilation and linking of C code.

See mir-rs crate for high-level ergonomic APIs.

§Source

The source code of mir C library is bundled in this package. Since upstream lacks some API/features that are necessary for Rust integration, we use a forked version of mir.

The fork can be seen at this repo, and the current revision is based on upstream version v1.0.0.

⚠️ The API/ABI is NOT compatible with upstream mir library.

§Features

⚠️ Warning: Currently, due to lack of support of bindgen, extern functions may still be generated even with corresponding feature disabled. Be careful to avoid using them when disabling features, or you may encounter link errors.

default: Implies io, scan, interp, gen.
io: De/serialization of MIR memory representation into/from bytes. If disabled, C macro MIR_NO_IO is set for compilation.

Guarded APIs:
- MIR_write{,_module}{,_with_func}
- MIR_read{,_with_func}
scan: Parsing of MIR textual representation. If disabled, C macro MIR_NO_SCAN is set for compilation.

Guarded API:
- MIR_scan_string
interp: Enables MIR interpreter. If disabled, C macro MIR_NO_INTERP is set for compilation.

Guarded APIs:
- MIR_interp*
gen: MIR native code generator. If disabled, mir-gen.c will not be compiled.

Guarded APIs:
- MIR_gen*
- MIR_set_*_gen_interface
gen-debug: Debug logging in MIR native code generator. It implies gen. If disabled, C macro MIR_NO_GEN_DEBUG is set for compilation.

Guarded APIs:
- MIR_gen_set_debug_{file,level}
assert: Debug assertions. If disabled, C macro NDEBUG is set for compilation. It is implicitly enabled when debug_assertions is on (eg. in dev profile).

Structs§

Constants§

MIR_ADD
MIR_ADDO
MIR_ADDOS
MIR_ADDR
MIR_ADDR8
MIR_ADDR16
MIR_ADDR32
MIR_ADDS
MIR_ALLOCA
MIR_AND
MIR_ANDS
MIR_API_VERSION
MIR_BEND
MIR_BEQ
MIR_BEQS
MIR_BF
MIR_BFS
MIR_BGE
MIR_BGES
MIR_BGT
MIR_BGTS
MIR_BLE
MIR_BLES
MIR_BLK_NUM
MIR_BLT
MIR_BLTS
MIR_BNE
MIR_BNES
MIR_BNO
MIR_BO
MIR_BSTART
MIR_BT
MIR_BTS
MIR_CALL
MIR_D2F
MIR_D2I
MIR_D2LD
MIR_DADD
MIR_DBEQ
MIR_DBGE
MIR_DBGT
MIR_DBLE
MIR_DBLT
MIR_DBNE
MIR_DDIV
MIR_DEQ
MIR_DGE
MIR_DGT
MIR_DIV
MIR_DIVS
MIR_DLE
MIR_DLT
MIR_DMOV
MIR_DMUL
MIR_DNE
MIR_DNEG
MIR_DSUB
MIR_EQ
MIR_EQS
MIR_EXT8
MIR_EXT16
MIR_EXT32
MIR_F2D
MIR_F2I
MIR_F2LD
MIR_FADD
MIR_FBEQ
MIR_FBGE
MIR_FBGT
MIR_FBLE
MIR_FBLT
MIR_FBNE
MIR_FDIV
MIR_FEQ
MIR_FGE
MIR_FGT
MIR_FLE
MIR_FLT
MIR_FMOV
MIR_FMUL
MIR_FNE
MIR_FNEG
MIR_FSUB
MIR_GE
MIR_GES
MIR_GT
MIR_GTS
MIR_I2D
MIR_I2F
MIR_I2LD
MIR_INLINE
MIR_INSN_BOUND
MIR_INVALID_INSN
MIR_JCALL
MIR_JMP
MIR_JMPI
MIR_JRET
MIR_LABEL
MIR_LADDR
MIR_LD2D
MIR_LD2F
MIR_LD2I
MIR_LDADD
MIR_LDBEQ
MIR_LDBGE
MIR_LDBGT
MIR_LDBLE
MIR_LDBLT
MIR_LDBNE
MIR_LDDIV
MIR_LDEQ
MIR_LDGE
MIR_LDGT
MIR_LDLE
MIR_LDLT
MIR_LDMOV
MIR_LDMUL
MIR_LDNE
MIR_LDNEG
MIR_LDSUB
MIR_LE
MIR_LES
MIR_LSH
MIR_LSHS
MIR_LT
MIR_LTS
MIR_MAX_REG_NUM
MIR_MAX_SCALE
MIR_MOD
MIR_MODS
MIR_MOV
MIR_MUL
MIR_MULO
MIR_MULOS
MIR_MULS
MIR_NE
MIR_NEG
MIR_NEGS
MIR_NES
MIR_NON_VAR
MIR_NO_IO
MIR_NO_SCAN
MIR_OP_BOUND
MIR_OP_DOUBLE
MIR_OP_FLOAT
MIR_OP_INT
MIR_OP_LABEL
MIR_OP_LDOUBLE
MIR_OP_MEM
MIR_OP_REF
MIR_OP_REG
MIR_OP_STR
MIR_OP_UINT
MIR_OP_UNDEF
MIR_OP_VAR
MIR_OP_VAR_MEM
MIR_OR
MIR_ORS
MIR_PHI
MIR_PRBEQ
MIR_PRBNE
MIR_PRSET
MIR_PTR32
MIR_PTR64
MIR_RET
MIR_RSH
MIR_RSHS
MIR_SUB
MIR_SUBO
MIR_SUBOS
MIR_SUBS
MIR_SWITCH
MIR_T_BLK
MIR_T_BOUND
MIR_T_D
MIR_T_F
MIR_T_I8
MIR_T_I16
MIR_T_I32
MIR_T_I64
MIR_T_LD
MIR_T_P
MIR_T_RBLK
MIR_T_U8
MIR_T_U16
MIR_T_U32
MIR_T_U64
MIR_T_UNDEF
MIR_UBGE
MIR_UBGES
MIR_UBGT
MIR_UBGTS
MIR_UBLE
MIR_UBLES
MIR_UBLT
MIR_UBLTS
MIR_UBNO
MIR_UBO
MIR_UDIV
MIR_UDIVS
MIR_UEXT8
MIR_UEXT16
MIR_UEXT32
MIR_UGE
MIR_UGES
MIR_UGT
MIR_UGTS
MIR_UI2D
MIR_UI2F
MIR_UI2LD
MIR_ULE
MIR_ULES
MIR_ULT
MIR_ULTS
MIR_UMOD
MIR_UMODS
MIR_UMULO
MIR_UMULOS
MIR_UNSPEC
MIR_URSH
MIR_URSHS
MIR_USE
MIR_VA_ARG
MIR_VA_BLOCK_ARG
MIR_VA_END
MIR_VA_START
MIR_XOR
MIR_XORS
MIR_alloc_error
MIR_binary_io_error
MIR_bss_item
MIR_call_op_error
MIR_ctx_change_error
MIR_data_item
MIR_export_item
MIR_expr_data_item
MIR_finish_error
MIR_forward_item
MIR_func_error
MIR_func_item
MIR_hard_reg_error
MIR_import_export_error
MIR_import_item
MIR_invalid_insn_error
MIR_lref_data_item
MIR_nested_func_error
MIR_nested_module_error
MIR_no_error
MIR_no_func_error
MIR_no_module_error
MIR_op_mode_error
MIR_ops_num_error
MIR_out_op_error
MIR_proto_item
MIR_ref_data_item
MIR_reg_type_error
MIR_repeated_decl_error
MIR_reserved_name_error
MIR_ret_error
MIR_syntax_error
MIR_undeclared_func_reg_error
MIR_undeclared_op_ref_error
MIR_unique_reg_error
MIR_unspec_op_error
MIR_vararg_func_error
MIR_wrong_lref_error
MIR_wrong_param_value_error
MIR_wrong_type_error

Functions§

MIR_alias^⚠
MIR_alias_name^⚠
MIR_append_insn^⚠
MIR_change_module_ctx^⚠
MIR_copy_insn^⚠
MIR_finish^⚠
MIR_finish_func^⚠
MIR_finish_module^⚠
MIR_gen^⚠gen
MIR_gen_finish^⚠gen
MIR_gen_init^⚠gen
MIR_gen_set_debug_file^⚠gen
MIR_gen_set_debug_level^⚠gen
MIR_gen_set_optimize_level^⚠gen
MIR_get_error_func^⚠
MIR_get_func_redef_permission_p^⚠
MIR_get_global_item^⚠
MIR_get_item_func^⚠
MIR_get_module_list^⚠
MIR_init
MIR_insert_insn_after^⚠
MIR_insert_insn_before^⚠
MIR_insn_name^⚠
MIR_insn_nops^⚠
MIR_insn_op_mode^⚠
MIR_interp^⚠
MIR_interp_arr^⚠
MIR_item_name^⚠
MIR_link^⚠
MIR_load_external^⚠
MIR_load_module^⚠
MIR_new_alias_mem_op^⚠
MIR_new_bss^⚠
MIR_new_call_insn^⚠
MIR_new_data^⚠
MIR_new_double_op^⚠
MIR_new_export^⚠
MIR_new_expr_data^⚠
MIR_new_float_op^⚠
MIR_new_forward^⚠
MIR_new_func^⚠
MIR_new_func_arr^⚠
MIR_new_func_reg^⚠
MIR_new_global_func_reg^⚠
MIR_new_import^⚠
MIR_new_insn^⚠
MIR_new_insn_arr^⚠
MIR_new_int_op^⚠
MIR_new_jcall_insn^⚠
MIR_new_label^⚠
MIR_new_label_op^⚠
MIR_new_ldouble_op^⚠
MIR_new_lref_data^⚠
MIR_new_mem_op^⚠
MIR_new_module^⚠
MIR_new_proto^⚠
MIR_new_proto_arr^⚠
MIR_new_ref_data^⚠
MIR_new_ref_op^⚠
MIR_new_reg_op^⚠
MIR_new_ret_insn^⚠
MIR_new_str_op^⚠
MIR_new_string_data^⚠
MIR_new_uint_op^⚠
MIR_new_vararg_func^⚠
MIR_new_vararg_func_arr^⚠
MIR_new_vararg_proto^⚠
MIR_new_vararg_proto_arr^⚠
MIR_op_eq_p^⚠
MIR_op_hash_step^⚠
MIR_output^⚠
MIR_output_insn^⚠
MIR_output_item^⚠
MIR_output_module^⚠
MIR_output_op^⚠
MIR_output_str^⚠
MIR_prepend_insn^⚠
MIR_read^⚠
MIR_read_with_func^⚠
MIR_reg^⚠
MIR_reg_hard_reg_name^⚠
MIR_reg_name^⚠
MIR_reg_type^⚠
MIR_remove_insn^⚠
MIR_reverse_branch_code^⚠
MIR_scan_string^⚠
MIR_set_error_func^⚠
MIR_set_func_redef_permission^⚠
MIR_set_gen_interface^⚠gen
MIR_set_interp_interface^⚠
MIR_set_lazy_bb_gen_interface^⚠gen
MIR_set_lazy_gen_interface^⚠gen
MIR_type_str^⚠
MIR_write^⚠
MIR_write_module^⚠
MIR_write_module_with_func^⚠
MIR_write_with_func^⚠
_MIR_get_api_version^⚠
_MIR_init^⚠

Type Aliases§

Unions§

MIR_data__bindgen_ty_1
MIR_imm_t
MIR_item__bindgen_ty_1
MIR_op_t__u
MIR_val_t

Crate mir_sysCopy item path