Provided by: di-netboot-assistant_0.78_all 
NAME
di-netboot-assistant - Debian-Installer netboot assistant
SYNOPSIS
di-netboot-assistant {install | uninstall | uncache | purge | fw-
toggle} image... [--alias=alias] [--arch=arch] [--di-args=ARGS] [--ignore-sig]
[--target-args=ARGS] [--offline] [--verbose]
di-netboot-assistant {rebuild-grub | rebuild-menu} [--verbose]
di-netboot-assistant {-h | --help} | {-V | --version}
DESCRIPTION
di-netboot-assistant is a tool to download and extract Debian Installer netboot images.
Unless the -h, --help, -V, or --version option is given, one of the following commands
must be present.
install
install is followed by a repository name desired for installation. The repository name
has to be one of those declared in /etc/di-netboot-assistant/di-sources.list. The
image will be installed/extracted in the default location (declared in
/etc/di-netboot-assistant/di-netboot-assistant.conf).
uninstall
uninstall is followed by the name of the repository to be uninstalled (or the
repository's alias if you used --alias=). The netboot files related to that
distribution will be removed from the TFTP server.
uncache
uncache will clean the cached files for the given netboot image. You must specify a
repository name (not an --alias= name).
purge
purge is followed by a repository name desired for installation. purge is identical to
running uninstall then uncache for a given repository.
rebuild-grub
rebuild-grub will rebuild the grub EFI netboot image. The configuration itself is set
up by rebuild-menu. This command takes no argument.
rebuild-menu
rebuild-menu will rebuild the top level menu. It is useful if you have modified
di-netboot-assistant.conf or added a Live ISO image. The installer images need to have
a top level menu (like i386, amd64). This command takes no argument.
fw-toggle
fw-toggle is followed by a repository name and adds respectively removes non-free
firmware. The non-free firmware will be downloaded if not available from cache. Use
n-pkg as repository to add the firmware to packaged installer images.
OPTIONS
-h, --help Print short help and exit
-V, --version
Print script version and exit
--alias=alias
Specify the alias name under which this repository will be saved. Alias names can
only contain alphanumeric, "_" and "-" characters. This is especially useful for
daily images. By default, the alias name is the same as the repository name.
--arch=arch
Specify the architecture to operate on. The architecture used for the install
action must be declared in /etc/di-netboot-assistant/di-sources.list. Architectures
available for the purge action are those previously installed. Available
architectures can be listed by leaving --arch= empty. If absent, the system's
architecture (as reported by dpkg --print-architecture) is used.
--verbose
Verbose messages
--di-args="ARGS"
Debian-Installer boot arguments. The specified arguments will be *appended* to the
one provided in the downloaded image, before the "--". (You can also define
DI_ARGS= in di-netboot-assistant.conf).
--tftproot="DIR"
Overwrite the TFTP_ROOT variable given in the configuration. Use DIR as the TFTP
server's root directory instead. Not recommended and to be used with care, as only
a single TFTP root directory is supported.
--ignore-sig
Ignore failing image signature checks. Useful when run non-interactively in scripts
and images are known to be not signed.
--target-args="ARGS"
Boot arguments for the target (installed) system. The specified arguments will be
*appended* to the one provided in the downloaded image, at the very end of the
line. (You can also define TARGET_ARGS= in di-netboot-assistant.conf).
--offline
Don't download the files (use the files cached previously).
EXAMPLES
To install a netboot image for the stable repository, for the default architecture:
di-netboot-assistant install stable
To list the installed netboot images that can be removed:
di-netboot-assistant purge
To remove a netboot image for the stable repository, for the default architecture:
di-netboot-assistant purge stable
To toggle firmware for the stable repository, for the default architecture:
di-netboot-assistant fw-toggle stable
To toggle firmware for packaged debian-installer netboot images, all architectures:
di-netboot-assistant fw-toggle n-pkg --arch=all
EXIT CODE
0 Successful program execution.
1 An error occurred. (Note that purge doesn't fail if the specified repository
doesn't exists).
FILES
/etc/di-netboot-assistant/di-netboot-assistant.conf
The default system-wide configuration file. The file syntax must be bash(1)
compatible.
~/.di-netboot-assistant/di-netboot-assistant.conf
User's own configuration file. The file syntax must be bash(1) compatible. (See file
peruser.di-netboot-assistant.conf, in /usr/share/doc/di-netboot-assistant/examples/).
/etc/di-netboot-assistant/di-sources.list
This file contains the list of downloadable netboot images.
/etc/di-netboot-assistant/pxelinux.HEAD
The content of this file is prepended to the generated PXElinux config file (i.e boot
menu). PXElinux bootloader is used on BIOS based i386 and amd64 systems.
/var/lib/di-netboot-assistant/
The folder where hints about installed netboot images are stored. Do not edit those
files, re-use install to modify the settings of installed image.
/var/cache/di-netboot-assistant/
The folder where downloaded files are stored (cached) before "installing" them. Use
the action uncache to remove cached files.
SECURITY
Do not use sudo to grant execution right to di-netboot-assistant (see the README file).
PROXY
di-netboot-assistant uses wget or curl to actually download the files. You can set the
environnement variables accordingly.
AUTHOR
di-netboot-assistant was written by Frank Lin PIAT <fpiat@klabs.be>.