NAME¶

M1 - The universal Macro assembler

SYNOPSIS¶

M1 --architecture ARCHITECTURE --file FILE [--output FILE --octal --binary --big-endian --little-endian]

DESCRIPTION¶

M1 is the most minimal cross-platform macro assembler possible

Leveraging a few grammar details to provide the user with a rich vocabulary of ways of expressing their desired output and input; thus eliminating surprise from the generation process.
At it's core is DEFINE MACRO EXPANDED
Where one can define an assembly instruction like: DEFINE INT_80 CD80 and know that everywhere INT_80 is placed in the input file there will be the hex encoding of that instruction in the output file or if no output file is specified the output will be send to standard out.

The supported ARCHITECTURES are as follows: knight-native, knight-posix, x86, amd64, armv7l and aarch64. If you fail to specify an architecture, the default of knight-native will be used.

M1 also supports the generation of 8, 16 and 32bit integers provided they are encoded as !NUM, @NUM or %NUM respectively. eg !-1, @42 and %8675309 You however can not mix integers with definitions as macros are always applied first and will not be evaluated further.

Should you wish to specify the bit and byte encoding of the integers to match your target --big-endian and --little-endian

Should you wish for the output to be something other than hex format, you can specify the exact output you desire with: --octal or --binary

EXAMPLES¶

Typically, M1 will be called in scripts used in bootstrapping
# M1 -f x86.defs -f libc-core.M1 -f cc.M1 -f cc-footer.M1 --little-endian --architecture x86 -o cc.hex2

COMPATIBILITY¶

M1 is compatible with all Turing complete machines; even the ones that try to be Turing complete -1

AUTHORS¶

Jeremiah Orians <Jeremiah@pdp10.guru>
Jan (janneke) Nieuwenhuizen <janneke@gnu.org>

COPYRIGHT¶

Copyright 2016-2019 Jeremiah Orians <Jeremiah@pdp10.guru>
Copyright 2017 Jan Nieuwenhuizen <janneke@gnu.org>
License GPLv3+.

SEE ALSO¶

hex2(1), blood-elf(1), kaem(1), syscalls(2)