Improve documentation and fix some types in code

Also add Emacs spellchecker exceptions at the end of the file.

Debian release

Use recursive target definition for ryu boards

The ryu target specifies properties of the U-Boot bootloader on the board
and ryuglab and ryulocal targets extent this with different possibilities
of how the board can be reached.

Add --uboot-addr, i.e. generic way to specify U-Boot load addresses

Add --prefix - a more generic variant of --grub-prefix

--grub-prefix is now alias to --prefix.

Add support for $NB_MYIP in --uboot-init

Improve detection of U-Boot prompt after tftpboot command

If the uboot prompt contains '#' character, it might not be detected
properly.

Initialize some variables even if /dev/null is passed as novaboot script

Set $builddir to invocation dir if it is not specified by other means

This fixes undefined variable in --tftp handling when novaboot it run as

  novabot ... -- /dev/null

Get rid of trailing newlines in --uboot-init commands

They break our "wait for prompt" logic.

Simplify --uboot-init handling

Update README.md

Support both old and new isolinux versions

Add support for configuration directory

Remove forgotten comment

Add support for recursive target definitions

I.e. one target definition can contain another --target option.

One more fix for ISO image creation

Support new version of syslinux

Support for older version was dropped. Let me know if somebody needs it.

AMT IDE-R implementation

This change is based on work by Václav Fanfule.

Add --tftp-port option

Inform the user in interaction is only onedirectional

Detect errors when starting tftpd

No we start tftpd without forking in novaboot (but in tftpd itself), which
allows us to detect when it does not start correctly. For example when
a system daemon already runs.

Improve U-Boot support

- U-Boot prompt is configurable
- Allow multiple --uboot-init options
- Do not try to boot if there is nothing to boot specified

Add --tftp option

Ignore test directories

Add sudoers template

debian: Do not recommend servers that are started automatically

Replace the dependency with "Suggest".

Wheezy compatibility:
- Allow iproute package as an alternative to ipreoute2.
- Recommend qemy-system rather than qemu-system-x86.

Require LWP module at run time rather than at compile time

This module is only needed with --amt.

Add Debian packaging

Support booting Linux with isolinux

isolinux configuration must be different for Linux and for Multiboot
kernels.

Fix the name of ISO image when it is booted under qemu

Use syslinux bootloader to create bootable ISO images

Previously, we used Grub 1, which was problematic, because it is not
available on modern distributions.

Replace qemu with qemu-system-i386

Even Debian removed backward compatibility symlink from qemu to
qemu-system-i386, so we have to replace the default configuration.

examples: Do not compile buildroot toolchain, just download a pre-built one

Implement run keyword

This allows to run arbitrary commands during file generation phase.

AMT: Disconnect SOL before power off

Otherwise power off fails.

Do not run amtterm only after reset and get rid of sleep()

This way, amtterm fails is somebody is already connected. Only if amtterm
succeeds, we proceed to reset/poweron.

With recent amttool (at least commit [1]), this works even without sleep
before running amtterm.

[1]: https://www.kraxel.org/cgit/amtterm/log/?h=0ece5135fef56dbd0d94957c334655a57adb7212

Update comments

Make example buildroot use /dev/console for getty

This way, getty appears wherever the user sets console kernel
command line.

Merge branch 'amt'

Conflicts:
README.md
novaboot

Update --amt documentation

Do not read the script if --on or -off is specified

This allows running novaboot without any script in which case
novaboot does not block in reading from stdin.

AMT: cleanups, simplifications

Whitespace and indentation fixes

Move "use LWP" to amt block

Novaboot should not fail when LWP is not installed and AMT is not used.

Do not power off during AMT reset

Added support of Intel AMT

gen_cpio: Add support for gzip compression

Use sterm instead of cu on ryuglab target

Compared to cu, sterm does not wait 2 seconds after hangup before it exits
(and leaves the port for another user/connection) and can reset the board
via command line switches (no need for --reset-cmd).

Sterm lives at
https://rtime.felk.cvut.cz/gitweb/can-benchmark.git/blob/HEAD:/utils/sterm.c

