#
# This is the library part of Anita, the Automated NetBSD Installation
# and Test Application.
#

from __future__ import print_function
from __future__ import division

import gzip
import os
import pexpect
import re
import string
import shutil
import subprocess
import sys
import time

# Deal with gratuitous urllib changes in Python 3

if sys.version_info >= (3, 13, 0):
    import urllib.request
    import urllib.parse

if sys.version_info[0] >= 3:
    import urllib.request as good_old_urllib
    import urllib.parse as good_old_urlparse
else:
    import urllib as good_old_urllib
    import urlparse as good_old_urlparse

# Find a function for quoting shell commands
try:
    from shlex import quote as sh_quote
except ImportError:
    from pipes import quote as sh_quote

# Disable buffering of all printed messages (Python 3 only)

if sys.version_info[0] >= 3:
    import functools
    print = functools.partial(print, flush = True)

__version__='2.18'

# Your preferred NetBSD FTP mirror site, and the archive site used for
# obtaining older releases.
#
# These are used only by the obsolete code for getting releases
# by number, not by the recommended method of getting them by URL.

netbsd_mirror_url = "https://ftp.netbsd.org/pub/NetBSD/"
netbsd_archive_url = "https://archive.netbsd.org/pub/NetBSD-archive/"

# The supported architectures, and their properties.

# If an 'image_name' property is present, installation is done
# using a pre-built image of that name and a kernel from the
# 'kernel_name' list, rather than using sysinst.  If multiple
# kernel names are listed, the first one present in the release
# is used.

arch_props = {
    'i386': {
        'qemu': {
            'executable': 'qemu-system-i386',
        },
        'scratch_disk': 'wd1d',
        'boot_from_default': 'floppy',
        'memory_size': '64M',
    },
    'amd64': {
        'qemu': {
            'executable': 'qemu-system-x86_64',
        },
        'scratch_disk': 'wd1d',
        'memory_size': '192M',
    },
    'sparc': {
        'qemu': {
            'executable': 'qemu-system-sparc',
        },
        'scratch_disk': 'sd1c',
        'memory_size': '64M',
    },
    'sparc64': {
        'qemu': {
            'executable': 'qemu-system-sparc64',
        },
        'scratch_disk': 'wd1c',
        'memory_size': '128M',
    },
    'evbarm-earmv7hf': {
        'qemu': {
            'executable': 'qemu-system-arm',
            'machine_default': 'vexpress-a15',
        },
        'image_name': 'armv7.img.gz',
        'kernel_name': ['netbsd-VEXPRESS_A15.ub.gz', 'netbsd-GENERIC.ub.gz'],
        'scratch_disk': None,
        'memory_size': '128M',
    },
    'evbarm-aarch64': {
        'qemu': {
            'executable': 'qemu-system-aarch64',
            'machine_default': 'virt',
        },
        'image_name': 'arm64.img.gz',
        'kernel_name': ['netbsd-GENERIC64.img.gz'],
        'scratch_disk': 'ld5c',
        'memory_size': '512M',
    },
    'pmax': {
        'gxemul': {
        },
        'scratch_disk': 'sd1c',
        'memory_size': '128M',
        'inst_kernel': 'binary/kernel/netbsd-INSTALL.gz',
    },
    'hpcmips': {
        'gxemul': {
        },
        'inst_kernel': 'installation/netbsd.gz',
        'scratch_disk': None,
    },
    'landisk': {
        'gxemul': {
        },
        'scratch_disk': 'wd1d'
    },
    'vax': {
        'simh': {
        },
        'scratch_disk': 'ra1c',
    },
    'hppa': {
        'qemu': {
            'executable': 'qemu-system-hppa',
        },
        'scratch_disk': 'sd1c',
    },
    'macppc': {
        'qemu': {
            'executable': 'qemu-system-ppc',
            'machine_default': 'mac99',
        },
        'memory_size': '256M',
        'inst_kernel': 'binary/kernel/netbsd-INSTALL.gz',
        'scratch_disk': 'wd1c',
    },
    'alpha': {
        'qemu': {
            'executable': 'qemu-system-alpha',
        },
        'boot_from_default': 'kernel',
        # Consistency would be nice
        'inst_kernel': 'installation/instkernel/netbsd.gz',
        'scratch_disk': 'wd1c',
    },
    'riscv-riscv64': {
        'qemu': {
            'executable': 'qemu-system-riscv64',
            'machine_default': 'virt',
        },
        'image_name': 'riscv64.img.gz',
        'kernel_name': ['netbsd-GENERIC64.gz'],
        'memory_size': '256M',
        'boot_from_default': 'kernel',
        'scratch_disk': 'ld5c',
    },
    # Experimental, for noemu
    'evbmips-mips64eb': {
        'noemu': {
        },
        'inst_kernel': 'installation/netbsd-INSTALL_OCTEON.gz',
    },
}

# Filename extensions used for the installation sets in different
# versions of NetBSD
set_exts = ['.tgz', '.tar.xz']

# External command to build ISO images.  This must be mkisofs to
# build the macppc ISO images.

# Several different kinds of ISO images are used for different purposes:
#
#  install boot ISO
#    for booting the install kernel, e.g., boot-com.iso from the i386
#    distribution
#
#  install sets ISO
#    for holding the installation sets, e.g., the install_tmp.iso built
#    by anita for i386 installation
#
#  install combined ISO
#    a single ISO serving both the above roles, e.g., the sparc install ISO
#
#  runtime boot ISO
#    for booting installed maccppc targets only

# A shared file descriptor for /dev/null
fnull = open(os.devnull, 'w')

# Return true if the given program (+args) can be successfully run

def try_program(argv):
   try:
       result = subprocess.call(argv, stdout = fnull, stderr = fnull)
       return result == 0
   except OSError:
       return False

# Create a directory if missing

def mkdir_p(dir):
    if not os.path.isdir(dir):
        os.makedirs(dir)

# Remove a file, ignoring errors
def rm_f(fn):
    try:
        os.unlink(fn)
    except:
        pass

# Create a hard link, removing the destination first
def ln_f(src, dst):
    rm_f(dst)
    os.link(src, dst)

# Uncompress a file
def gunzip(src, dst):
    with gzip.open(src, 'rb') as srcf:
        with open(dst, 'wb') as dstf:
            shutil.copyfileobj(srcf, dstf)

# Quote a shell command.  This is intended to make it possible to
# manually cut and paste logged command into a shell.

def quote_shell_command(v):
    s = ''
    for i in range(len(v)):
        if i > 0:
            # Try to keep options and their arguments on the same line
            if v[i - 1].startswith('-') and not v[i].startswith('-'):
                s += ' '
            else:
                s += ' \\\n    '
        s += sh_quote(v[i])
    return s

# Run a shell command safely and with error checking

def spawn(command, args):
    print(quote_shell_command(args))
    sys.stdout.flush()
    ret = os.spawnvp(os.P_WAIT, command, args)
    if ret != 0:
        raise RuntimeError("could not run " + command)

# Subclass pexpect.spawn to add logging of expect() calls

class pexpect_spawn_log(pexpect.spawn):
    def __init__(self, logf, *args, **kwargs):
        self.structured_log_f = logf
        return super(pexpect_spawn_log, self).__init__(*args, **kwargs)
    def expect(self, pattern, *args, **kwargs):
        slog(self.structured_log_f, "expect", pattern, timestamp = False);
        r = pexpect.spawn.expect(self, pattern, *args, **kwargs)
        slog(self.structured_log_f, "match", self.match.group(0), timestamp = False);
        return r

if sys.version_info < (3, 13, 0):
    # Subclass urllib.FancyURLopener so that we can catch
    # HTTP 404 errors
    class MyURLopener(good_old_urllib.FancyURLopener):
        def http_error_default(self, url, fp, errcode, errmsg, headers):
            raise IOError('HTTP error code %d' % errcode)

def my_urlretrieve(url, filename):
    if sys.version_info >= (3, 13, 0):
        r = urllib.request.urlretrieve(url, filename)
    else:
        r = MyURLopener().retrieve(url, filename)
        if sys.version_info >= (2, 7, 12):
            # Work around https://bugs.python.org/issue27973
            good_old_urllib.urlcleanup()
    return r

# Download a file, cleaning up the partial file if the transfer
# fails or is aborted before completion.

def download_file(url, file):
    try:
        my_urlretrieve(url, file)
    except IOError as e:
        if os.path.exists(file):
            os.unlink(file)
        raise

# Create a file of the given size, containing NULs, without holes.

def make_dense_image(fn, size):
    f = open(fn, "wb")
    blocksize = 64 * 1024
    while size > 0:
        chunk = min(size, blocksize)
        f.write(b"\000" * chunk)
        size = size - chunk
    f.close()

# As above but with holes

def make_sparse_image(fn, size):
    f = open(fn, "wb")
    f.seek(size - 1)
    f.write(b"\000")
    f.close()

def make_image(fn, size, format):
    if format == 'dense':
        f = make_dense_image
    elif format == 'sparse':
        f = make_sparse_image
    else:
        raise RuntimeError("unknown image format %s" % format)
    f(fn, size)

# Parse a size with optional k/M/G/T suffix and return an integer

def parse_size(size):
    m = re.match(r'(\d+)([kMGT])?$', size)
    if not m:
        raise RuntimeError("%s: invalid size" % size)
    size, suffix = m.groups()
    mult = dict(k=1024, M=1024**2, G=1024**3, T=1024**4).get(suffix, 1)
    return int(size) * mult

# Download "url" to the local file "file".  If the file already
# exists locally, do nothing.  If "optional" is true, ignore download
# failures and cache the absence of a missing file by creating a marker
# file with the extension ".MISSING".
#
# Returns true iff the file is present.

def download_if_missing_2(url, file, optional = False):
    if os.path.exists(file):
        return True
    if os.path.exists(file + ".MISSING"):
        return False
    dir = os.path.dirname(file)
    mkdir_p(dir)
    try:
        print("Downloading", url + "...", end=' ')
        sys.stdout.flush()
        download_file(url, file)
        print("OK")
        sys.stdout.flush()
        return True
    except IOError as e:
        if optional:
            if is_real_error(url, e):
                raise
            print("missing but optional, so that's OK")
            sys.stdout.flush()
            f = open(file + ".MISSING", "w")
            print(e, file = f)
            f.close()
            return False
        else:
            print(e)
            raise

def download_if_missing_3(urlbase, dirbase, relpath, optional = False):
    scheme, netloc, path, query, fragment = good_old_urlparse.urlsplit(urlbase)
    path += "/".join(relpath)
    url = good_old_urlparse.urlunsplit((scheme, netloc, path, query, fragment))
    file = os.path.join(*([dirbase] + relpath))
    return download_if_missing_2(url, file, optional)

if sys.version_info >= (3, 13, 0):
    # Return true if we can confidenlty determine that an attempt to
    # download "url" that raised the exception "e" is due to a real
    # error, not just the file legitimately not existing.  When in
    # doubt, for example in the case of ftp URLs, return false.
    def is_real_error(url, e):
        parts = urllib.parse.urlparse(url)
        scheme = parts[0].lower()
        return \
            ((scheme == 'http' or scheme == 'https') and \
                isinstance(e, urllib.error.HTTPError) and e.code != 404) or \
            scheme == 'file' and \
                not (isinstance(e, urllib.error.URLError) and
                     isinstance(e.reason, FileNotFoundError))
else:
    # Supporting this for all old versions is too painful
    def is_real_error(url, e):
        return False

# Map a URL to a directory name.  No two URLs should map to the same
# directory.

def url2dir(url):
    bad_chars = r"/:+-?="
    bad_chars_re = r"[" + re.escape(bad_chars) + r"]"
    tail = []
    def munge(match):
        index = bad_chars.find(match.group())
        if index != 0:
            tail.append(chr(0x60 + index) + str(match.start()))
        return "-"
    return "work-" + re.sub(bad_chars_re, munge, url) + "+" + "".join(tail)

# Inverse of the above; not used, but included just to show that the
# mapping is invertible and therefore collision-free

class InvalidDir(Exception):
    pass

def dir2url(dir):
    match = re.match(r"(work-)(.*)\+(.*)", dir)
    work, s, tail = match.groups()
    if work != 'work-':
        raise InvalidDir()
    s = re.sub("-", "/", s)
    chars = list(s)
    while True:
        m = re.match(r"([a-z])([0-9]+)", tail)
        if not m:
            break
        c, i = m.groups()
        chars[int(i)] = "/:+-"[ord(c) - 0x60]
        tail = tail[m.end():]
    return "".join(chars)

