add utilities for testing ELF files

SimRunner: support running an ELFFile

ISACaller: support loading an ELFFile

mem.py: add load_elf

mem.py: fix SIGBUS when accessing file mapped by mmap_syscall

this fixes SIGBUS errors caused by accessing beyond the end of a
file but still in the last page of the file, which is a valid thing to
do, except that we have to account for host pages having a different
size than emulated pages and map zeros to fill out the rest of the
emulated page.

caller.py: implement write syscall

caller.py: implement exit_group syscall

ISACaller: fix syscall emulation

there were two bugs fixed:
1. sc emulation was missing a `return`, so it tried to run sc
   again after running sc and rfid, giving the wrong CIA and
   MSR values.
2. the code to replace and restore the instruction with rfid
   had the wrong endian on the load, so it was corrupting the
   instruction for the next time it was used. I just deleted
   the save/replace/restore code since it isn't needed anymore.

I then changed the syscall tests to ensure both the
bugs above don't happen again.

setup: add pyelftools v0.30 as dependency

add g++-powerpc64le-linux-gnu to .gitlab-ci.yml

add mmap_syscall tests

implement MemMMap.mmap_syscall

add ppc_flags.py so we can get the ppc versions of all the flags we need

tells gcc to dump all #defines, and parses that.

msr and svstate default to None in TestCase, they're replaced with actual values in ISACaller

no point defining nm=-1

add 2nd maxloc case

move maxloc to isacaller directory

python conversion of maxloc.c

add TRAP docs

misc fixes for fallout of copying insn inputs

System Call Interrupts do *not* set SRR1[TRAP]

See PowerISA v3.1B Book III 7.5.14

support TRAP being called without setting a trap_bit

only write outputs that have .ok == True

use create_full_args to generate insn arg list

add SelectableInt.ok

helper for one-source-of-truth for insn argument list for ISACaller and parser

copy_assign_rhs must retain subclasses of SelectableInt

log load/stores to InstrInOuts

format code

misc AST correctness fixes

fix maxloc

add debug print

whoole stack of whitespace corrections

more crap removed

remove unnecessary cruft from Makefile

Removed unused include: bug #676

Adding fortran C example for Shriya, bug #676

rename all load/store update-shifted-post-increment to *upsx

https://bugs.libre-soc.org/show_bug.cgi?id=1048#c21

fix instruction name conflicts

remove lhaup from pifixedloadshift -- all pi-shift instructions are indexed X-Form rather than D-Form

detect duplicate instructions

rename pifpstore instructions, add "p" into names

use of the word "Kind" is too irritating. replace all occurrences with "Type".
cannot replace lowercase "kind" with "type" as it is a python keyword.
have to think of a better (*short*) argument name

comment on rfid doing a swap-backup of the program, must find
out why and fix it so that is not necessary

add LSHIFT and RSHIFT operators to parser. reluctantly

look for and allow blank lines in pseudocode as well
as english description. remove use of regex (too complex to understand)

missing colon on end of "Description"

remove use of regex (this code is REQUIRED to be SIMPLE)

forgot title

missing brackets in lhbrx

added english language description for lhbrsx instruction

missing brackets in lhbrx

added english language description for lhbrsx instruction

added english language description for ldsux instruction

replace (RA) with "the contents of RA"

added english language description for ldbrsx instruction

pifploadshift.mdwn, do one example english pseudocode operands

added english language description for lwbrsx instruction

do one example stfsux in pifpstoreshift, english pseudocode operands

added english language description for lhbrsx instruction

added english language description for ldsx instruction

added english language description for lwasux instruction

contents of RA again

added english language description for lwasx instruction

added english language description for lwzsux instruction

added english language description for lwzsx instruction

use words "the contents of register RA instead of (RA)

whitespace

whitespace and
also use explicit "the contents of register RA

added english language description for lhasux instruction

whitespace

added english language description for lhasx instruction

whitespace

added english language description for lhzsux instruction

whitespace

space-dot whitespace cleanup

added english language description for lhzsx instruction

big whitespace cleanup

added english language description for lbzsux instruction

added english language description for lbzsx instruction

whitespace cleanup

whitespace cleanup

added commas

add a comma to reduce ambiguity

added english language description for stdbrsx instruction

added english language description for stwbrsx instruction

added english language description for sthbrx instruction

added english language description for stdsux instruction

added english language description for stdsx instruction

added english language description for stwsux instruction

remove immediate-versions of instructions for shifting
as there is no point shifting an immediate

added english language description for stwsx instruction

added english language description for sthsux instruction

added english language description for sthsx instruction

added english language description for stbsux instruction

add pifpstoreshift.mdwn and pifploadshift.mdwn as
copies of their non-shifted variants

add copy of pifixedstore.mdwn renamed to pifixedstoreshift.mdwn
modifications required to add "shifting"

remove ambiguity of english description in stbsx

english language description for stbsx

added stdbrsx instruction