Additionally, use ssh -tt instead of -t. This causes the sterm to receive
SIGHUP even if ssh does not run on terminal.

gen_cpio fixes

doc: Change code to file

Add Linux example to the documentation

Add link to novaboot script syntax and fix md formating

Die if no file name is specified after load

Fix heredoc parsing

Documentation update (mainly introduction)

Move implementation of --chainloader and --bender to where it is documented

i.e. Script preprocessing phase.

Also move --strip-rom documentation to section "File generation phase",
because it is implemented there.

Add --kernel option

Add --help to synopsis

... so that people running novaboot -h know there is more to read.

Introduce 'load' keyword to novaboot scripts

THIS IS A BACKWARD INCOMPATIBLE CHANGE!!!

Any file intended to be loaded on the target MUST be prefixed with the
load keyword in the novaboot script. This is done to allow future
extension of novaboot syntax.

Idea by Pavel Píša.

Other changes in this patch:
- sanitized and simplified novaboot script parsing
- --append can be specified multiple times
- documentation fixes

Add command line interface to Expect.pm functionality

Allow specifying empty target

This overrides the default target and is useful mainly for testing.

gen_cpio: Add support for including whole directory trees

(mostly copied from gen_initramfs_list.sh)

Document how to use gen_cpio to produce uBoot images

Add how to use gen_cpio

Add first version of gen_cpio script

Increase uboot timeout

Sometimes 1 second was to small, perhaps due to lagging TCP connection.

Enclose uboot bootargs in apostrophes

Needed if bootags contain special characters.

Remove debugging messages

Die when asking for interactive mode without being on terminal

Tell the user correctly how to interrupt novaboot

Fix interactive mode escape sequence

There were two problems:

1. Escape sequence is a regular expression, therefore '.' must be prefixed
   with '\'.
2. Delete key produces an escape sequence that ends with '~'. Therefor
   pressing Delete followed by '.' exits novaboot.

It would be nice if we can use traditional esscape sequence '~.' at the
beginning of the line (as in ssh or cu), but it seems that Expect.pm cannot
handle the "beginning of the line" in the escape sequence correctly.
Therefore we use "~~." sequence to solve problem 2.

Add interactive mode

Remove -i alias of --iso option

Die when error in command line arguments is detected

Die when an unknown target is specified

Add --exiton option and EXITON variable

Sort documentation of variables alphabetically

Fix reading of configuration files in symlinked directories

We want novaboot to follow logical directory structure based on symlinks
and not to follow directories simply using ".." directory entry.

Imporove documentation

Add one second sleep to powerpc configurations to wait for establishing Ethernet link

Without sleep, we have to wait for a TFTP timeout, which is about 5 seconds.

Add --remote-cmd-expect option

This is necessary for ryuglab target to exit novaboot when serial line is
already used, perhaps by another novaboot instance or user.

Do not initialize $exp object if it is not used

Add $default_target configuration variable

Run qemu only when --qemu option is present

The default behavior does not change - see next commit.

Do not print short help when an unknown option is found

It was hard to find the error message printed before the help message.

Add --make option

Chomp nproc results before use

Use nproc tool to determine the number of parallel jobs for scons

Export serial line TTY as env. variable

This is needed for reset command in ryulocal configuration.

Also check whether dtrrts command exists before trying to execute it.

Fix inviseble text (<...>) in Github markdown

Update documentation

Improve uBoot support; add two targets that use uBoot

Add options for remote reset target connection and reset

Remove debug message

Fix example sudoers file

Rework interaction with the target

Only set up bi-directional communication if run on terminal. Also
specify manual_stty on STDIN to not mess up messages from background
server.

I will need to play more with terminal settings, because currently it is
not ideal. See the comment in the patch.

Clarify and simplify starting and killing of DHCP and TFTP servers

Because servers run under root, we do not have permissions to kill them.
Normally, this is not a problem, because Ctrl-C kills the servers, because
they are in the same process group and kernel (terminal) don't care
about permissions. If novaboot dies after starting server, we need a way
to kill the servers explicitly. We use pkill command and .pid files
produced by the server. This is quite reliable.

Add initial support for uBoot

Add --stty option to specify serial line configuration