def check_arch_supported(arch, dist_type):
    if not arch in arch_props:
        raise RuntimeError(("'%s' is not the name of a " + \
        "supported NetBSD port") % arch)
    if arch in ['i386', 'amd64'] and dist_type != 'reltree':
        raise RuntimeError(("NetBSD/%s must be installed from " +
            "a release tree, not an ISO") % arch)
    if (arch in ['sparc', 'sparc64', 'vax']) and dist_type != 'iso':
        raise RuntimeError(("NetBSD/%s must be installed from " +
        "an ISO, not a release tree") % arch)

# Expect any of a set of alternatives.  The *args are alternating
# patterns and actions; an action can be a string to be sent
# or a function to be called with no arguments.  The alternatives
# will be expected repeatedly until the last one in the list has
# been selected.

def expect_any(child, *args):
    # http://stackoverflow.com/questions/11702414/split-a-list-into-half-by-even-and-odd-elements
    patterns = args[0:][::2]
    actions = args[1:][::2]
    while True:
        r = child.expect(list(patterns))
        action = actions[r]
        if isinstance(action, str):
            child.send(action)
        else:
            action()
        if r == len(actions) - 1:
            break

# Receive and discard (but log) input from the child or a time
# period of "seconds".  This is effectively a delay like
# time.sleep(seconds), but generates more useful log output.

def gather_input(child, seconds):
    try:
        # This regexp will never match
        child.expect("(?!)", seconds)
    except pexpect.TIMEOUT:
        pass

# Reverse the order of sublists of v of length sublist_len
# for which the predicate pred is true.

def reverse_sublists(v, sublist_len, pred):
    # Build a list of indices in v in where a sublist satisfying
    # pred begins
    indices = []
    for i in range(len(v) - (sublist_len - 1)):
        if pred(v[i:i+sublist_len]):
            indices.append(i)
    # Swap list element pairs, working outside in
    for i in range(len(indices) >> 1):
        a = indices[i]
        b = indices[-i - 1]
        def swap(a, b):
            v[a], v[b] = v[b], v[a]
        for j in range(sublist_len):
            swap(a + j, b + j)

# Reverse the order of any "-drive ... -device virtio-blk-device,..."
# option pairs in v

def reverse_virtio_drives(v):
    def is_virtio_blk(sublist):
        return sublist[0] == '-drive' and sublist[2] == '-device' \
            and sublist[3].startswith('virtio-blk-device')
    reverse_sublists(v, 4, is_virtio_blk)

# Format at set of key-value pairs as used in qemu command line options.
# Takes a sequence of tuples.

def qemu_format_attrs(attrs):
    return ','.join(["%s=%s" % pair for pair in attrs])

#############################################################################

# A NetBSD version.
#
# Subclasses should define:
#
#    dist_url(self)
#       the top-level URL for the machine-dependent download tree where
#       the version can be downloaded, for example,
#       ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-5.0.2/i386/
#
#    mi_url(self)
#       The top-level URL for the machine-independent download tree,
#       for example, ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-5.0.2/
#
#    default_workdir(self)
#        a file name component identifying the version, for use in
#        constructing a unique, version-specific working directory
#
#    arch(self)
#        the name of the machine architecture the version is for,
#        e.g., i386

def make_item(t):
    d = dict(list(zip(['filename', 'label', 'install'], t[0:3])))
    if isinstance(t[3], list):
        d['group'] = make_set_dict_list(t[3])
    else:
        d['optional'] = t[3]
    d['label'] = d['label'].encode('ASCII')
    return d

def make_set_dict_list(list_):
    return [make_item(t) for t in list_]

def flatten_set_dict_list(list_):
    def item2list(item):
        group = item.get('group')
        if group:
            return group
        else:
            return [item]
    return sum([item2list(item) for item in list_], [])

class Version(object):
    # Information about the available installation file sets.  As the
    # set of sets (sic) has evolved over time, this actually represents
    # the union of those sets of sets, in other words, this list should
    # contain all currently and historically known sets.
    #
    # This list is used for to determine
    # - Which sets we should attempt to download
    # - Which sets we should install by default
    #
    # Each array element is a tuple of four fields:
    #   - the file name
    #   - a regular expression matching the label used by sysinst
    #     (taking into account that it may differ between sysinst versions)
    #   - a flag indicating that the set should be installed by default
    #   - a flag indicating that the set is not present in all versions
    #

    sets = make_set_dict_list([
      # In all version but not in all ports (missing from evmips-mips64eb)
      [ 'kern-GENERIC', r'Kernel (GENERIC)', 1, 1 ],
      [ 'kern-GENERIC.NOACPI', r'Kernel \(GENERIC\.NOACPI\)', 0, 1 ],
      [ 'modules', r'Kernel [Mm]odules', 1, 1 ],
      # Must match the end of the label here so we don't accidentally
      # match "Base 32-bit compatibility libraries".
      [ 'base', r'Base$', 1, 0 ],
      [ 'base32', r'Base 32-bit compatibility libraries', 1, 1 ],
      [ 'etc', r'(System)|(System configuration files)|(Configuration files) \(/etc\)', 1, 0 ],
      [ 'comp', r'Compiler [Tt]ools', 1, 0 ],
      [ 'games', r'Games', 0, 0 ],
      [ 'gpufw', r'Graphics driver firmware', 1, 1 ],
      # Must match the end of the label here so we don't accidentally
      # match "Manual pages (HTML)".
      [ 'man', r'(Online )?Manual [Pp]ages$', 0, 0 ],
      [ 'manhtml', r'Manual pages \(HTML\)}', 0, 1 ],
      [ 'misc', r'Miscellaneous', 1, 0 ],
      [ 'rescue', r'Recovery [Tt]ools', 1, 1 ],
      [ 'tests', r'Test programs', 1, 1 ],
      [ 'text', r'Text [Pp]rocessing [Tt]ools', 0, 0 ],
      [ '_x11', r'X11 sets', 0, [
          ['xbase',   r'X11 base and clients', 0, 1 ],
          ['xcomp',   r'X11 programming', 0, 1 ],
          ['xetc',    r'X11 configuration', 0, 1 ],
          ['xfont',   r'X11 fonts', 0, 1 ],
          ['xserver', r'X11 servers', 0, 1 ],
      ]],
      [ '_src', r'Source (and debug )?sets', 0, [
          ['syssrc', r'Kernel sources', 0, 1],
          ['src', r'Base sources', 0, 1],
          # The optionsal "es"? is because the source sets are
          # displayed in a pop-up box atop the main distribution
          # set list, and as of source date 2019.09.12.06.19.47,
          # the "es" in "Share sources" happens to land exactly
          # on top of an existing "es" from the word "Yes" in
          # the underlying window.
          # Curses, eager to to optimize, will reuse that
          # existing "es" instead of outputting it anew, causing
          # the pattern not to match if it includes the "es".
          ['sharesrc', r'Share sourc(es)?', 0, 1],
          ['gnusrc', r'GNU sources', 0, 1],
          ['xsrc', r'X11 sources', 0, 1],
          # The final "s" in "Debug symbols" can also fall victim
          # to curses optimization.
          ['debug', r'(debug sets)|(Debug symbols?)$', 0, 1],
          ['debug32', r'Debug symbols \(32-bit\)', 0, 1 ],
          ['xdebug', r'(debug X11 sets)|(X11 debug symbols)', 0, 1],
      ]]
    ])

    flat_sets = flatten_set_dict_list(sets)

    def __init__(self, sets = None):
        self.tempfiles = []
        if sets is not None:
            if not any([re.match(r'kern-', s) for s in sets]):
                raise RuntimeError("no kernel set specified")
            # Create a Python set containing the names of the NetBSD sets we
            # want for O(1) lookup.  Yes, the multiple meansings of the word
            # "set" here are confusing.
            sets_wanted = set(sets)
            for required in ['base', 'etc']:
                if not required in sets_wanted:
                    raise RuntimeError("the '%s' set is required", required)
            for s in self.flat_sets:
                s['install'] = (s['filename'] in sets_wanted)
                sets_wanted.discard(s['filename'])
            if len(sets_wanted):
                raise RuntimeError("no such set: " + sets_wanted.pop())

    def set_workdir(self, dir):
        self.workdir = dir
    # The directory where we mirror files needed for installation
    def download_local_mi_dir(self):
        return self.workdir + "/download/"
    def download_local_arch_dir(self):
        return self.download_local_mi_dir() + self.arch() + "/"
    # The path to the install sets ISO image, which
    # may or may not also be the install boot ISO
    def install_sets_iso_path(self):
        return os.path.join(self.workdir, self.install_sets_iso_name())
    # The path to the ISO used for booting an installed
    # macppc system (not to be confused with the installation
    # boot ISO)
    def runtime_boot_iso_path(self):
        return os.path.join(self.workdir, 'boot.iso')
    # The directory for the install floppy images
    def floppy_dir(self):
        return os.path.join(self.download_local_arch_dir(),
            "installation/floppy")
    def boot_iso_dir(self):
        return os.path.join(self.download_local_arch_dir(),
            "installation/cdrom")
    def boot_from_default(self):
        return arch_props[self.arch()].get('boot_from_default')

    def xen_boot_kernel(self, type):
        if type == 'pvh':
            return 'netbsd-GENERIC.gz'
        arch = self.arch()
        if arch == 'i386':
            return 'netbsd-XEN3PAE_DOMU.gz'
        elif arch == 'amd64':
            return 'netbsd-XEN3_DOMU.gz'
        else:
            return None

    def xen_install_kernel(self, type):
        if type == 'pvh':
            return 'netbsd-INSTALL.gz'
        arch = self.arch()
        if arch == 'i386':
            return 'netbsd-INSTALL_XEN3PAE_DOMU.gz'
        elif arch == 'amd64':
            return 'netbsd-INSTALL_XEN3_DOMU.gz'
        else:
            return None

    def xen_kernel(self, type, install):
        if install:
            return self.xen_install_kernel(type)
        else:
            return self.xen_boot_kernel(type)

    # The list of boot floppies we should try downloading;
    # not all may actually exist.  amd64 currently has five,
    # i386 has three, and older versions may have fewer.
    # Add a couple extra to accomodate future growth.
    def potential_floppies(self):
        return ['boot-com1.fs'] + ['boot%i.fs' % i for i in range(2, 8)]

    # The list of boot floppies we actually have
    def floppies(self):
        return [f for f in self.potential_floppies() \
            if os.path.exists(os.path.join(self.floppy_dir(), f))]

    # The list of boot ISOs we should try downloading
    def boot_isos(self):
        return ['boot-com.iso']

    def cleanup(self):
        for fn in self.tempfiles:
            try:
                os.unlink(fn)
            except:
                pass

    def set_path(self, setname, ext):
        if re.match(r'.*src$', setname):
            return ['source', 'sets', setname + ext]
        else:
            return [self.arch(), 'binary', 'sets', setname + ext]

    # Download this release
    # The ISO class overrides this to download the ISO only
    def download(self):
        # Optimization of file:// URLs is disabled for now; it doesn't
        # work for the source sets.
        #if hasattr(self, 'url') and self.url[:7] == 'file://':
        #    mkdir_p(os.path.join(self.workdir, 'download'))
        #    if not os.path.lexists(os.path.join(self.workdir, 'download', self.arch())):
        #        os.symlink(self.url[7:], os.path.join(self.workdir, 'download', self.arch()))
        #    return

        # Deal with architectures that we don't know how to install
        # using sysinst, but instead use a pre-installed image
        if 'image_name' in arch_props[self.arch()]:
            download_if_missing_3(self.dist_url(), self.download_local_arch_dir(), ["binary", "gzimg", arch_props[self.arch()]['image_name']])
            for file in arch_props[self.arch()]['kernel_name']:
                if download_if_missing_3(self.dist_url(), self.download_local_arch_dir(), ["binary", "kernel", file], True):
                    break
            # Nothing more to do as we aren't doing a full installation
            return

        if self.arch() in ['hpcmips', 'landisk', 'macppc', 'alpha']:
            download_if_missing_3(self.dist_url(), self.download_local_arch_dir(), ["binary", "kernel", "netbsd-GENERIC.gz"])

        # Download installation kernel if needed
        inst_kernel_prop = arch_props[self.arch()].get('inst_kernel')
        if inst_kernel_prop is not None:
            download_if_missing_3(self.dist_url(), self.download_local_arch_dir(),
                                  inst_kernel_prop.split(os.path.sep))

        i = 0
        # Depending on the NetBSD version, there may be two or more
        # boot floppies.  Treat any floppies past the first two as
        # optional files.
        for floppy in self.potential_floppies():
            download_if_missing_3(self.dist_url(),
                self.download_local_arch_dir(),
                ["installation", "floppy", floppy],
                True)
            i = i + 1

        for bootcd in (self.boot_isos()):
            download_if_missing_3(self.dist_url(),
                self.download_local_arch_dir(),
                ["installation", "cdrom", bootcd],
                True)

        # For netbooting/noemu
        if self.arch() in ['i386', 'amd64']:
            # Must be optional so that we can still install NetBSD 4.0
            # where it doesn't exist yet.
            download_if_missing_3(self.dist_url(),
                self.download_local_arch_dir(),
                ["installation", "misc", "pxeboot_ia32.bin"],
                True)
            download_if_missing_3(self.dist_url(),
                self.download_local_arch_dir(),
                ["binary", "kernel", "netbsd-INSTALL.gz"],
                True)

        for set in self.flat_sets:
            if set['install']:
                present = [
                    download_if_missing_3(self.mi_url(),
                                          self.download_local_mi_dir(),
                                          self.set_path(set['filename'],
                                                        ext),
                                          True)
                    for ext in set_exts
                ]
                if not set['optional'] and not any(present):
                    raise RuntimeError('install set %s does not exist with extension %s' %
                                       (set['filename'], ' nor '.join(set_exts)))

    # Create an ISO image
    def make_iso(self, image, dir):
        mkisofs = ["mkisofs", "-r", "-o"]

        if self.arch() == 'macppc':
            # Need to use mkisofs for HFS support
            makefs = ["mkisofs", "-r", "-hfs", "-part", "-l", "-J", "-N", "-o"]
        else:
            # Prefer native tools
            sysname = os.uname()[0]
            if sysname == 'NetBSD':
                makefs = ["/usr/sbin/makefs", "-t", "cd9660", "-o", "rockridge"]
            elif sysname[0] == 'FreeBSD':
                makefs = mkisofs
            elif sysname[0] == 'Darwin':
                makefs = ["hdiutil", "makehybrid", "-iso", "-joliet", "-o"]
            else:
                # Linux distributions differ.  Ubuntu has genisoimage
                # and mkisofs (as an alias of genisoimage); CentOS has
                # mkisofs only.  Debian 7 has genisoimage only.
                if os.path.isfile('/usr/bin/genisoimage'):
                    makefs = ["genisoimage", "-r", "-o"]
                else:
                    makefs = mkisofs
        # hdiutil will fail if the iso already exists, so remove it first.
        rm_f(image)
        spawn(makefs[0], makefs + [image, dir])

    # Create the install sets ISO image
    def make_install_sets_iso(self):
        self.download()
        if self.arch() == 'macppc':
            gunzip(os.path.join(self.download_local_arch_dir(), 'binary/kernel/netbsd-INSTALL.gz'),
                   os.path.join(self.download_local_mi_dir(), 'netbsd-INSTALL'))
        self.make_iso(self.install_sets_iso_path(),
            os.path.dirname(os.path.realpath(os.path.join(self.download_local_mi_dir(), self.arch()))))
        self.tempfiles.append(self.install_sets_iso_path())

    # Create the runtime boot ISO image (macppc only)
    def make_runtime_boot_iso(self):
        # The ISO will contain only the GENERIC kernel
        d = os.path.join(self.workdir, 'runtime_boot_iso')
        mkdir_p(d)
        gunzip(os.path.join(self.download_local_arch_dir(), 'binary/kernel/netbsd-GENERIC.gz'),
               os.path.join(d, 'netbsd-GENERIC'))
        self.make_iso(self.runtime_boot_iso_path(), d)
        # Do not add the ISO to self.tempfiles as it's needed after the install.

    # Get the architecture name.  This is a hardcoded default for use
    # by the obsolete subclasses; the "URL" class overrides it.
    def arch(self):
        return "i386"

    # Backwards compatibility with Anita 1.2 and older
    def install(self):
        Anita(dist = self).install()
    def boot(self):
        Anita(dist = self).boot()
    def interact(self):
        Anita(dist = self).interact()

