Add eager_init function.

src/rust/iced-x86/README.md

@@ -1278,6 +1278,16 @@ Output:
 */
 ```
 
+## Eagerly initialize `iced` crate
+This crate depends on `lazy_static` to lazily initialize the library on-demand. However, in some circumstances, memory allocators may become unavailable after initialization stage (e.g.: You cannot call `ExAllocatePool` if `IRQL>DISPATCH_LEVEL`). Therefore, eager initialization may become necessary. \
+To eagerly initialize the `iced` crate, call the `eager_init` function in your initialization routine:
+```Rust
+use iced_x86;
+
+iced_x86::eager_init();
+```
+**Caveat:** Unlike decoders, creating formatters will still trigger memory allocations. Therefore, set up your formatter as/inside a global variable.
+
 ## Minimum supported `rustc` version
 
 iced-x86 supports `rustc` `1.63.0` or later.

src/rust/iced-x86/src/decoder.rs

@@ -2652,3 +2652,7 @@ impl<'a, 'b> IntoIterator for &'b mut Decoder<'a> {
 		DecoderIter { decoder: self }
 	}
 }
+
+pub(crate) fn eager_init() {
+	let _ = &handlers::tables::TABLES.handlers_evex_0f[0].0;
+}

src/rust/iced-x86/src/encoder.rs

@@ -1678,3 +1678,8 @@ impl Encoder {
 		self.bitness
 	}
 }
+
+pub(crate) fn eager_init() {
+	let _ = &handlers_table::HANDLERS_TABLE.as_ptr();
+	let _ = &op_code_tbl::OP_CODE_INFO_TBL.as_ptr();
+}

src/rust/iced-x86/src/formatter/fast.rs

@@ -1844,3 +1844,10 @@ pub type FastFormatter = SpecializedFormatter<DefaultFastFormatterTraitOptions>;
 pub struct DefaultSpecializedFormatterTraitOptions;
 
 impl SpecializedFormatterTraitOptions for DefaultSpecializedFormatterTraitOptions {}
+
+pub(super) fn eager_init() {
+	let _ = &fmt_tbl::FMT_DATA.flags;
+	let _ = &mem_size_tbl::MEM_SIZE_TBL.as_ptr();
+	let _ = &regs::REGS_TBL.as_ptr();
+	pseudo_ops_fast::eager_init();
+}

src/rust/iced-x86/src/formatter/fast/pseudo_ops_fast.rs

@@ -259,3 +259,7 @@ fn create(cc: &[&str], size: usize, prefix: &str, suffix: &str) -> Vec<FastStrin
 	}
 	strings
 }
+
+pub(super) fn eager_init() {
+	let _ = &PSEUDO_OPS.cmppd;
+}

src/rust/iced-x86/src/formatter/gas.rs

@@ -1536,3 +1536,9 @@ impl Formatter for GasFormatter {
 		self.number_formatter.format_u64(&self.d.options, number_options, value)
 	}
 }
+
+pub(super) fn eager_init() {
+	let _ = &fmt_tbl::ALL_INFOS.as_ptr();
+	let _ = &mem_size_tbl::MEM_SIZE_TBL.as_ptr();
+	let _ = &regs::ALL_REGISTERS.as_ptr();
+}

src/rust/iced-x86/src/formatter/intel.rs

@@ -1676,3 +1676,8 @@ impl Formatter for IntelFormatter {
 		self.number_formatter.format_u64(&self.d.options, number_options, value)
 	}
 }
+
+pub(super) fn eager_init() {
+	let _ = &fmt_tbl::ALL_INFOS.as_ptr();
+	let _ = &mem_size_tbl::MEM_SIZE_TBL.as_ptr();
+}

src/rust/iced-x86/src/formatter/masm.rs

@@ -1762,3 +1762,8 @@ impl Formatter for MasmFormatter {
 		self.number_formatter.format_u64(&self.d.options, number_options, value)
 	}
 }
+
+pub(super) fn eager_init() {
+	let _ = &fmt_tbl::ALL_INFOS.as_ptr();
+	let _ = &mem_size_tbl::MEM_SIZE_TBL.as_ptr();
+}

src/rust/iced-x86/src/formatter/mod.rs

@@ -743,3 +743,21 @@ fn get_mnemonic_cc<'a>(options: &FormatterOptions, cc_index: u32, mnemonics: &'a
 	debug_assert!(index < mnemonics.len());
 	&mnemonics[index]
 }
+
+pub(crate) fn eager_init() {
+	let _ = &fmt_consts::FORMATTER_CONSTANTS.a64;
+	let _ = &fmt_consts::ARRAY_CONSTS.byte_ptr;
+	let _ = &regs_tbl_ls::REGS_TBL.len();
+	// Some static variables are private. Use public functions to eagerly initialize them.
+	pseudo_ops::eager_init();
+	#[cfg(feature = "fast_fmt")]
+	fast::eager_init();
+	#[cfg(feature = "gas")]
+	gas::eager_init();
+	#[cfg(feature = "intel")]
+	intel::eager_init();
+	#[cfg(feature = "masm")]
+	masm::eager_init();
+	#[cfg(feature = "nasm")]
+	nasm::eager_init();
+}

src/rust/iced-x86/src/formatter/nasm.rs

@@ -1717,3 +1717,9 @@ impl Formatter for NasmFormatter {
 		self.number_formatter.format_u64(&self.d.options, number_options, value)
 	}
 }
+
+pub(super) fn eager_init() {
+	let _ = &fmt_tbl::ALL_INFOS.as_ptr();
+	let _ = &mem_size_tbl::MEM_SIZE_TBL.as_ptr();
+	let _ = &regs::ALL_REGISTERS.as_ptr();
+}

src/rust/iced-x86/src/formatter/pseudo_ops.rs

@@ -255,3 +255,7 @@ fn create(sb: &mut String, cc: &[&str], size: usize, prefix: &str, suffix: &str)
 	}
 	strings
 }
+
+pub(super) fn eager_init() {
+	let _ = &PSEUDO_OPS.cmppd;
+}

src/rust/iced-x86/src/lib.rs

@@ -184,3 +184,13 @@ pub use crate::instruction::*;
 pub use crate::memory_size::*;
 pub use crate::mnemonic::*;
 pub use crate::register::*;
+
+/// ## eager_init function
+/// This routine initializes all static variables inside lazy_static. \
+/// Calling this routine is not required to use iced. The purpose of this routine is to
+/// minimalize memory allocations when using iced library.
+pub fn eager_init() {
+	decoder::eager_init();
+	encoder::eager_init();
+	formatter::eager_init();
+}