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)

Linux                                               JULY 2019                                              M1(1)