# Subclass for versions where we pass in the version number explicitly
# Deprecated, use anita.URL instead

class NumberedVersion(Version):
    def __init__(self, ver, **kwargs):
        Version.__init__(self, **kwargs)
        self.ver = ver
    # The file name of the install ISO (sans directory)
    def install_sets_iso_name(self):
        if re.match(r"^[3-9]", self.ver) is not None:
            return "i386cd-" + self.ver + ".iso"
        else:
            return "i386cd.iso"
    # The directory for files related to this release
    def default_workdir(self):
        return "netbsd-" + self.ver

# An official NetBSD release
# Deprecated, use anita.URL instead

class Release(NumberedVersion):
    def __init__(self, ver, **kwargs):
        NumberedVersion.__init__(self, ver, **kwargs)
        pass
    def mi_url(self):
        major_ver = int(self.ver.split('.')[0])
        if major_ver >= 9:
            url = netbsd_mirror_url
        else:
            url = netbsd_archive_url
        return url + "NetBSD-" + self.ver + "/"
    def dist_url(self):
        return self.mi_url() + self.arch() + "/"

# The top-level URL of a release tree

class URL(Version):
    def __init__(self, url, **kwargs):
        Version.__init__(self, **kwargs)
        self.url = url
        scheme, netloc, path, query, fragment = good_old_urlparse.urlsplit(url)

        match = re.match(r'(^.*/)([^/]+)/$', path)
        if match is None:
            raise RuntimeError(("URL '%s' doesn't look like the URL of a " + \
            "NetBSD distribution") % url)
        self.url_mi_part = good_old_urlparse.urlunsplit((scheme, netloc, match.group(1), query, fragment))
        self.m_arch = match.group(2)
        check_arch_supported(self.m_arch, 'reltree')
    def dist_url(self):
        return self.url
    def mi_url(self):
        return self.url_mi_part
    def install_sets_iso_name(self):
        return "install_tmp.iso"
    def default_workdir(self):
        return url2dir(self.url)
    def arch(self):
        return self.m_arch

# A local release directory

class LocalDirectory(URL):
    def __init__(self, dir, **kwargs):
        # This could be optimized to avoid copying the files
        URL.__init__(self, "file://" + dir, **kwargs)

# An URL or local file name pointing at an ISO image

class ISO(Version):
    def __init__(self, iso_url, **kwargs):
        Version.__init__(self, **kwargs)
        if re.match(r'/', iso_url):
            self.m_iso_url = "file://" + iso_url
            self.m_iso_path = iso_url
        else:
            self.m_iso_url = iso_url
            self.m_iso_path = None
        # We can't determine the final ISO file name yet because the work
        # directory is not known at this point, but we can precalculate the
        # basename of it.
        self.m_iso_basename = os.path.basename(
            good_old_urllib.url2pathname(good_old_urlparse.urlparse(iso_url)[2]))
        m = re.match(r"(.*)cd.*iso|NetBSD-[0-9\._A-Z]+-(.*).iso", self.m_iso_basename)
        if m is None:
            raise RuntimeError("cannot guess architecture from ISO name '%s'"
                % self.m_iso_basename)
        arch = None
        if m.group(1) is not None:
            arch = m.group(1)
        if m.group(2) is not None:
            arch = m.group(2)
        if arch is None:
            raise RuntimeError("cannot guess architecture from ISO name '%s'"
                % self.m_iso_basename)
        arch = re.sub(r'-dvd$', '', arch)
        check_arch_supported(arch, 'iso')
        self.m_arch = arch
    def install_sets_iso_path(self):
        if self.m_iso_path is not None:
            return self.m_iso_path
        else:
            return os.path.join(self.download_local_arch_dir(),
                self.m_iso_basename)
    def default_workdir(self):
         return url2dir(self.m_iso_url)
    def make_install_sets_iso(self):
        self.download()
    def download(self):
        if self.m_iso_path is None:
            download_if_missing_2(self.m_iso_url, self.install_sets_iso_path())
        else:
            mkdir_p(self.workdir)
    def arch(self):
        return self.m_arch
    def boot_from_default(self):
        return 'cdrom-with-sets'

# Virtual constructior that accepts a release URL, ISO, or local path
# and constructs an URL, ISO, or LocalDirectory object as needed.

def distribution(distarg, **kwargs):
    # This accepts bare paths, too
    scheme, netloc, path, query, fragment = good_old_urlparse.urlsplit(distarg)
    if path.endswith('.iso'):
        # URL or path to ISO
        return ISO(distarg, **kwargs)
    elif distarg.startswith('/'):
        # Local directory
        if not distarg.endswith('/'):
            raise RuntimeError("distribution directory should end in a slash")
        return LocalDirectory(distarg, **kwargs)
    elif scheme:
        # URL but not ISO
        if not path.endswith('/'):
            raise RuntimeError("distribution URL path should end in a slash")
        return URL(distarg, **kwargs)
    else:
        raise RuntimeError("expected distribution URL or directory, got " + distarg)

#############################################################################

def vmm_is_xen(vmm):
    return vmm == 'xm' or vmm == 'xl'

# Log a message to the structured log file "fd".

def slog(fd, tag, data, timestamp = True):
    if timestamp:
        print("%s(%.3f, %s)" % (tag, time.time(), repr(data)), file=fd)
    else:
        print("%s(%s)" % (tag, repr(data)), file=fd)
    fd.flush()

def slog_info(fd, data):
    slog(fd, 'info', data)

# A file-like object that escapes unprintable data and prefixes each
# line with a tag, for logging I/O.

class Logger(object):
    def __init__(self, tag, fd):
        self.tag = tag
        self.fd = fd
    def write(self, data):
        slog(self.fd, self.tag, data)
    def __getattr__(self, name):
        return getattr(self.fd, name)

# Logger veneer that hides the data sent, for things like passwords and entropy

class CensorLogger(object):
    def __init__(self, fd):
        self.fd = fd
    def write(self, data):
        self.fd.write(b'*' * len(data))
    def __getattr__(self, name):
        return getattr(self.fd, name)

# http://stackoverflow.com/questions/616645/how-do-i-duplicate-sys-stdout-to-a-log-file-in-python
class multifile(object):
    def __init__(self, files):
        self._files = files
    def __getattr__(self, attr, *args):
        return self._wrap(attr, *args)
    def _wrap(self, attr, *args):
        def g(*a, **kw):
            for f in self._files:
                res = getattr(f, attr, *args)(*a, **kw)
            return res
        return g

class BytesWriter(object):
    def __init__(self, fd):
        self.fd = fd
    def write(self, data):
        self.fd.buffer.write(data)
    def __getattr__(self, name):
        return getattr(self.fd, name)

# Convert binary data to a hexadecimal string

if sys.version_info[0] >= 3:
    def bytes2hex(s):
        return s.hex()
else:
    def bytes2hex(s):
        return s.encode('hex')

