lkmc v2-rc

Unsquashed version at v2-rc-unsquashed, but that cannot be merged as it
breaks bisects at several points. All bugs will not bisect to this
humongous change.

It all started with a conversion of the Bash scripts to Python, mainly
because I couldn't stand not being able to properly use --options for
run which has a million options.

Then since that required a full testing, I decided to do all the
refactorings that I had in mind at once, and so I did and it became
v2-rc.

This is the largest patch I have ever done! OMG a few weeks of extra time.
I'm never writing a Bash script for anything that starts getting big again.

Some of the features are:

* separate build-qemu and build-gem5 commands
* common: convert scripts to python. Add --option for everything
* rename build to build-buildroot now that we are splitting all the build
  commands, Linux kernel to follow
* move all git submodules to submodules/ and all buildroot packages to
  packages/
* refactor the out/ structure. Keep projects on toplevel, because guest
  projects separate archs and host ones don't, making a toplevel arch wrong
* do-release: rename to just release
  https://stackoverflow.com/questions/16174992/cant-get-argparse-to-read-quoted-string-with-dashes-in-it
* run: add --terminal and explain gem5 pdb
* just track the lvimrc
* store CLI kernel config fragment inside buildlroot to avoid conflicts
* gem5: document m5 initparam
* readme: make a bunch of things awesomer
* readme: fix broken refs
* parsec-benchmark: update to 75d55ac446a43c47efb1044844a108c6c330184c
  Could not fetch otherwise.
* gem5: M5_OVERRIDE_PY_SOURCE

rungdb-user

@@ -1,38 +1,35 @@
-#!/usr/bin/env bash
-. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common"
-gem5_opt=
-while getopts "h${common_getopts_flags}" OPT; do
-  case "$OPT" in
-    h)
-      echo "$0 <exec-relative-path> [<brk-symbol>]"
-      exit
-      ;;
-    ?)
-      common_getopts_case "$OPT"
-      ;;
-  esac
-done
-shift "$(($OPTIND - 1))"
-executable_rel="$1"
-shift
-if [ "$#" -gt 0 ]; then
-  brk="'$1'"
-  shift
-else
-  brk=
-fi
-common_setup
-if "$common_gem5"; then
-  gem5_opt=-g
-fi
-executable="${common_build_dir}/${executable_rel}"
-addr="$("${common_root_dir}/runtc" readelf -h "$executable" | awk '/Entry/{ print $NF }' )"
-ex="-ex \"add-symbol-file $executable $addr\""
-# -X or else lx-symbols throws for arm:
+#!/usr/bin/env python3
+
+import imp
+import os
+import sys
+
+import common
+rungdb = imp.load_source('rungdb', os.path.join(common.root_dir, 'rungdb'))
+
+parser = common.get_argparse(argparse_args={
+    'description': '''GDB step debug guest userland processes without gdbserver.
+
+More information at: https://github.com/cirosantilli/linux-kernel-module-cheat#gdb-step-debug-userland-processes
+'''
+})
+parser.add_argument(
+    'executable',
+    help='Path to the executable to be debugged relative to the Buildroot build directory.'
+)
+parser.add_argument(
+    'break',
+    default=None,
+    help='Break at this point, e.g. main.',
+    nargs='?'
+)
+args = common.setup(parser)
+addr = common.get_elf_entry(os.path.join(common.build_dir, args.executable))
+extra_args = {}
+extra_args['before'] = '-ex \"add-symbol-file {} {}\"'.format(args.executable, hex(addr))
+# Or else lx-symbols throws for arm:
 # gdb.MemoryError: Cannot access memory at address 0xbf0040cc
 # TODO understand better.
-#
 # Also, lx-symbols overrides the add-symbol-file commands.
-cmd="./rungdb -a '${common_arch}' -b '${ex}' ${gem5_opt} -X ${brk}"
-echo "$cmd"
-eval "$cmd"
+extra_args['no_lxsymbols'] = True
+sys.exit(rungdb.main(args, extra_args))