• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • Std
    • Proof-automation
    • Macro-libraries
    • ACL2
    • Interfacing-tools
    • Hardware-verification
    • Software-verification
      • Kestrel-books
      • X86isa
        • Program-execution
        • Sdm-instruction-set-summary
        • Tlb
        • Running-linux
        • Introduction
        • Asmtest
        • X86isa-build-instructions
        • Publications
        • Contributors
        • Machine
          • X86isa-state
          • Syscalls
          • Cpuid
          • Linear-memory
          • Rflag-specifications
          • Characterizing-undefined-behavior
          • Top-level-memory
          • App-view
          • X86-decoder
          • Physical-memory
          • Decoding-and-spec-utils
          • Instructions
            • Two-byte-opcodes
            • One-byte-opcodes
            • Fp-opcodes
            • Instruction-semantic-functions
            • X86-illegal-instruction
            • Implemented-opcodes
            • Opcode-maps
              • Cpuid
              • Opcode-maps-structures
                • Opcode
                  • Opcode-fix
                  • Make-opcode
                    • Opcode-p
                    • Opcode-equiv
                    • Change-opcode
                    • Opcode->superscripts
                    • Opcode->group
                    • Opcode->vex
                    • Opcode->r/m
                    • Opcode->reg
                    • Opcode->pfx
                    • Opcode->mode
                    • Opcode->feat
                    • Opcode->evex
                    • Opcode->rex
                    • Opcode->op
                    • Opcode->mod
                  • Inst
                  • Op/en-p
                  • Operands
                  • Inst-list-p
                  • Operand-type-p
                  • Strict-opcode-p
                  • Opcode-extension-group-p
                  • Superscripts-p
                  • Maybe-operands-p
                  • Exception-desc-p
                  • Count-avx-pfx-cases
                  • Mnemonic-p
                  • Maybe-3bits-p
                  • Op-pfx-p
                  • Maybe-vex-p
                  • Maybe-evex-p
                  • Fn-desc-p
                  • Op-mode-p
                  • Rex-p
                  • Mod-p
                  • Avx-pfx-well-formed-p
                  • Any-present-in
                  • Superscripts-fix
                  • Strict-opcode-fix
                  • Operand-type-fix
                  • Opcode-extension-group-fix
                  • Maybe-operands-fix
                  • Maybe-evex-fix
                  • Maybe-3bits-fix
                  • Keyword-list-fix
                  • Exception-desc-fix
                  • Rex-fix
                  • Op-pfx-fix
                  • Op-mode-fix
                  • Mod-fix
                  • Mnemonic-fix
                  • Maybe-vex-fix
                  • Fn-desc-fix
                  • Vex-p
                  • Evex-p
                • Implemented-opcodes
                • Chk-exc-fn
                • Filtering-instructions
                • Addressing-method-code-p
                • Operand-type-code-p
                • Eval-pre-map
              • X86-general-protection
              • X86-device-not-available
              • X86-step-unimplemented
              • Privileged-opcodes
              • Three-byte-opcodes
            • Register-readers-and-writers
            • X86-modes
            • Segmentation
            • Other-non-deterministic-computations
            • Environment
            • Paging
          • Implemented-opcodes
          • To-do
          • Proof-utilities
          • Peripherals
          • Model-validation
          • Modelcalls
          • Concrete-simulation-examples
          • Utils
          • Debugging-code-proofs
        • Axe
        • Execloader
      • Math
      • Testing-utilities
    • Opcode

    Make-opcode

    Basic constructor macro for opcode structures.

    Syntax
    (make-opcode [:op <op>] 
                 [:mode <mode>] 
                 [:reg <reg>] 
                 [:mod <mod>] 
                 [:r/m <r/m>] 
                 [:pfx <pfx>] 
                 [:rex <rex>] 
                 [:vex <vex>] 
                 [:evex <evex>] 
                 [:feat <feat>] 
                 [:superscripts <superscripts>] 
                 [:group <group>]) 
    

    This is the usual way to construct opcode structures. It simply conses together a structure with the specified fields.

    This macro generates a new opcode structure from scratch. See also change-opcode, which can "change" an existing structure, instead.

    Definition

    This is an ordinary make- macro introduced by defprod.

    Macro: make-opcode

    (defmacro make-opcode (&rest args)
      (std::make-aggregate 'opcode
                           args
                           '((:op quote 0)
                             (:mode quote nil)
                             (:reg quote nil)
                             (:mod quote nil)
                             (:r/m quote nil)
                             (:pfx quote nil)
                             (:rex quote nil)
                             (:vex quote nil)
                             (:evex quote nil)
                             (:feat quote nil)
                             (:superscripts quote nil)
                             (:group quote nil))
                           'make-opcode
                           nil))

    Function: opcode

    (defun opcode (op mode reg mod r/m pfx
                      rex vex evex feat superscripts group)
     (declare (xargs :guard (and (24bits-p op)
                                 (op-mode-p mode)
                                 (maybe-3bits-p reg)
                                 (mod-p mod)
                                 (maybe-3bits-p r/m)
                                 (op-pfx-p pfx)
                                 (rex-p rex)
                                 (maybe-vex-p vex)
                                 (maybe-evex-p evex)
                                 (symbol-listp feat)
                                 (superscripts-p superscripts)
                                 (opcode-extension-group-p group))))
     (declare (xargs :guard t))
     (let ((__function__ 'opcode))
      (declare (ignorable __function__))
      (b* ((op (mbe :logic (24bits-fix op) :exec op))
           (mode (mbe :logic (op-mode-fix mode)
                      :exec mode))
           (reg (mbe :logic (maybe-3bits-fix reg)
                     :exec reg))
           (mod (mbe :logic (mod-fix mod) :exec mod))
           (r/m (mbe :logic (maybe-3bits-fix r/m)
                     :exec r/m))
           (pfx (mbe :logic (op-pfx-fix pfx) :exec pfx))
           (rex (mbe :logic (rex-fix rex) :exec rex))
           (vex (mbe :logic (maybe-vex-fix vex)
                     :exec vex))
           (evex (mbe :logic (maybe-evex-fix evex)
                      :exec evex))
           (feat (mbe :logic (acl2::symbol-list-fix feat)
                      :exec feat))
           (superscripts (mbe :logic (superscripts-fix superscripts)
                              :exec superscripts))
           (group (mbe :logic (opcode-extension-group-fix group)
                       :exec group)))
       (std::prod-cons
          (std::prod-cons (std::prod-cons op (std::prod-cons mode reg))
                          (std::prod-cons mod (std::prod-cons r/m pfx)))
          (std::prod-cons
               (std::prod-cons rex (std::prod-cons vex evex))
               (std::prod-cons feat
                               (std::prod-cons superscripts group)))))))