revng-revng/include/revng/Model/ABI.h

#pragma once

//
// This file is distributed under the MIT License. See LICENSE.md for details.
//

#include "revng/Model/Architecture.h"

/* TUPLE-TREE-YAML
name: ABI
type: enum
members:
  - name: SystemV_x86_64
    doc: >
      64-bit SystemV ABI for x86 processor architecture.
      The latest version of the documentation can be found
      \sa https://gitlab.com/x86-psABIs/x86-64-ABI

  - name: SystemV_x86
    doc: >
      32-bit SystemV ABI for x86 processor architecture.
      The latest version of the documentation can be found
      \sa https://gitlab.com/x86-psABIs/i386-ABI/-/tree/hjl/x86/master

  - name: SystemV_x86_regparm_3
    doc: >
      A gcc specific modification of the 32-bit SystemV ABI for x86 processor
      architecture. It allows three first GPR-sized arguments to be passed
      using the EAX, EDX, and ECX registers.
      \sa `regparm` x86 function attribute.

  - name: SystemV_x86_regparm_2
    doc: >
      A gcc specific modification of the 32-bit SystemV ABI for x86 processor
      architecture. It allows two first GPR-sized arguments to be passed
      using the EAX, and ECX registers.
      \sa `regparm` x86 function attribute.

  - name: SystemV_x86_regparm_1
    doc: >
      A gcc specific modification of the 32-bit SystemV ABI for x86 processor
      architecture. It allows the first GPR-sized argument to be passed
      using the EAX register.
      \sa `regparm` x86 function attribute.

  - name: Microsoft_x86_64
    doc: >
      64-bit Microsoft ABI for x86 processor architecture.
      The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/build/x64-calling-convention

  - name: Microsoft_x86_64_vectorcall
    doc: >
      A modification of 64-bit Microsoft ABI for x86 processor architecture.
      It allows using extra vector registers for passing function arguments.
      The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/cpp/vectorcall

  - name: Microsoft_x86_64_clrcall
    doc: >
      A modification of 64-bit Microsoft ABI for x86 processor architecture.
      It uses CLR expression stack to pass function arguments.
      The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/cpp/clrcall

  - name: Microsoft_x86_cdecl
    doc: >
      The default 32-bit Microsoft ABI for x86 processor architecture.
      It was indented to be compatible with `SystemV_x86` but there are slight
      differences. The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/cpp/cdecl

  - name: Microsoft_x86_stdcall
    doc: >
      A modification of the 32-bit `__cdecl` Microsoft ABI for x86 processor
      architecture. The main difference is the fact that the callee is
      responsible for stack cleanup instead of the caller.
      The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/cpp/stdcall

  - name: Microsoft_x86_thiscall
    doc: >
      A modification of the 32-bit `__stdcall` Microsoft ABI for x86 processor
      architecture. The main difference is the fact that it allows to pass a
      single (the first) function argument using a register. This ABI is only
      used for member function call where the first argument is always a `this`
      pointer. The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/cpp/thiscall

  - name: Microsoft_x86_fastcall
    doc: >
      A modification of the 32-bit `__stdcall` Microsoft ABI for x86 processor
      architecture. The main difference is the fact that it allows to pass two
      first GPR-sized non-aggregate function arguments in registers.=
      The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/cpp/fastcall

  - name: Microsoft_x86_clrcall
    doc: >
      A modification of 32-bit Microsoft ABI for x86 processor architecture.
      It uses CLR expression stack to pass function arguments.
      The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/cpp/clrcall

  - name: Microsoft_x86_vectorcall
    doc: >
      A modification of the 32-bit `__fastcall` Microsoft ABI for x86 processor
      architecture. It allows using extra vector registers for passing function
      arguments. The documentation can be found
      \sa https://docs.microsoft.com/en-us/cpp/cpp/vectorcall

  - name: Pascal_x86
    doc: >
      An abi similar to 32-bit `__stdcall` Microsoft ABI for x86 processor
      architecture. The main difference is the fact that the stack parameters
      are placed left-to-right instead of right-to-left
      \sa Trustworthy documentation is hard to find.

  - name: AAPCS64
    doc: >
      Stands for `Arm Architecture Procedure Call Standard (64-bit)`.
      The official ABI for AArch64 (ARM64) processor architecture.
      The latest version of the documentation can be found
      \sa https://github.com/ARM-software/abi-aa/releases

  - name: AAPCS
    doc: >
      Stands for `Arm Architecture Procedure Call Standard`.
      The official ABI for ARM processor architecture.
      The latest version of the documentation can be found
      \sa https://github.com/ARM-software/abi-aa/releases

  - name: SystemV_MIPS_o32
    doc: >
      The ABI for MIPS RISC processor architecture.
      The latest version of the documentation can be found
      \sa http://math-atlas.sourceforge.net/devel/assembly/mipsabi32.pdf

  - name: SystemV_MIPSEL_o32
    doc: >
      The ABI for MIPS RISC processor architecture (little endian edition).
      The latest version of the documentation can be found
      \sa http://math-atlas.sourceforge.net/devel/assembly/mipsabi32.pdf

  - name: SystemZ_s390x
    doc: >
      The s390x ABI for SystemZ processor architecture.
      The latest version of the documentation can be found
      \sa https://github.com/IBM/s390x-abi
TUPLE-TREE-YAML */

#include "revng/Model/Generated/Early/ABI.h"

