view portasm/README.txt @ 606:85b7a117b807

- more statics in test code (this is partly needed on an experimental freebsd sparc64 build where the elf cleanup code crashes for some reason ... it's probably that experimental build, but a good change to do regardless)
author Tassilo Philipp
date Wed, 21 Sep 2022 15:20:58 +0200
parents ab2d78e48ca2
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)