view portasm/README.txt @ 341:ab2d78e48ca2

- gen-masm . fallback on clang if gcc not available . consolidated use of redundant scripts . regen of portasm based masm files - minor symbol name changes for clarity/consistency
author Tassilo Philipp
date Sat, 04 Jan 2020 23:00:02 +0100
parents 3e629dc19168
children cab0031c6691
line wrap: on
line source

portasm - a toolkit for writing portable generic assembler sources 
------------------------------------------------------------------

Copyright (C) 2011 Daniel Adler <dadler@uni-goettingen.de>.
Licensed under BSD two-clause license.


Requirements
------------
- C Preprocessor


Supported Architectures and Tool-chains:
----------------------------------------

- x86: gas, apple as, masm
- x64: gas, apple as, masm
- ppc: gas, apple as
- arm: gas, apple as


Usage:
------

Implement assembler sources in *.S files which use C preprocessor.
#include portasm-<ARCH>.S at front

In order to generate MASM files for X86 and X64, run 
  'gen-masm.sh <name> [<outsuffix>]' script which reads <name>.S and outputs <name><outsuffix>.masm file.


Common Macros:
--------------

BEGIN_ASM
END_ASM
BEGIN_PROC(name)
END_PROC(name)
GLOBAL(name)
HEX(value)