• 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
        • Implemented-opcodes
        • To-do
        • Proof-utilities
        • Peripherals
        • Model-validation
        • Modelcalls
        • Concrete-simulation-examples
        • Utils
          • Structures
            • Rflagsbits
            • Cr4bits
            • Xcr0bits
            • Cr0bits
            • Prefixes
            • Ia32_eferbits
            • Evex-byte1
            • Cr3bits
            • Evex-byte3
            • Vex3-byte2
            • Vex3-byte1
            • Vex2-byte1
            • Evex-prefixes
            • Evex-byte2
            • Vex-prefixes
            • Sib
            • Modr/m-structures
            • Vex-prefixes-layout-structures
            • Sib-structures
            • Legacy-prefixes-layout-structure
            • Evex-prefixes-layout-structures
            • Cr8bits
            • 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
              • Segmentation-bitstructs
              • 8bits
              • 2bits
              • 4bits
              • 16bits
              • Paging-bitstructs
              • 3bits
              • 11bits
              • 40bits
              • 5bits
              • 32bits
              • 19bits
              • 10bits
              • 7bits
              • 64bits
              • 54bits
              • 45bits
              • 36bits
              • 31bits
              • 24bits
              • 22bits
              • 17bits
              • 13bits
              • 12bits
              • 6bits
              • Vex->x
              • Vex->b
              • Vex-prefixes-map-p
              • Vex-prefixes-byte0-p
              • Vex->w
              • Vex->vvvv
              • Vex->r
              • Fp-bitstructs
              • Cr4bits-debug
              • Vex->pp
              • Vex->l
              • Rflagsbits-debug
              • Evex->v-prime
              • Evex->z
              • Evex->w
              • Evex->vvvv
              • Evex->vl/rc
              • Evex->pp
              • Evex->aaa
              • Xcr0bits-debug
              • Vex3-byte1-equiv-under-mask
              • Vex3-byte2-equiv-under-mask
              • Vex2-byte1-equiv-under-mask
              • Vex-prefixes-equiv-under-mask
              • Rflagsbits-equiv-under-mask
              • Ia32_eferbits-equiv-under-mask
              • Evex-prefixes-equiv-under-mask
              • Evex-byte3-equiv-under-mask
              • Evex-byte2-equiv-under-mask
              • Evex-byte1-equiv-under-mask
              • Cr0bits-debug
              • Xcr0bits-equiv-under-mask
              • Sib-equiv-under-mask
              • Prefixes-equiv-under-mask
              • Cr8bits-equiv-under-mask
              • Cr4bits-equiv-under-mask
              • Cr3bits-equiv-under-mask
              • Cr0bits-equiv-under-mask
              • Vex3-byte1-debug
              • Prefixes-debug
              • Ia32_eferbits-debug
              • Evex-byte1-debug
              • Vex3-byte2-debug
              • Vex2-byte1-debug
              • Vex-prefixes-debug
              • Evex-prefixes-debug
              • Evex-byte3-debug
              • Evex-byte2-debug
              • Cr3bits-debug
              • Sib-debug
              • Cr8bits-debug
            • Utilities
          • 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)))))))