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

uninstall

uncache

purge

rebuild-grub

rebuild-menu

fw-toggle

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

~/.di-netboot-assistant/di-netboot-assistant.conf

/etc/di-netboot-assistant/di-sources.list

/etc/di-netboot-assistant/pxelinux.HEAD

/var/lib/di-netboot-assistant/

/var/cache/di-netboot-assistant/

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>.