namespace model::ABI {

inline constexpr model::Architecture::Values
getArchitecture(model::ABI::Values V) {
  switch (V) {
  case model::ABI::SystemV_x86_64:
  case model::ABI::Microsoft_x86_64:
  case model::ABI::Microsoft_x86_64_clrcall:
  case model::ABI::Microsoft_x86_64_vectorcall:
    return model::Architecture::x86_64;

  case model::ABI::SystemV_x86:
  case model::ABI::SystemV_x86_regparm_3:
  case model::ABI::SystemV_x86_regparm_2:
  case model::ABI::SystemV_x86_regparm_1:
  case model::ABI::Microsoft_x86_clrcall:
  case model::ABI::Microsoft_x86_vectorcall:
  case model::ABI::Microsoft_x86_cdecl:
  case model::ABI::Microsoft_x86_stdcall:
  case model::ABI::Microsoft_x86_fastcall:
  case model::ABI::Microsoft_x86_thiscall:
  case model::ABI::Pascal_x86:
    return model::Architecture::x86;

  case model::ABI::AAPCS64:
    return model::Architecture::aarch64;
  case model::ABI::AAPCS:
    return model::Architecture::arm;

  case model::ABI::SystemV_MIPS_o32:
    return model::Architecture::mips;

  case model::ABI::SystemV_MIPSEL_o32:
    return model::Architecture::mipsel;

  case model::ABI::SystemZ_s390x:
    return model::Architecture::systemz;

  case model::ABI::Count:
  case model::ABI::Invalid:
  default:
    revng_abort();
  }
}

inline constexpr model::ABI::Values getDefault(model::Architecture::Values V) {
  switch (V) {
  case model::Architecture::x86:
    return model::ABI::SystemV_x86;
  case model::Architecture::arm:
    return model::ABI::AAPCS;
  case model::Architecture::mips:
    return model::ABI::SystemV_MIPS_o32;
  case model::Architecture::mipsel:
    return model::ABI::SystemV_MIPSEL_o32;
  case model::Architecture::x86_64:
    return model::ABI::SystemV_x86_64;
  case model::Architecture::aarch64:
    return model::ABI::AAPCS64;
  case model::Architecture::systemz:
    return model::ABI::SystemZ_s390x;

  case model::Architecture::Invalid:
  case model::Architecture::Count:
  default:
    revng_abort();
  }
}

inline constexpr llvm::StringRef getDescription(model::ABI::Values V) {
  switch (V) {
  case model::ABI::SystemV_x86_64:
    return "64-bit SystemV x86 abi";
  case model::ABI::Microsoft_x86_64:
    return "64-bit Microsoft x86 abi";
  case model::ABI::Microsoft_x86_64_clrcall:
    return "64-bit Microsoft x86 abi that uses CLR expression "
           "stack for passing function arguments";
  case model::ABI::Microsoft_x86_64_vectorcall:
    return "64-bit Microsoft x86 abi with extra vector "
           "registers designited for passing function "
           "arguments";

  case model::ABI::SystemV_x86:
    return "32-bit SystemV x86 abi";
  case model::ABI::SystemV_x86_regparm_3:
    return "32-bit SystemV x86 abi that allows the first three GPR-sized "
           "scalar arguments to be passed using the registers";
  case model::ABI::SystemV_x86_regparm_2:
    return "32-bit SystemV x86 abi that allows the first two GPR-sized "
           "scalar arguments to be passed using the registers";
  case model::ABI::SystemV_x86_regparm_1:
    return "32-bit SystemV x86 abi that allows the first "
           "GPR-sized scalar argument to be passed using "
           "the registers";
  case model::ABI::Microsoft_x86_clrcall:
    return "32-bit Microsoft x86 abi that uses CLR expression "
           "stack for function argument passing";
  case model::ABI::Microsoft_x86_vectorcall:
    return "64-bit Microsoft x86 abi, it extends `fastcall` "
           "by allowing extra vector registers to be used for "
           "function argument passing";
  case model::ABI::Microsoft_x86_cdecl:
    return "32-bit Microsoft x86 abi that was intended to "
           "mimic 32-bit SystemV x86 abi but has minor "
           "differences";
  case model::ABI::Microsoft_x86_stdcall:
    return "32-bit Microsoft x86 abi, it is a modification of "
           "`cdecl` that's different in a sense that the "
           "callee is responsible for stack cleanup instead "
           "of the caller";
  case model::ABI::Microsoft_x86_fastcall:
    return "32-bit Microsoft x86 abi, it extends `stdcall` by "
           "allowing two first GPR-sized function arguments "
           "to be passed using the registers";
  case model::ABI::Microsoft_x86_thiscall:
    return "32-bit Microsoft x86 abi, it extends `stdcall` by "
           "allowing `this` pointer in method-style calls to "
           "be passed using a register. It is never used for "
           "'free' functions";
  case model::ABI::Pascal_x86:
    return "An abi similar to 32-bit `stdcall` Microsoft ABI for x86 "
           "processor architecture. The main difference is the fact that the "
           "stack parameters are placed left-to-right instead of right-to-left";

  case model::ABI::AAPCS64:
    return "64-bit ARM abi";
  case model::ABI::AAPCS:
    return "32-bit ARM abi";

  case model::ABI::SystemV_MIPS_o32:
    return "The \"old\" 32-bit MIPS abi";

  case model::ABI::SystemV_MIPSEL_o32:
    return "The \"old\" 32-bit MIPS abi (little endian edition)";

  case model::ABI::SystemZ_s390x:
    return "The s390x SystemZ ABI";

  case model::ABI::Count:
  case model::ABI::Invalid:
  default:
    return "Unknown and/or unsupported ABI";
  }
}

} // namespace model::ABI

#include "revng/Model/Generated/Late/ABI.h"