genode/tool
Adrian-Ken Rueegsegger 94afc1a340 run: support loading images via iPXE/HTTP
iPXE is an open source network boot firmware which supports booting from
a web server via HTTP [1].

The following two parameters can be used to specify the iPXE/HTTP setup:

--load-ipxe-base-dir
  This parameter specifies the base directory of the HTTP server from
  which the target machine downloads the files.

--load-ipxe-boot-dir
  The directory relative to iPXE base dir which contains the iPXE
  chainload configuration and all necessary files.

The target machine is expected to request the following iPXE
configuration via HTTP:

http://${HOST_URL}/${ipxe-boot-dir}/boot.cfg

This can be achieved by building iPXE with the following embedded
script:

  #!ipxe
  dhcp
  chain http://${HOST_URL}/${ipxe-boot-dir}/boot.cfg

See also [2] for additional information.

[1] - http://ipxe.org/
[2] - http://ipxe.org/howto/chainloading#breaking_the_loop_with_an_embedded_script

Fixes #1708
2015-09-30 12:20:40 +02:00
..
boot bender: unconditionally relocate all boot modules 2015-07-21 09:30:11 +02:00
builddir Introduce 'spec' subdirectories to outline aspects 2015-09-16 13:58:50 +02:00
patches tool_chain: enable x86_64 target support in GDB 2015-05-26 09:39:49 +02:00
ports tool/ports: curl timeout and retry in check.mk 2015-04-09 16:04:47 +02:00
run run: support loading images via iPXE/HTTP 2015-09-30 12:20:40 +02:00
README Bootable GRUB2 disk image with ext2 partition 2014-08-18 13:25:21 +02:00
autopilot Remove always_hybrid spec 2015-09-09 15:14:27 +02:00
autopilot.list base: handle unsupported printf commands better 2015-09-30 12:20:38 +02:00
beautify Imported Genode release 11.11 2011-12-22 16:19:25 +01:00
create_builddir codezero: remove support from Genode (fix #1668) 2015-09-09 15:14:29 +02:00
create_grub2 create_grub2: ext2 default parameters for image 2015-03-13 12:17:26 +01:00
create_iso run: instruct 'exec' to ignore stderr output 2014-01-27 18:53:52 +01:00
cxx_to_html Tool cxx_to_html to convert C++ source to HTML 2012-01-08 14:09:47 +01:00
download_hashver Hash verification tool 2013-06-10 10:44:09 +02:00
download_sigver GPG signature verification tool 2013-06-10 10:44:09 +02:00
fix_include_ifndef tool/fix_include_ifndef: consider license header 2014-01-27 18:54:05 +01:00
grub2-head.img create_grub2: ext2 default parameters for image 2015-03-13 12:17:26 +01:00
link.h tool_chain: cleanup 2015-05-26 09:39:49 +02:00
parse_cxx Improvements of parse_cxx tool 2015-04-09 16:04:45 +02:00
prepare.mk Enable hash checks for ports mechanism 2014-05-27 13:45:03 +02:00
rump tool: wrapper script for rumpkernel tools 2014-05-27 11:14:45 +02:00
rump_cgdconf tool: wrapper script for rumpkernel tools 2014-05-27 11:14:45 +02:00
tool_chain tool_chain: symlink fix 2015-05-26 09:39:51 +02:00
tool_chain_gcc_patches.inc tool_chain: cleanup 2015-05-26 09:39:49 +02:00
tool_chain_gdb_patches.inc tool_chain: use real patches 2014-05-14 16:08:00 +02:00
tool_chain_rump tools: strip rumpkernel based tools 2014-08-28 12:35:56 +02:00

README

This directory contains tools for managing and using the source code
of Genode.

:'create_builddir'

  The 'create_builddir' tool provides a convenient way to create build
  directories for different platforms. Its usage information is printed when
  starting the tool without arguments.

:'builddir/':

  This directory contains a Makefile template and configuration snippets used
  by the 'create_builddir' tool.

:'tool_chain':

  This tool downloads, builds, and installs the tool chain needed to build the
  Genode OS Framework. For getting usage information, start the tool without
  arguments.

:'create_iso':

  This simple tool helps to build bootable ISO images from your build of
  Genode. For getting usage information, start the tool without arguments.

:'create_grub2':

  This tool prepares a partitioned disk image with GRUB2 as boot
  loader.

:'grub2-head.img':

  This file is the head part of a partioned disk image including an
  installation of GRUB2 as boot loader. GRUB2 is available from
  http://www.gnu.org/software/grub/ and in major Linux distributions.
  Steps to reproduce the image creation can be found in
  'create_grub2'.

:'beautify':

  Beautify is a coding-style checking tool that analyzes source code for its
  adherence to Genode's coding style as described in 'doc/coding_style.txt'.
  Whenever possible, the tool tries to fix the issues and outputs a corrected
  file.  Some corrections, however, require human interaction.  In this case,
  the tool stops the analysis with an error.

:'parse_cxx':

  This tool is a C++ parser used as front-end for Beautify.

:'cxx_to_html':

  This tool converts a C++ source file to a HTML view to be used for the API
  documentation at the genode.org website. It relies on 'parse_cxx' to do the
  actual C++ parsing.

:'fix_include_ifndef':

  This tool helps with assigning consistent include guards to header files.

:'boot':

  This directory contains boot-loader files needed to create boot images.

:'autopilot':

  Autopilot is a tool for the automatic execution of run scripts among multiple
  base platforms.

:'prepare.mk':

  Tool for downloading and integrating 3rd-party source codes with Genode.
  This file is included by the makefiles in the root of source-code
  repositories that interface with 3rd-party code, e.g., libports and ports.