class Anita(object):
    def __init__(self, dist, workdir = None, vmm = None, vmm_args = None,
        disk_size = None, memory_size = None, persist = False, boot_from = None,
        structured_log = None, structured_log_file = None, no_install = False,
        tests = 'atf', dtb = '', xen_type = 'pv', image_format = 'dense',
        machine = None, network_config = None, partitioning_scheme = None,
        no_entropy = False):
        self.dist = dist
        if workdir:
            self.workdir = workdir
        else:
            self.workdir = dist.default_workdir()

        self.structured_log = structured_log
        self.structured_log_file = structured_log_file

        out = sys.stdout
        null = open("/dev/null", "w")
        if sys.version_info[0] >= 3:
            out = BytesWriter(out)
            null = BytesWriter(null)

        if self.structured_log_file:
            self.structured_log_f = open(self.structured_log_file, "w")
            self.unstructured_log_f = out
        else:
            if self.structured_log:
                self.structured_log_f = sys.stdout
                self.unstructured_log_f = null
            else:
                self.structured_log_f = open("/dev/null", "w")
                self.unstructured_log_f = out

        # Set the default disk size if none was given.
        disk_size = disk_size or \
            arch_props[self.dist.arch()].get('disk_size') or \
            '2G'
        self.disk_size = disk_size

        # Set the default memory size if none was given.
        memory_size = memory_size or \
            arch_props[self.dist.arch()].get('memory_size') or \
            '32M'
        self.memory_size_bytes = parse_size(memory_size)

        self.persist = persist
        self.boot_from = boot_from
        self.no_install = no_install

        props = arch_props.get(dist.arch())
        if not props:
            raise RuntimeError("NetBSD port '%s' is not supported" %
                dist.arch())

        # Get name of qemu executable (if applicable)
        if 'qemu' in props:
            self.qemu = props['qemu']['executable']
            # Support old versions of qemu where qemu-system-i386 was
            # simply called qemu
            if self.qemu == 'qemu-system-i386' and \
               not try_program(['qemu-system-i386', '--version']) \
               and try_program(['qemu', '--version']): \
                   self.qemu = 'qemu'
        else:
            self.qemu = None

        # Choose a default vmm if none was explicitly requested
        if not vmm:
            if self.qemu:
                vmm = 'qemu'
            elif 'simh' in props:
                vmm = 'simh'
            elif 'gxemul' in props:
                vmm = 'gxemul'
            else:
                raise RuntimeError("%s has no default VMM" % self.dist.arch())

        # Backwards compatibility
        if vmm == 'xen':
            vmm = 'xm'

        self.vmm = vmm
        if vmm_args is None:
            vmm_args = []
        self.extra_vmm_args = vmm_args

        self.dtb = dtb
        self.xen_type = xen_type
        self.image_format = image_format
        self.machine = machine or self.get_arch_vmm_prop('machine_default')
        self.partitioning_scheme = partitioning_scheme
        self.no_entropy = no_entropy

        self.is_logged_in = False
        self.halted = False
        self.tests = tests

        # Number of CD-ROM devices
        self.n_cdrom = 0

        # Read netboot configuration file, if any
        self.net_config = {}
        if network_config:
            f = open(network_config, "r")
            for line in f:
                s = line.rstrip()
                if s == '':
                    continue
                if s[0] == '#':
                    continue
                l, r = s.split("=")
                self.net_config[l] = r
            f.close()

        self.child = None
        self.cleanup_child_func = None

    def __enter__(self):
        return self

    def __exit__(self, *stuff):
        self.slog("exit")
        self.cleanup_child()
        return False

    def cleanup(self):
        self.cleanup_child()

    def cleanup_child(self):
        if self.cleanup_child_func:
            self.cleanup_child_func()
            self.cleanup_child_func = None
        self.child = None

    # Get the name of the actual uncompressed kernel file, out of
    # potentially multiple alternative kernels.  Used with images.
    def actual_kernel(self):
        for kernel_name in self.get_arch_prop('kernel_name'):
            kernel_name_nogz = kernel_name[:-3]
            kernel_fn = os.path.join(self.workdir, kernel_name_nogz)
            if os.path.exists(kernel_fn):
                return kernel_fn
        raise RuntimeError("missing kernel")

    def arch_vmm_args(self):
        if self.dist.arch() == 'pmax':
            a = ["-e3max"]
        elif self.dist.arch() == 'landisk':
            a = ["-Elandisk"]
        elif self.dist.arch() == 'hpcmips':
            a = ["-emobilepro880"]
        elif self.dist.arch() == 'macppc':
            a = ["-M", self.machine, "-prom-env", "qemu_boot_hack=y"]
        elif self.dist.arch() == 'evbarm-earmv7hf':
            a = ['-M', self.machine]
            if self.machine == 'virt':
                a += [
                    '-append', 'root=ld4a',
                ]
            else:
                a += [
                    '-append', 'root=ld0a',
                    '-dtb', self.dtb
                ]
        elif self.dist.arch() == 'evbarm-aarch64':
            a = [
                '-M', self.machine,
                '-cpu', 'cortex-a57',
            ]
        elif self.dist.arch() == 'alpha':
            a = [ '-append', 'root=/dev/wd0a' ]
        elif self.dist.arch() == 'riscv-riscv64':
            a = [
                '-M', self.machine,
                '-append', 'root=dk1',
            ]
        else:
            a = []
        # When booting an image, we need to pass a kernel
        if self.get_arch_prop('image_name'):
            a += ['-kernel', self.actual_kernel()]
        return a

    def slog(self, message):
        slog_info(self.structured_log_f, message)

    # Wrapper around pexpect.spawn to let us log the command for
    # debugging.  Note that unlike os.spawnvp, args[0] is not
    # the name of the command.

    def pexpect_spawn(self, command, args):
        print(quote_shell_command([command] + args))
        child = pexpect_spawn_log(self.structured_log_f, command, args)
        print("child pid is %d" % child.pid)
        return child

    # The path to the NetBSD hard disk image
    def wd0_path(self):
        return os.path.join(self.workdir, "wd0.img")

    # Return the memory size rounded up to whole megabytes
    def memory_megs(self):
        megs = (self.memory_size_bytes + 2 ** 20 - 1) // 2 ** 20
        if megs != self.memory_size_bytes // 2 **20:
            print("warning: rounding up memory size of %i bytes to %i megabytes" \
                % (self.memory_size_bytes, megs), file=sys.stderr)
        return megs

    def configure_child(self, child):
        # Log reads from child
        child.logfile_read = multifile([self.unstructured_log_f, Logger('recv', self.structured_log_f)])
        # Log writes to child
        child.logfile_send = Logger('send', self.structured_log_f)
        child.timeout = 3600
        child.setecho(False)
        # Xen installs sometimes fail if we don't increase this
        # from the default of 0.1 seconds.  And powering down noemu
        # using iLO3 over ssh takes more than 5 seconds.
        child.delayafterclose = 30.0
        # Also increase this just in case
        child.delayafterterminate = 30.0
        # pexpect 4.3.1 needs this, too
        ptyproc = getattr(child, 'ptyproc')
        if ptyproc:
            ptyproc.delayafterclose = child.delayafterclose
            ptyproc.delayafterterminate = child.delayafterterminate
        self.halted = False
        self.child = child

    def start_simh(self, vmm_args = []):
        f = open(os.path.join(self.workdir, 'netbsd.ini'), 'w')
        f.write('set cpu ' + str(self.memory_megs()) + 'm\n' +
                'set rq0 ra92\n' +
                'set rq3 cdrom\n' +
                '\n'.join(vmm_args) + '\n' +
                'attach rq0 ' + self.wd0_path() + '\n' +
                'attach -r rq3 ' + self.dist.install_sets_iso_path() + '\n' +
                'boot cpu')
        f.close()
        if os.uname()[0] == 'NetBSD':
            simh = 'simh-vax'
        else:
            simh = 'vax'
        child = self.pexpect_spawn(simh, [os.path.join(self.workdir, 'netbsd.ini')])
        self.configure_child(child)
        return child

    def start_gxemul(self, vmm_args):
        child = self.pexpect_spawn('gxemul', ["-M", str(self.memory_megs()) + 'M',
         "-d", os.path.abspath(self.wd0_path())] + self.extra_vmm_args + self.arch_vmm_args() + vmm_args)
        self.configure_child(child)
        return child

    # Return true iff the disk image partitioning scheme is GPT
    def image_is_gpt(self):
        f = open(self.wd0_path(), 'rb')
        f.seek(512, 0)
        data = f.read(8)
        f.close()
        return data == b'EFI PART'

    def start_qemu(self, vmm_args, snapshot_system_disk):
        # Log the qemu version to stdout
        subprocess.call([self.qemu, '--version'])
        try:
            # Identify the exact qemu version in pkgsrc if applicable,
            # ignoring exceptions that may be raised if qemu was not
            # installed from pkgsrc.
            def f(label, command):
                output = subprocess.check_output(command).rstrip()
                print(label + ":", output.decode('ASCII', 'ignore'))
                sys.stdout.flush()
                return output
            qemu_path = f('qemu path', ['which', self.qemu])
            f('qemu package', ['pkg_info', '-Fe', qemu_path])
            f('glib2 package', ['pkg_info', '-e', 'glib2'])
        except:
            pass
        qemu_args = [
                "-m", str(self.memory_megs())
            ] + self.qemu_disk_args(self.wd0_path(), 0, True, snapshot_system_disk) + [
                "-nographic"
            ] + vmm_args + self.extra_vmm_args + self.arch_vmm_args()
        # Deal with virtio device ordering issues
        arch = self.dist.arch()
        if arch == 'evbarm-aarch64' or \
           arch == 'evbarm-earmv7hf' and self.machine == 'virt':
            print("reversing virtio devices")
            reverse_virtio_drives(qemu_args)
        else:
            #print("not reversing virtio devices")
            pass
        # Deal with evbarm-aarch64 using a different root device with
        # MBR vs GPT
        if arch == 'evbarm-aarch64':
            if self.image_is_gpt():
                rootdev = 'NAME=netbsd-root'
            else:
                rootdev = 'ld4a'
            qemu_args += [ '-append', 'root=' + rootdev ]

        # Start the actual qemu child process
        child = self.pexpect_spawn(self.qemu, qemu_args)
        self.configure_child(child)

        return child

    def xen_disk_arg(self, path, devno = 0, cdrom = False):
        writable = not cdrom
        if self.vmm == 'xm':
            dev = "0x%x" % devno
        else: # xl
            if self.xen_type == 'hvm':
                devtype = 'hd'
            else:
                devtype = 'xvd'
            dev = devtype + chr(ord('a') + devno)
        s = "disk=file:%s,%s,%s" % (path, dev, "rw"[writable])
        # Omit the ,cdrom part in the PV case because NetBSD/Xen ignores cdrom
        # devices since xenbus_probe.c 1.51.
        if cdrom and self.xen_type == 'hvm':
            s += ",cdrom"
        return s

    def qemu_disk_args(self, path, devno = 0, writable = True, snapshot = False):
        drive_attrs = [
            ('file', path),
            ('format', 'raw'),
            ('media', 'disk'),
            ('snapshot', ["off", "on"][snapshot])
        ]
        dev_args = []
        if self.dist.arch() == 'evbarm-earmv7hf' and self.machine == 'virt' or \
           self.dist.arch() == 'evbarm-aarch64' or \
           self.dist.arch() == 'riscv-riscv64':
            # Use virtio
            drive_attrs += [('if', 'none'), ('id', 'hd%d' % devno)]
            dev_args += ['-device', 'virtio-blk-device,drive=hd%d' % devno]
        elif self.dist.arch() == 'evbarm-earmv7hf':
            # Use SD card
            drive_attrs += [('if', 'sd')]
        else:
            pass
        return ["-drive", qemu_format_attrs(drive_attrs)] + dev_args

    def qemu_add_cdrom(self, path, extra_attrs = None):
        if extra_attrs is None:
            extra_attrs = []
        drive_attrs = [
            ('file', path),
            ('format', 'raw'),
            ('media', 'cdrom'),
            ('readonly', 'on'),
        ]
        if self.dist.arch() in ('macppc', 'sparc64'):
            assert(self.n_cdrom == 0)
            drive_attrs += [('index', '2')]
        drive_attrs += extra_attrs
        argv = ["-drive", qemu_format_attrs(drive_attrs)]
        dev = 'cd%da' % self.n_cdrom
        self.n_cdrom += 1
        return argv, dev

    def gxemul_cdrom_args(self):
        return ('', 'd:')[self.dist.arch() == 'landisk'] + self.dist.install_sets_iso_path()
    def gxemul_disk_args(self, path):
        return ["-d", path]

    def xen_string_arg(self, name, value):
        if self.vmm == 'xm':
            return '%s=%s' % (name, value)
        else: # xl
            return '%s="%s"' % (name, value)

    def xen_args(self, install):
        if self.xen_type == 'pv':
            k = self.dist.xen_kernel('pv', install)
            return [self.xen_string_arg('kernel',
                os.path.abspath(os.path.join(self.dist.download_local_arch_dir(),
                                "binary", "kernel", k)))]
        if self.xen_type == 'pvshim':
            k = self.dist.xen_kernel('pv', install)
            return [self.xen_string_arg('kernel',
                os.path.abspath(os.path.join(self.dist.download_local_arch_dir(),
                                "binary", "kernel", k))),
                self.xen_string_arg('type', 'pvh'),
                'pvshim=1'
	    ]
        elif self.xen_type == 'pvh':
            k = self.dist.xen_kernel('pvh', install)
            return [self.xen_string_arg('kernel',
                os.path.abspath(os.path.join(self.dist.download_local_arch_dir(),
                            "binary", "kernel", k))),
                self.xen_string_arg('type', 'pvh'),
            ]
        elif self.xen_type == 'hvm':
            return  [
                self.xen_string_arg('type', 'hvm'),
                self.xen_string_arg('serial', 'pty'),
            ]
        else:
            raise RuntimeError('unknown xen type %s' % self.xen_type)

    def start_xen_domu(self, vmm_args):
        frontend = self.vmm
        name = "anita-%i" % os.getpid()
        args = [
            frontend,
            "create",
            "-c",
            "/dev/null",
            self.xen_disk_arg(os.path.abspath(self.wd0_path()), 0),
            "memory=" + str(self.memory_megs()),
            self.xen_string_arg('name', name)
        ] + vmm_args + self.extra_vmm_args + self.arch_vmm_args()

        # Multiple "disk=" arguments are no longer supported with xl;
        # combine them
        if self.vmm == 'xl':
            disk_args = []
            no_disk_args = []
            for arg in args:
                if arg.startswith('disk='):
                    disk_args.append(arg[5:])
                else:
                    no_disk_args.append(arg)
            args = no_disk_args + [ "disk=[%s]" % (','.join(["'%s'" % arg for arg in disk_args]))]

        child = self.pexpect_spawn(args[0], args[1:])
        self.configure_child(child)

        def cleanup_domu():
            spawn(self.vmm, [self.vmm, "destroy", name])
        self.cleanup_child_func = cleanup_domu

        return child

    def start_noemu(self, vmm_args):
        noemu_always_args = [
            '--workdir', self.workdir,
            '--releasedir', os.path.join(self.workdir, 'download'),
            '--arch', self.dist.arch()
        ]
        child = self.pexpect_spawn('sudo', ['noemu'] +
            noemu_always_args + vmm_args + self.extra_vmm_args + self.arch_vmm_args())
        self.configure_child(child)
        return child

    def get_arch_prop(self, key):
        return arch_props[self.dist.arch()].get(key)

    def get_arch_vmm_prop(self, key):
        vmm_props = arch_props[self.dist.arch()].get(self.vmm)
        if vmm_props is None:
            return None
        return vmm_props.get(key)

    def provide_entropy(self, child):
        if self.no_entropy:
            child.expect(r'([a-z]): Not now')
            child.send(child.match.group(1) + b"\n")
            return

        while True:
            # It would be good to match the "1:" prompt to detect
            # multi-line mode, but there's an ANSI control sequence
            # between the "1" and the ":".
            r = child.expect([r'([a-z]): Manual(ly)? input',
                              r'Terminate (the )?input with an empty line.|'
                                  r'Supply input to be used as a random seed',
                              r'(single)|(one) line'])
            if r == 0:
                child.send(child.match.group(1) + b"\n")
            else:
                break
        multiline = (r == 1)
        nbytes = 32 # 256 bits
        f = open("/dev/random", "rb")
        data = f.read(nbytes)
        f.close()
        assert(len(data) == nbytes)
        text = bytes2hex(data)
        # Temporarily disable logging of data to keep the seed secret
        old_logfile_send = child.logfile_send
        old_logfile_read = child.logfile_read
        try:
            child.logfile_send = CensorLogger(old_logfile_send)
            child.logfile_read = CensorLogger(old_logfile_read)
            child.send(text)
            gather_input(child, 1)
        finally:
            child.logfile_send = old_logfile_send
            child.logfile_read = old_logfile_read
        child.send('\n')
        if multiline:
            child.send('\n')

    # For vax
    def set_date(self, child):
        now = time.gmtime()
        for letter, format in (
            (b"a", "%Y"),
            (b"b", "%m"),
            (b"c", "%d"),
            (b"d", "%H"),
            (b"e", "%M"),
        ):
            child.send(letter + b"\n")
            child.send(time.strftime(format, now).encode('ASCII') + b"\n")
        child.send(b"f\n")

    def _install(self):
        # Download or build the install ISO
        self.dist.set_workdir(self.workdir)
        if self.get_arch_prop('image_name'):
            self.dist.download()
        else:
            self.dist.make_install_sets_iso()
        # Build the runtime boot ISO if needed
        if self.dist.arch() == 'macppc':
            self.dist.make_runtime_boot_iso()
        if self.vmm != 'noemu':
            print("Creating hard disk image...", end=' ')
            sys.stdout.flush()
            make_image(self.wd0_path(), parse_size(self.disk_size),
                       self.image_format)
            print("done.")
            sys.stdout.flush()
        if self.get_arch_prop('image_name'):
            self._install_from_image()
        else:
            self._install_using_sysinst()

    def _install_from_image(self):
        image_name = self.get_arch_prop('image_name')
        gzimage_fn = os.path.join(self.workdir,
            'download', self.dist.arch(),
            'binary', 'gzimg', image_name)
        print("Decompressing image...", end=' ')
        gzimage = open(gzimage_fn, 'r')
        subprocess.call('gunzip | dd of=' + self.wd0_path() + ' conv=notrunc',
                        shell = True, stdin = gzimage)
        gzimage.close()
        print("done.")
        # Unzip the kernel, whatever its name
        for kernel_name in self.get_arch_prop('kernel_name'):
            gzkernel_fn = os.path.join(self.workdir,
                'download', self.dist.arch(), 'binary', 'kernel', kernel_name)
            if not os.path.exists(gzkernel_fn):
                continue
            kernel_name_nogz = kernel_name[:-3]
            kernel_fn = os.path.join(self.workdir, kernel_name_nogz);
            gunzip(gzkernel_fn, kernel_fn)

        # Boot the system to let it resize the image.
        self.start_boot(install = False, snapshot_system_disk = False)
        # The system will resize the image and then reboot.
        # Wait for the login prompt and shut down cleanly.
        self.child.expect(r"login:")
        self.halt()

    def _install_using_sysinst(self):
        # The name of the CD-ROM device holding the sets
        sets_cd_device = None

        arch = self.dist.arch()

        if vmm_is_xen(self.vmm):
            if self.xen_type == 'pv' or self.xen_type == 'pvshim' or self.xen_type == 'pvh':
                # Download XEN kernels
                xenkernels = [k for k in [
                    self.dist.xen_boot_kernel(type = self.xen_type),
                    self.dist.xen_install_kernel(type = self.xen_type)] if k]
                for kernel in xenkernels:
                    download_if_missing_3(self.dist.dist_url(),
                            self.dist.download_local_arch_dir(),
                            ["binary", "kernel", kernel],
                            True)
            vmm_args = []
            vmm_args += self.xen_args(install = True)
            if self.xen_type == 'pv' or self.xen_type == 'pvshim' or self.xen_type == 'pvh':
                vmm_args += [self.xen_disk_arg(os.path.abspath(
                    self.dist.install_sets_iso_path()), 1, cdrom = True)]
                sets_cd_device = 'xbd1d'
            elif self.xen_type == 'hvm':
                # Similar the qemu boot_from == 'cdrom' case below
                boot_cd_path = os.path.join(self.dist.boot_iso_dir(),
                                            self.dist.boot_isos()[0])
                vmm_args += [self.xen_disk_arg(os.path.abspath(
                    boot_cd_path), 2, cdrom = True)]
                vmm_args += [self.xen_disk_arg(os.path.abspath(
                    self.dist.install_sets_iso_path()), 3, cdrom = True)]
                sets_cd_device = 'cd1a'
            else:
                raise RuntimeError('unknown xen type %s' % self.xen_type)
            child = self.start_xen_domu(vmm_args)
        elif self.vmm == 'qemu':
            # Determine what kind of media to boot from.
            floppy_paths = [ os.path.join(self.dist.floppy_dir(), f) \
                for f in self.dist.floppies() ]
            if self.boot_from is None:
                self.boot_from = self.dist.boot_from_default()
            if self.boot_from is None:
                self.boot_from = 'cdrom'

            sets_cd_device = None

            # Set up VM arguments based on the chosen boot media
            if self.boot_from == 'cdrom':
                if self.dist.arch() in ['macppc']:
                    # Boot from the CD we just built, with the sets.
                    # The drive must have index 2.
                    cd_path = self.dist.install_sets_iso_path()
                    vmm_args, sets_cd_device = self.qemu_add_cdrom(cd_path)
                    vmm_args += [ "-prom-env", "boot-device=cd:,netbsd-INSTALL" ]
                else:
                    # Boot from a downloaded boot CD w/o sets
                    cd_path = os.path.join(self.dist.boot_iso_dir(), self.dist.boot_isos()[0])
                    vmm_args, dummy = self.qemu_add_cdrom(cd_path)
                vmm_args += ["-boot", "d"]
            elif self.boot_from == 'floppy':
                if len(floppy_paths) == 0:
                    raise RuntimeError("found no boot floppies")
                vmm_args = ["-drive", "file=%s,format=raw,if=floppy,readonly=on"
                            % floppy_paths[0]]
                vmm_args += ["-boot", "a"]
            elif self.boot_from == 'cdrom-with-sets':
                # Single CD
                vmm_args = ["-boot", "d"]
            elif self.boot_from == 'net':
                # This is incomplete.  It gets as far as running
                # pxeboot, but pxeboot is unable to load the kernel
                # because it defaults to loading the kernel over NFS,
                # and we support only TFTP.  To specify "tftp:netbsd",
                # we would need a way to respond with different bootfile
                # DHCP options at the PXE ROM and pxeboot stages, but
                # the built-in BOOTP/DHCP server in qemu has no way to
                # do that.  A pxeboot patched to load "tftp:netbsd"
                # instead of "netbsd" does successfully load the kernel.

                # Note that although the kernel is netbooted, the sets
                # are still read from a CD (unlike the noemu case).

                tftpdir = os.path.join(self.workdir, 'tftp')
                mkdir_p(tftpdir)

                # Configure pxeboot for a serial console
                # On a non-NetBSD host, you need to cross-build installboot and
                # install it in the PATH as nbinstalboot
                # XXX dup wrt noemu
                pxeboot_com_fn = 'pxeboot_ia32_com.bin'
                pxeboot_com_path = os.path.join(tftpdir, pxeboot_com_fn)
                shutil.copyfile(os.path.join(self.dist.download_local_arch_dir(),
                                             'installation/misc/pxeboot_ia32.bin'),
                                pxeboot_com_path)

                if os.uname()[0] == 'NetBSD':
                    installboot = '/usr/sbin/installboot'
                else:
                    installboot = 'nbinstallboot'
                subprocess.check_call([installboot, '-e',
                                       '-m', self.dist.arch(),
                                       '-o', 'console=com0', pxeboot_com_path])

                inst_kernel = os.path.join(tftpdir, 'netbsd')
                # Use the INSTALL kernel
                # Unzip the install kernel into the tftp directory
                zipped_kernel = os.path.join(self.dist.download_local_arch_dir(),
                                             'binary/kernel/netbsd-INSTALL.gz')
                gunzip(zipped_kernel, inst_kernel)

                vmm_args = ['-boot', 'n',
                            '-nic',
                            'user,' +
                            qemu_format_attrs([('id', 'um0'),
                                               ('tftp', tftpdir),
                                               ('bootfile', pxeboot_com_fn)])]
            elif self.boot_from == 'kernel':
                # alpha
                cd_path = self.dist.install_sets_iso_path()
                vmm_args, sets_cd_device = self.qemu_add_cdrom(cd_path)
                # Uncompress the installation kernel
                inst_kernel = os.path.join(self.workdir, 'netbsd_install')
                gunzip(os.path.join(self.dist.download_local_arch_dir(),
                                    *arch_props[self.dist.arch()]['inst_kernel'].split(os.path.sep)),
                       inst_kernel)
                vmm_args += ['-kernel', inst_kernel]
            else:
                raise RuntimeError("unsupported boot-from value %s" % self.boot_from)

            # If we don't have a CD with sets already, use the next
            # available CD drive
            if not sets_cd_device:
                sets_cd_args, sets_cd_device = self.qemu_add_cdrom(self.dist.install_sets_iso_path())
                vmm_args += sets_cd_args
            child = self.start_qemu(vmm_args, snapshot_system_disk = False)
        elif self.vmm == 'noemu':
            child = self.start_noemu(['--boot-from', 'net'])
            if self.dist.arch() in ('i386', 'amd64'):
                child.expect(r'(PXE [Bb]oot)|(BIOS [Bb]oot)')
                if child.match.group(2):
                    raise RuntimeError("got BIOS bootloader instead of PXE")
            # For 'evbmips-mips64eb', look for r'BOOTP broadcast' instead?
        elif self.vmm == 'gxemul':
            sets_cd_device = 'cd0a'
            if self.dist.arch() == 'hpcmips':
                sets_cd_device = 'cd0d'
            elif self.dist.arch() == 'landisk':
                sets_cd_device = 'wd1a'
            vmm_args = ["-d", self.gxemul_cdrom_args()]
            if self.dist.arch() in ['pmax', 'landisk']:
                vmm_args += [os.path.abspath(os.path.join(self.dist.download_local_arch_dir(),
                 "binary", "kernel", "netbsd-INSTALL.gz"))]
            elif self.dist.arch() == 'hpcmips':
                vmm_args += [os.path.abspath(os.path.join(self.dist.download_local_arch_dir(),
                 "installation", "netbsd.gz"))]
            child = self.start_gxemul(vmm_args)
        elif self.vmm == 'simh':
            sets_cd_device = 'cd0a'
            child = self.start_simh()
            child.expect(r">>>")
            child.send("boot dua3\r\n")
        else:
            raise RuntimeError('unknown vmm %s' % self.vmm)

        term = None
        if self.dist.arch() in ['hpcmips', 'landisk', 'hppa']:
            term = 'vt100'

        # Do the floppy swapping dance and other pre-sysinst interaction
        floppy0_name = None
        while True:
            # NetBSD/i386 will prompt for a terminal type if booted from a
            # CD-ROM, but not when booted from floppies.  Sigh.
            r = child.expect([
                # 0 (was Group 1-2)
                r"insert disk (\d+), and press return...",
                # 1 (was Group 3)
                # Match either the English or the German text.
                # This is a kludge to deal with kernel messages
                # like "ciss0: normal state on 'ciss0:1'" that
                # sometimes appear in the middle of one or the
                # other, but are unlikely to appear in the middle of
                # both.  The installation is done in English no
                # matter which one we happen to match.
                r"Installation messages in English|Installation auf Deutsch",
                # 2 (was Group 4)
                r"Terminal type",
                # 3 (was Group 5)
                r"Installation medium to load the additional utilities from: ",
                # 4 (was Group 6)
                r"1. Install NetBSD",
                # 5 (was Group 7)
                r"\(I\)nstall, \(S\)hell or \(H\)alt",
                # 6 Erlite3 bootloader
                r'UBNT_E100',
            ])
            if r == 0:
                # We got the "insert disk" prompt
                # There is no floppy 0, hence the "- 1"
                floppy_index = int(child.match.group(1)) - 1

                # Escape into qemu command mode to switch floppies
                child.send("\001c")
                # We used to wait for a (qemu) prompt here, but qemu 0.9.1
                # no longer prints it
                # child.expect(r'\(qemu\)')
                if not floppy0_name:
                    # Between qemu 0.9.0 and 0.9.1, the name of the floppy
                    # device accepted by the "change" command changed from
                    # "fda" to "floppy0" without any provision for backwards
                    # compatibility.  Deal with it.  Also deal with the fact
                    # that as of qemu 0.15, "info block" no longer prints
                    # "type=floppy" for floppy drives.  And in qemu 2.5.0,
                    # the format changed again from "floppy0: " to
                    # "floppy0 (#block544): ", so we no longer match the
                    # colon and space.
                    child.send("info block\n")
                    child.expect(r'\n(fda|floppy0)')
                    floppy0_name = child.match.group(1)
                # Now we can change the floppy
                child.send(b"change " + floppy0_name + b" " +
                           floppy_paths[floppy_index].encode('ASCII') + b"\n")
                # Exit qemu command mode
                child.send("\001c\n")
            elif r == 1:
                # "Installation messages in English"
                break
            elif r == 2:
                # "Terminal type"
                child.send("xterm\n")
                term = "xterm"
            elif r == 3:
                # "Installation medium to load the additional utilities from"
                # (SPARC)
                child.send("cdrom\n")
                child.expect(r"CD-ROM device to use")
                child.send("\n")
                child.expect(r"Path to instfs.tgz")
                child.send("\n")
                child.expect(r"Terminal type")
                # The default is "sun", but anita is more likely to run
                # in an xterm or some other ansi-like terminal than on
                # a sun console.
                child.send("xterm\n")
                term = "xterm"
                child.expect(r"nstall/Upgrade")
                child.send("I\n")
            elif r == 4:
                # "1. Install NetBSD"
                child.send("1\n")
            elif r == 5:
                # "(I)nstall, (S)hell or (H)alt ?"
                child.send("i\n")
            elif r == 6:
                child.send('\003') # control-c
                child.expect('Octeon ubnt_e100#')
                child.send('dhcp;tftp $loadaddr erlite.elf32;bootoctlinux\r')
        if self.vmm == 'noemu':
            self.slog("wait for envsys to settle down")
            time.sleep(30)

        # Confirm "Installation messages in English"
        child.send("\n")

        # i386 and amd64 ask for keyboard type here; sparc doesn't.
        # vax may ask for the date.
        while True:
            r = child.expect([
                r"Keyboard type",
                r"a: Install NetBSD to hard disk",
                r"Shall we continue",
                r"Please .* date and time",
            ])
            if r == 0 or r == 1:
                # Keyboard type or Install NetBSD
                child.send("\n")
            elif r == 2:
                # Shall we continue
                child.expect(r"([a-z]): Yes")
                child.send(child.match.group(1) + b"\n")
                break
            elif r == 3:
                # date and time
                self.set_date(child)
            else:
                raise AssertionError

        # We may or may not get an entropy prompt here.  Then,
        # dpending on the number of disks attached, we get either
        # "found only one disk" followed by "Hit enter to continue",
        # or "On which disk do you want to install".

        while True:
            r = child.expect([r'not enough entropy|if a small random seed',
                              r'Hit enter to continue',
                              r'On which disk do you want to install'])
            if r == 0:
                self.provide_entropy(child)
            elif r == 1:
                child.send("\n")
                break
            elif r == 2:
                child.send("a\n")
                break
            else:
                raise AssertionError

        def choose_no():
            child.expect(r"([a-z]): No")
            child.send(child.match.group(1) + b"\n")
        def choose_yes():
            child.expect(r"([a-z]): Yes")
            child.send(child.match.group(1) + b"\n")

        # Keep track of sets we have already handled, by label.
        # This is needed so that parsing a pop-up submenu is not
        # confused by earlier output echoing past choices.
        labels_seen = set()

        def choose_sets(set_list, level = 0):
            sets_this_screen = []
            # First parse the set selection screen or popup; it's messy.
            while True:
                # Match a letter-label pair, like "h: Compiler Tools",
                # followed by an installation status of Yes, No, All,
                # or None.  The label can be separated from the "Yes/No"
                # field either by spaces (at least two, so that there can
                # be single spaces within the label), or by a cursor
                # positioning escape sequence.  The escape sequence may
                # be preceded by zero or more spaces.  Apparently this
                # variety arises from the fact that the submenus are drawn
                # on top of the existing text of the main menu without
                # clearing the screen inbetween, so that the preexisting
                # screen content between the label and the "Yes/No" may
                # or may not consist of spaces that curses can reuse.
                #
                # Alternatively, match the special letter "x: " which
                # is not followed by an installation status.
                child.expect(
                    r"(?:([a-z]): ([^ \x1b]+(?: [^ \x1b]+)*)(?:(?:\s\s+)|(?:\s*\x1b\[\d+;\d+H\x00*))(Yes|No|All|None))|(x: )")
                (letter, label, yesno, exit) = child.match.groups()
                if exit:
                    if len(sets_this_screen) != 0:
                        break
                else:
                    #self.slog(label)
                    for set in set_list:
                        if re.match(set[r'label'], label) and label not in labels_seen:
                            sets_this_screen.append({
                                'set': set,
                                'letter': letter,
                                'state': yesno
                            })
                            labels_seen.add(label)

            # Then make the actual selections
            for item in sets_this_screen:
                set = item['set']
                enable = set['install']
                state = item['state']
                group = set.get('group')
                if (enable and state == b"No" or \
                       not enable and state == b"Yes") \
                       or group:
                    child.send(item['letter'] + b"\n")
                if group:
                    # Recurse to handle sub-menu
                    choose_sets(group, level + 1)

            # Exit the set selection menu
            child.send("x\n")

        # Older NetBSD versions show a prompt like [re0] and ask you
        # to type in the interface name (or enter for the default);
        # newer versions show a menu.

        def choose_interface_oldstyle():
            self.slog('old-style interface list')
            # Choose the first non-fwip interface
            while True:
                child.expect(r"([a-z]+)([0-9]) ")
                ifname = child.match.group(1)
                ifno = child.match.group(2)
                self.slog('old-style interface: <%s,%s>' % (repr(ifname), repr(ifno)))
                if ifname != 'fwip':
                    # Found an acceptable interface
                    child.send(ifname + ifno + b"\n")
                    break

        def choose_interface_newstyle():
            self.slog('new-style interface list')
            child.expect(r'Available interfaces')
            # Choose the first non-fwip interface
            while True:
                # Make sure to match the digit after the interface
                # name so that we don't accept a partial interface
                # name like "fw" from "fwip0".
                child.expect(r"([a-z]): ([a-z]+)[0-9]")
                if child.match.group(2) != 'fwip':
                    # Found an acceptable interface
                    child.send(child.match.group(1) + b"\n")
                    break

        def configure_network():
            def choose_dns_server():
                child.expect(r"([a-z]): other")
                child.send(child.match.group(1) + b"\n")
                child.send((self.net_config.get('dnsserveraddr') or "10.0.1.1") + "\n")

            expect_any(child,
                r"Network media type", "\n",
                r"Perform (DHCP )?autoconfiguration", choose_no,
                r"Hit enter to continue", "\n",
                r"Your host name",
                       "anita-test\n",
                r"Your DNS domain",
                       "netbsd.org\n",
                r"Your IPv4 (number)|(address)",
                       (self.net_config.get('client_addr') or "10.169.0.2") + "\n",
                r"IPv4 Netmask",
                       (self.net_config.get('netmask') or "255.255.255.0") + "\n",
                r"IPv4 gateway",
                       (self.net_config.get('gateway_addr') or "10.169.0.1") + "\n",
                r"IPv4 name server",
                       (self.net_config.get('dnsserveraddr') or "10.0.1.1") + "\n",
                r"Perform IPv6 autoconfiguration", choose_no,
                r"Select (IPv6 )?DNS server", choose_dns_server,
                r"Are they OK", choose_yes)
            self.network_configured = True

        def choose_install_media():
            # Noemu installs from HTTP, otherwise we use the CD-ROM
            media = ['CD-ROM', 'HTTP'][self.vmm == 'noemu']
            child.expect(r'([a-h]): ' + media)
            child.send(child.match.group(1) + b"\n")

        self.network_configured = False

        # Many different things can happen at this point:
        #
        # Versions older than 2009/08/23 21:16:17 will display a menu
        # for choosing the extraction verbosity
        #
        # Versions older than 2010/03/30 20:09:25 will display a menu for
        # choosing the CD-ROM device (newer versions will choose automatically)
        #
        # Versions older than Fri Apr 6 23:48:53 2012 UTC will ask
        # you to "Please choose the timezone", wheras newer ones will
        # instead as you to "Configure the additional items".
        #
        # At various points, we may or may not get "Hit enter to continue"
        # prompts (and some of them seem to appear nondeterministically)
        #
        # i386/amd64 can ask whether to use normal or serial console bootblocks
        #
        # Try to deal with all of the possible options.
        #
        # We specify a longer timeout than the default here, because the
        # set extraction can take a long time on slower machines.
        #
        # It has happened (at least with NetBSD 3.0.1) that sysinst paints the
        # screen twice.  This can cause problem because we will then respond
        # twice, and the second response will be interpreted as a response to
        # a subsequent prompt.  Therefore, we check whether the match is the
        # same as the previous one and ignore it if so.
        #
        # OTOH, -current as of 2009.08.23.20.57.40 will issue the message "Hit
        # enter to continue" twice in a row, first as a result of MAKEDEV
        # printing a warning messages "MAKEDEV: dri0: unknown device", and
        # then after "sysinst will give you the opportunity to configure
        # some essential things first".  We match the latter text separately
        # so that the "Hit enter to continue" matches are not consecutive.
        #
        # The changes of Apr 6 2012 broght with them a new redraw problem,
        # which is worked around using the seen_essential_things variable.
        #
        prevmatch = []
        seen_essential_things = 0
        loop = 0
        while True:
            loop = loop + 1
            if loop == 100:
                raise RuntimeError("loop detected")
            r = child.expect([
                # 0 (unused, never matches)
                r"(?!)",
                # 1
                r"a: Progress bar",
                # 2
                r"Select medium|Install from",
                # 3
                r"Enter the CDROM device",
                # 4
                r"unused-group-should-not-match",
                # 5
                r"Hit enter to continue",
                # 6
                r"b: Use serial port com0",
                # 7
                r"Please choose the timezone",
                # 8
                r"essential things",
                # 9
                r"Configure the additional items",
                # 10
                r"Multiple CDs found",
                # 11
                r"The following are the http site",
                # 12
                r"Is the network information you entered accurate",
                # 13 (old-style)
                r"I have found the following network interface",
                # 14 (new-style)
                r"Which network device would you like to use",
                # 15
                r"No allows you to continue anyway",
                # 16
                r"Can't connect to",
                # 17
                r"/sbin/newfs",
                # 18
                r"Do you want to install the NetBSD bootcode",
                # 19
                r"Do you want to update the bootcode in the Master Boot Record to the latest",
                # 20
                r"([a-z]): Custom installation",
                # 21 (unused, never matches)
                r"(?!)",
                # 22
                r"a: This is the correct geometry",
                # 23
                r"a: Use one of these disks",
                # 24
                r"([a-z]): Set sizes of NetBSD partitions",
                # 25 (unused, never matches)
                r"(?!)",
                # 26
                r"a partitioning scheme",
                # 27
                r"([a-z]): Use the entire disk",
                # 28 (unused, never matches)
                r"(?!)",
                # 29
                r'Do you want to install the NetBSD bootcode',
                # 30
                r'Do you want to update the bootcode',
                # 31
                r"Please enter a name for your NetBSD disk",
                # 32
                # Matching "This is your last chance" will not work
                r"ready to install NetBSD on your hard disk",
                # 33
                r"We now have your (?:BSD.|GPT.)?(?:disklabel )?partitions",
                # 34 (formerly 28)
                r'Your disk currently has a non-NetBSD partition',
                # 35 (formerly 25)
                r"Sysinst could not automatically determine the BIOS geometry of the disk",
                # 36
                r"Do you want to re-edit the disklabel partitions",
                # 37 (to reset timeout while set extraction is making progress)
                r'Command: ',
                # 38
                r'not enough entropy',
                # 39
                r'Changing local password for root',
                # 40
                r'(Accept partition sizes)|(Go on)',
                ], 10800)

            if child.match.group(0) == prevmatch:
                self.slog('ignoring repeat match')
                continue
            prevmatch = child.match.group(0)
            if r == 0:
                 raise AssertionError
            elif r == 1:
                # (a: Progress bar)
                child.send("\n")
            elif r == 2:
                # (Install from)
                choose_install_media()
            elif r == 3:
                # "(Enter the CDROM device)"
                if sets_cd_device != 'cd0a':
                    child.send(b"a\n" + sets_cd_device.encode('ASCII') + b"\n")
                # In 3.0.1, you type "c" to continue, whereas in -current,
                # you type "x".  Handle both cases.
                child.expect(r"([cx]): Continue")
                child.send(child.match.group(1) + b"\n")
            elif r == 5:
                # (Hit enter to continue)
                if seen_essential_things >= 2:
                    # This must be a redraw
                    pass
                else:
                    child.send("\n")
            elif r == 6:
                # (b: Use serial port com0)
                child.send("bx\n")
            elif r == 7:
                # (Please choose the timezone)
                # "Press 'x' followed by RETURN to quit the timezone selection"
                child.send("x\n")
                # The strange non-deterministic "Hit enter to continue" prompt has
                # also been spotted after executing the sed commands to set the
                # root password cipher, with 2010.10.27.10.42.12 source.
                while True:
                    child.expect(r"(([a-z]): DES)|(root password)|(Hit enter to continue)")
                    if child.match.group(1):
                        # DES
                        child.send(child.match.group(2) + b"\n")
                    elif child.match.group(3):
                        # root password
                        break
                    elif child.match.group(4):
                        # (Hit enter to continue)
                        child.send("\n")
                    else:
                        raise AssertionError
                # Don't set a root password
                child.expect(r"b: No")
                child.send("b\n")
                child.expect(r"a: /bin/sh")
                child.send("\n")

                # "The installation of NetBSD-3.1 is now complete.  The system
                # should boot from hard disk.  Follow the instructions in the
                # INSTALL document about final configuration of your system.
                # The afterboot(8) manpage is another recommended reading; it
                # contains a list of things to be checked after the first
                # complete boot."
                #
                # We are supposed to get a single "Hit enter to continue"
                # prompt here, but sometimes we get a weird spurious one
                # after running chpass above.

                while True:
                    child.expect(r"(Hit enter to continue)|(x: Exit)")
                    if child.match.group(1):
                        child.send("\n")
                    elif child.match.group(2):
                        child.send("x\n")
                        break
                    else:
                        raise AssertionError
                break
            elif r == 8:
                # (essential things)
                seen_essential_things += 1
            elif r == 9:
                # (Configure the additional items)
                child.expect(r"x: Finished configuring")
                child.send("x\n")
                break
            elif r == 10:
                # (Multiple CDs found)
                # This happens if we have a boot CD and a CD with sets;
                # we need to choose the latter.
                child.send("b\n")
            elif r == 11:
                gather_input(child, 1)
                # (The following are the http site)
                # \027 is control-w, which clears the field
                child.send("a\n") # IP address
                child.send("\027" +
                       (self.net_config.get('serveraddr') or "10.169.0.1") + "\n")
                child.send("b\n\027\n") # Directory = empty string
                if not self.network_configured:
                    child.send("j\n") # Configure network
                    choose_interface_newstyle()
                    configure_network()
                # We get 'Hit enter to continue' if this sysinst
                # version tries ping6 even if we have not configured
                # IPv6
                expect_any(child,
                    r'Hit enter to continue', '\r',
                    r'x: Get Distribution', 'x\n')
                r = child.expect([r"Install from", r"/usr/bin/ftp"])
                if r == 0:
                    # ...and I'm back at the "Install from" menu?
                    # Probably the same bug reported as install/49440.
                    choose_install_media()
                    # And again...
                    child.expect(r"The following are the http site")
                    child.expect(r"x: Get Distribution")
                    child.send("x\n")
                elif r == 1:
                    pass
                else:
                    assert(0)
            elif r == 12:
                # "Is the network information you entered accurate"
                child.expect(r"([a-z]): Yes")
                child.send(child.match.group(1) + b"\n")
            elif r == 13:
                 # "(I have found the following network interfaces)"
                choose_interface_oldstyle()
                configure_network()
            elif r == 14:
                # "(Which network device would you like to use)"
                choose_interface_newstyle()
                configure_network()
            elif r == 15:
                choose_no()
                child.expect(r"No aborts the install process")
                choose_yes()
            elif r == 16:
                self.slog("network problems detected")
                child.send("\003") # control-c
                gather_input(child, 666)
                for i in range(60):
                    child.send("ifconfig -a\n")
                    gather_input(child, 1)
                # would run netstat here but it's not on the install media
                gather_input(child, 30)
                sys.exit(1)
            elif r == 17:
                self.slog("matched newfs to defeat repeat match detection")
            elif r == 18:
                # "Do you want to install the NetBSD bootcode"
                choose_yes()
            elif r == 19:
                # "Do you want to update the bootcode in the Master Boot Record to the latest"
                choose_yes()
            elif r == 20:
                # Custom installation is choice "d" in 6.0,
                # but choice "c" or "b" in older versions
                # We could use "Minimal", but it doesn't exist in
                # older versions.
                child.send(child.match.group(1) + b"\n")
                # Enable/disable sets.
                choose_sets(self.dist.sets)
            elif r == 21:
                raise AssertionError
            # On non-Xen i386/amd64 we first get group 22 or 23,
            # then group 24; on sparc and Xen, we just get group 24.
            elif r == 22:
                # "This is the correct geometry"
                child.send("\n")
            elif r == 23:
                # "a: Use one of these disks"
                child.send("a\n")
                child.expect(r"Choose disk")
                child.send("0\n")
            elif r == 24:
                # "(([a-z]): Set sizes of NetBSD partitions)"
                child.send(child.match.group(1) + b"\n")
            elif r == 25:
                raise AssertionError
            elif r == 26:
                # "a partitioning scheme"
                if self.partitioning_scheme == 'MBR':
                    child.expect(r"([a-z]): Master Boot Record")
                    child.send(child.match.group(1) + b"\n")
                else:
                    # Sparc asks the question but does not have MBR as an option,
                    # only disklabel.  Just use the first choice, whatever that is.
                    child.send("a\n")
            elif r == 27:
                # "([a-z]): use the entire disk"
                child.send(child.match.group(1) + b"\n")
            elif r == 28:
                raise AssertionError
            elif r == 29 or r == 30:
                # Install or replace bootcode
                child.expect(r"a: Yes")
                child.send("\n")
            elif r == 31:
                # "Please enter a name for your NetBSD disk"
                child.send("\n")
            elif r == 32:
                # "ready to install NetBSD on your hard disk"
                child.expect(r"Shall we continue")
                child.expect(r"b: Yes")
                child.send("b\n")
                # newfs is run at this point
            elif r == 33:
                # "We now have your BSD disklabel partitions"
                child.expect(r"x: Partition sizes ok")
                child.send("x\n")
            elif r == 34:
                # Your disk currently has a non-NetBSD partition
                choose_yes()
            elif r == 35:
                # We need to enter these values in cases where sysinst could not
                # determine disk geometry. Currently, this happens for NetBSD/hpcmips
                child.expect(r"sectors")
                child.send("\n")
                child.expect(r"heads")
                child.send("\n")
            elif r == 36:
                raise RuntimeError('setting up partitions did not work first time')
            elif r == 37:
                pass
            elif r == 38:
                # not enough entropy
                self.provide_entropy(child)
            elif r == 39:
                # Changing local password for root
                child.expect(r"sword:")
                child.send("\n")
            elif r == 40:
                # (Accept partition sizes)|(Go on)
                #
                # In 2.1, no letter label like "x: " is printed before
                # "Accept partition sizes", hence the kludge of sending
                # multiple cursor-down sequences.

                #child.send(child.match.group(1) + "\n")
                # Press cursor-down enough times to get to the end of the list,
                # to the "Accept partition sizes" entry, then press
                # enter to continue.  Previously, we used control-N ("\016"),
                # but if it gets echoed (which has happened), it is interpreted by
                # the terminal as "enable line drawing character set", leaving the
                # terminal in an unusable state.
                if term in ['xterm', 'vt100']:
                    # For unknown reasons, when using a terminal type of "xterm",
                    # sysinst puts the terminal in "application mode", causing the
                    # cursor keys to send a different escape sequence than the default.
                    cursor_down = b"\033OB"
                else:
                    # Use the default ANSI cursor-down escape sequence
                    cursor_down = b"\033[B"
                child.send(cursor_down * 8 + b"\n")
            else:
                raise AssertionError

        # Installation is finished, halt the system.
        # Historically, i386 and amd64, you get a root shell,
        # while sparc just halts.
        # Since Fri Apr 6 23:48:53 2012 UTC, you are kicked
        # back into the main menu.

        x_sent = False
        while True:
            r = child.expect([r'Hit enter to continue',
                              r'x: Exit Install System',
                              r'#',
                              r'halting machine',
                              r'halted by root',
                              r'Would you like to setup system entropy now'])
            if r == 0:
                child.send("\n")
            elif r == 1:
                # Back in menu
                # Menu may get redrawn, so only send this once
                if not x_sent:
                    child.send("x\n")
                    x_sent = True
            elif r == 2:
                # Root shell prompt
                child.send("halt\n")
            elif r == 3 or r == 4:
                # halted
                break
            elif r == 5:
                # Would you like to set up system entropy now?
                choose_yes();
                self.provide_entropy(child)
            else:
                raise AssertionError

        self.halted = True
        self.is_logged_in = False
        self.post_halt_cleanup()

    def post_halt_cleanup(self):
        # Keep logging for a few seconds more so that we gather
        # the autoconf detach messages or a possible panic on
        # detach.  If we get EOF during the wait, ignore it.
        try:
            gather_input(self.child, 5)
        except pexpect.EOF:
            pass
        self.slog('done')
        self.child.close()
        self.dist.cleanup()
        self.cleanup_child()

    # Install NetBSD if not installed already

    def install(self):
        # This is needed for Xen and noemu, where we get the kernel
        # from the dist rather than the installed image
        self.dist.set_workdir(self.workdir)
        if self.vmm == 'noemu':
            self.dist.download()
            self._install()
        else:
            # Already installed?
            if os.path.exists(self.wd0_path()):
                return
            try:
                self._install()
            except:
                # "xl destroy" gets confused if the disk image
                # has been removed, so run it before removing
                # the disk image rather than after.
                self.cleanup_child()
                if os.path.exists(self.wd0_path()):
                    os.unlink(self.wd0_path())
                raise

    # Boot the virtual machine (installing it first if it's not
    # installed already).  The vmm_args argument applies when
    # booting, but not when installing.  Does not wait for
    # a login prompt.

    def start_boot(self, vmm_args = None, install = None, snapshot_system_disk = None):
        if vmm_args is None:
            vmm_args = []
        if install is None:
            install = not self.no_install
        if snapshot_system_disk is None:
            snapshot_system_disk = not self.persist

        if install:
            self.install()

        # Start counting CD drives from 0 again after the install
        self.n_cdrom = 0

        if self.dist.arch() in ['hpcmips', 'landisk']:
            vmm_args += [os.path.abspath(os.path.join(self.dist.download_local_arch_dir(),
                 "binary", "kernel", "netbsd-GENERIC.gz"))]
        if self.dist.arch() == 'macppc':
            # macppc does not support booting from FFS, so boot from
            # a CD instead
            args, dummy = self.qemu_add_cdrom(self.dist.runtime_boot_iso_path(), [('index', '2')])
            vmm_args += args
            vmm_args += ["-prom-env", "boot-device=cd:,netbsd-GENERIC"]
        if self.dist.arch() == 'alpha':
            generic_kernel = os.path.join(self.workdir, 'netbsd_generic')
            gunzip(os.path.join(self.dist.download_local_arch_dir(),
                                "binary", "kernel", "netbsd-GENERIC.gz"),
                   generic_kernel)
            vmm_args += ['-kernel', generic_kernel]

        if self.vmm == 'qemu':
            child = self.start_qemu(vmm_args, snapshot_system_disk = snapshot_system_disk)
            # "-net", "nic,model=ne2k_pci", "-net", "user"
            if self.dist.arch() == 'macppc' and self.machine == 'mac99':
                child.expect(r'root device.*:')
                for c in "wd0a\r\n":
                    child.send(c)
                child.expect(r"dump device \(default wd0b\):")
                child.send("\r\n")
                child.expect(r"file system \(default generic\):")
                child.send("\r\n")
                child.expect(r"init path \(default /sbin/init\):")
                child.send("\r\n")
        elif vmm_is_xen(self.vmm):
            vmm_args += self.xen_args(install = False)
            child = self.start_xen_domu(vmm_args)
        elif self.vmm == 'noemu':
            child = self.start_noemu(vmm_args + ['--boot-from', 'disk'])
        elif self.vmm == 'gxemul':
            child = self.start_gxemul(vmm_args)
        elif self.vmm == 'simh':
            child = self.start_simh(vmm_args)
            child.expect(r">>>")
            child.send("boot dua0\r\n")
        else:
            raise RuntimeError('unknown vmm %s' % vmm)
        self.child = child
        return child

    # Like start_boot(), but wait for a login prompt.
    def boot(self, vmm_args = None):
        # Needed to determine runtime_boot_iso_path on macppc
        self.dist.set_workdir(self.workdir)
        self.start_boot(vmm_args)
        while True:
            r = self.child.expect([r'\033\[c', r'\033\[5n', r'login:'])
            if r == 0:
                # The guest is trying to identify the terminal.
                # Dell servers do this.  Respond like an xterm.
                self.child.send('\033[?1;2c')
            elif r == 1:
                # The guest sent "request terminal status".  HP servers
                # do this.  Respond with "terminal ready".
                self.child.send('\033[0n')
            elif r == 2:
                # Login prompt
                break
            else:
                assert(0)

        # Can't close child here because we still need it if called from
        # interact()
        return self.child

    # Deprecated
    def interact(self):
        self.boot()
        self.console_interaction()

    # Interact with the console of a system that has already been booted
    def console_interaction(self):
        # With pexpect 2.x and newer, we need to disable logging to stdout
        # of data read from the slave, or otherwise everything will be
        # printed twice.  We can still log to the structured log, though.
        self.child.logfile_read = Logger('recv', self.structured_log_f)
        self.slog('entering console interaction')
        self.child.interact()

    # Run the NetBSD ATF test suite on the guest.  Note that the
    # default timeout is separately defined here (for library callers)
    # and in the "anita" script (for command-line callers).
    def run_tests(self, timeout = 10800):
        mkdir_p(self.workdir)
        results_by_net = (self.vmm == 'noemu')

        # Create a scratch disk image for exporting test results from the VM.
        # The results are stored in tar format because that is more portable
        # and easier to manipulate than a file system image, especially if the
        # host is a non-NetBSD system.
        #
        # If we are getting the results back by tftp, this file will
        # be overwritten.
        scratch_disk_path = os.path.join(self.workdir, "tests-results.img")
        if vmm_is_xen(self.vmm):
            scratch_disk = 'xbd1d'
        elif self.dist.arch() == 'evbarm-earmv7hf' and self.machine == 'virt':
            scratch_disk = 'ld5c'
        else:
            scratch_disk = self.get_arch_prop('scratch_disk')

        scratch_disk_args = []
        if scratch_disk:
            scratch_image_megs = 100
            make_dense_image(scratch_disk_path, parse_size('%dM' % scratch_image_megs))
            # Leave a 10% safety margin
            max_result_size_k = scratch_image_megs * 900

            if vmm_is_xen(self.vmm):
                scratch_disk_args = [self.xen_disk_arg(os.path.abspath(scratch_disk_path), 1)]
            elif self.vmm == 'qemu':
                scratch_disk_args = self.qemu_disk_args(os.path.abspath(scratch_disk_path), 1, True, False)
            elif self.vmm == 'noemu':
                pass
            elif self.vmm == 'gxemul':
                scratch_disk_args = self.gxemul_disk_args(os.path.abspath(scratch_disk_path))
            elif self.vmm == 'simh':
                scratch_disk_args = ['set rq1 ra92', 'attach rq1 ' + scratch_disk_path]
            else:
                raise RuntimeError('unknown vmm')

        child = self.boot(scratch_disk_args)
        self.login()

        # Build a shell command to run the tests.
        # The shell variable $t is the temporary directory where the
        # test output files should be stored.  This used to be /tmp,
        # but is now /var/tmp because PR 59560.
        if self.tests == "kyua":
            if self.shell_cmd("grep -q 'MKKYUA.*=.*yes' /etc/release") != 0:
                raise RuntimeError("kyua is not installed.")
            test_cmd = (
                "kyua " +
                    "--loglevel=error " +
                    "--logfile=$t/tests/kyua-test.log " +
                    "test " +
                    "--store=$t/tests/store.db; " +
                "echo $? >$t/tests/test.status; " +
                "kyua " +
                    "report " +
                    "--store=$t/tests/store.db " +
                    "| tail -n 3; " +
                "kyua " +
                    "--loglevel=error " +
                    "--logfile=$t/tests/kyua-report-html.log " +
                    "report-html " +
                    "--store=$t/tests/store.db " +
                    "--output=$t/tests/html; ")
        elif self.tests == "atf":
            atf_aux_files = ['/usr/share/xsl/atf/tests-results.xsl',
                             '/usr/share/xml/atf/tests-results.dtd',
                             '/usr/share/examples/atf/tests-results.css']
            test_cmd = (
                "{ atf-run; echo $? >$t/tests/test.status; } | " +
                "tee $t/tests/test.tps | " +
                "atf-report -o ticker:- -o ticker:$t/tests/test.txt " +
                "-o xml:$t/tests/test.xml; " +
                "(cd $t && for f in %s; do cp $f tests/; done;); " % ' '.join(atf_aux_files))
        else:
            raise RuntimeError('unknown testing framework %s' % self.test)

        # Build a shell command to save the test results
        if results_by_net:
            save_test_results_cmd = (
                "{ cd $t && " +
                "tar cf tests-results.img tests && " +
                "(echo blksize 8192; echo put tests-results.img) | tftp %s; }; " % \
                (self.net_config.get('serveraddr') or "10.169.0.1")
            )
        elif scratch_disk:
            save_test_results_cmd = (
            "{ cd $t && " +
                # Make sure the files will fit on the scratch disk
                "test `du -sk tests | awk '{print $1}'` -lt %d && " % max_result_size_k +
                # To guard against accidentally overwriting the wrong
                # disk image, check that the disk contains nothing
                # but nulls.
                "test `</dev/r%s tr -d '\\000' | wc -c` = 0 && " % scratch_disk +
                # "disklabel -W /dev/rwd1d && " +
                "tar cf /dev/r%s tests; " % scratch_disk +
            "}; "
            )
        else:
            save_test_results_cmd = ""

        exit_status = self.shell_cmd(
            "t=/var/tmp; " +
            "df -k | sed 's/^/df-pre-test /'; " +
            "mkdir $t/tests && " +
            "cd /usr/tests && " +
            test_cmd +
            save_test_results_cmd +
            "df -k | sed 's/^/df-post-test /'; " +
            "ps -glaxww | sed 's/^/ps-post-test /'; " +
            "vmstat -s; " +
            "s=$(cat /tmp/test.status); sh -c \"exit $s\"",
            timeout, [r'\d test cases', r'\[\d+\.\d+s\]'])

        # Halt the VM before reading the scratch disk, to
        # ensure that it has been flushed.  This matters
        # when using gxemul.
        self.halt()

        if scratch_disk:
            # Extract the ATF results from the scratch disk.
            # We give tar an explicit path to extract to guard against
            # the possibility of an arbitrary file overwrite attack if
            # anita is used to test an untrusted virtual machine.
            tarfile = open(scratch_disk_path, "r")
            subprocess.call(["tar", "xf", "-", "tests"],
                            cwd = self.workdir, stdin = tarfile)

            # For backwards compatibility, point workdir/atf to workdir/tests.
            compat_link = os.path.join(self.workdir, 'atf')
            if not os.path.lexists(compat_link):
                os.symlink('tests', compat_link)

        return exit_status

    # Backwards compatibility
    run_atf_tests = run_tests

    # Log in, if not logged in already
    def login(self):
        if self.is_logged_in:
            return
        login(self.child)
        self.is_logged_in = True

    # Run a shell command and return its exit status
    def shell_cmd(self, cmd, timeout = -1, keepalive_patterns = None):
        self.login()
        return shell_cmd(self.child, cmd, timeout, keepalive_patterns)

    # Halt the VM
    def halt(self):
        if self.halted:
            return
        self.login()
        self.child.send("halt\n")
        try:
            # Wait for text confirming the halt, or EOF
            self.child.expect([r'The operating system has halted',
                               r'entering state S5',
                               r'> ', # sparc64 firmware prompt
                               r'System halted!', # hppa
                               r'halted', # macppc
                              ], timeout = 60)
        except pexpect.EOF:
            # Didn't see the text but got an EOF; that's OK.
            print("EOF")
        except pexpect.TIMEOUT as e:
            # This is unexpected but mostly harmless
            print("timeout waiting for halt confirmation:", e)
        self.halted = True
        self.is_logged_in = False
        self.post_halt_cleanup()

