asmkit-rs 0.3.1

Portable assembler toolkit: decoding and encoding of various architectures
Documentation
use crate::x86::assembler::*;
use crate::x86::operands::*;
use super::super::opcodes::*;
use crate::core::emitter::*;
use crate::core::operand::*;

/// A dummy operand that represents no register. Here just for simplicity.
const NOREG: Operand = Operand::new();

/// `MONITOR`.
///
/// Supported operand variants:
///
/// ```text
/// +---+----------+
/// | # | Operands |
/// +---+----------+
/// | 1 | (none)   |
/// +---+----------+
/// ```
pub trait MonitorEmitter {
    fn monitor(&mut self);
}

impl<'a> MonitorEmitter for Assembler<'a> {
    fn monitor(&mut self) {
        self.emit(MONITOR, &NOREG, &NOREG, &NOREG, &NOREG);
    }
}

/// `MWAIT` (MWAIT). 
/// MWAIT instruction provides hints to allow the processor to enter an implementation-dependent optimized state. There are two principal targeted usages: address-range monitor and advanced power management. Both usages of MWAIT require the use of the MONITOR instruction.
///
///
/// For more details, see the [Intel manual](https://www.felixcloutier.com/x86/MWAIT.html).
///
/// Supported operand variants:
///
/// ```text
/// +---+----------+
/// | # | Operands |
/// +---+----------+
/// | 1 | (none)   |
/// +---+----------+
/// ```
pub trait MwaitEmitter {
    fn mwait(&mut self);
}

impl<'a> MwaitEmitter for Assembler<'a> {
    fn mwait(&mut self) {
        self.emit(MWAIT, &NOREG, &NOREG, &NOREG, &NOREG);
    }
}


impl<'a> Assembler<'a> {
    /// `MONITOR`.
    ///
    /// Supported operand variants:
    ///
    /// ```text
    /// +---+----------+
    /// | # | Operands |
    /// +---+----------+
    /// | 1 | (none)   |
    /// +---+----------+
    /// ```
    #[inline]
    pub fn monitor(&mut self)
    where Assembler<'a>: MonitorEmitter {
        <Self as MonitorEmitter>::monitor(self);
    }
    /// `MWAIT` (MWAIT). 
    /// MWAIT instruction provides hints to allow the processor to enter an implementation-dependent optimized state. There are two principal targeted usages: address-range monitor and advanced power management. Both usages of MWAIT require the use of the MONITOR instruction.
    ///
    ///
    /// For more details, see the [Intel manual](https://www.felixcloutier.com/x86/MWAIT.html).
    ///
    /// Supported operand variants:
    ///
    /// ```text
    /// +---+----------+
    /// | # | Operands |
    /// +---+----------+
    /// | 1 | (none)   |
    /// +---+----------+
    /// ```
    #[inline]
    pub fn mwait(&mut self)
    where Assembler<'a>: MwaitEmitter {
        <Self as MwaitEmitter>::mwait(self);
    }
}