# Calling this directly is deprecated, use Anita.login()

def login(child):
    # Send a newline character to get another login prompt, since boot() consumed one.
    child.send("\n")
    child.expect(r"login:")
    child.send("root\n")
    # This used to be "\n# ", but that doesn't work if the machine has
    # a hostname
    child.expect(r"# ")

# Generate a root shell prompt string that is less likely to appear in
# the console output by accident than the default of "# ".  Must end with "# ".

def gen_shell_prompt():
    return 'anita-root-shell-prompt-%s# ' % str(time.time())

# Quote a prompt in /bin/sh syntax, with some extra quotes
# in the middle so that an echoed command to set the prompt is not
# mistaken for the prompt itself.

def quote_prompt(s):
    midpoint = len(s) // 2
    return "".join("'%s'" % part for part in (s[0:midpoint], s[midpoint:]))

# Expect any of "patterns" with timeout "timeout", resetting the timeout
# whenever one of "keepalive_patterns" occurs.

def expect_with_keepalive(child, patterns, timeout, keepalive_patterns):
    if keepalive_patterns is None:
        keepalive_patterns = []
    all_patterns = patterns + keepalive_patterns
    while True:
        i = child.expect(all_patterns, timeout)
        if i < len(patterns):
            break
    return i

# Calling this directly is deprecated, use Anita.shell_cmd()

def shell_cmd(child, cmd, timeout = -1, keepalive_patterns = None):
    child.send("exec /bin/sh\n")
    child.expect(r"# ")
    prompt = gen_shell_prompt()
    child.send("PS1=" + quote_prompt(prompt) + "\n")
    prompt_re = prompt
    child.expect(prompt_re)
    child.send(cmd + "\n")
    # Catch EOF to log the signalstatus, to help debug qemu crashes
    try:
        expect_with_keepalive(child, [prompt_re], timeout, keepalive_patterns)
    except pexpect.EOF:
        print("pexpect reported EOF - VMM exited unexpectedly")
        child.close()
        print("exitstatus", child.exitstatus)
        print("signalstatus", child.signalstatus)
        raise
    except:
        raise
    child.send("echo exit_status=$?=\n")
    child.expect(r"exit_status=(\d+)=")
    r = int(child.match.group(1))
    child.expect(prompt_re, timeout)
    return r

def test(child):
    raise RuntimeError("global test() function is gone, use Anita.run_tests()")

#############################################################################
