xenial (1) di-netboot-assistant.1.gz

Provided by: di-netboot-assistant_0.41_all bug

NAME
       di-netboot-assistant - Debian-Installer netboot assistant


SYNOPSIS
       di-netboot-assistant  [-h] [--version] [--verbose] [--offline] {[install image...] | [uninstall image...]
       |   [uncache image...]   |   [purge image...]   |   [rebuild-menu]   }   [--arch=arch]   [--di-args=ARGS]
       [--target-args=ARGS] [--alias=alias]


DESCRIPTION
       di-netboot-assistant is a simple tool to download and extract latest debian installer netboot images.

       Unless the -h, --help, -V, or --version option is given, one of the commands below 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-menu
           rebuild-menu   will   rebuild   the   top   level  menu.  It's  only  useful  if  you  have  modified
           di-netboot-assistant.conf and you are using some client images that have top level menu  (like  i386,
           amd64 and ia64). This command takes no argument.


OPTIONS
       -h, --help Print this message and exit

       -v, --version
              Print script version and exit

       --alias=alias
              Specify  the  alias  name  under  wich 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  you  want  to  install  or purge. The architecture you can use for the
              install action must be declared in /etc/di-netboot-assistant/di-sources.list. The architecture you
              can  use  for purge action in one of those you previously installed ! The usable architectures can
              be listed by leaving --arch= empty. The default architecture is the current one  (as  reported  by
              dpkg --print-architecture).

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

       --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 image that can removed.
            di-netboot-assistant purge

       To remove a netboot image for the stable repository, for the default architecture.
            di-netboot-assistant purge stable


EXIT CODE
       0      Successful program execution.

       1      An error occured. (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.

       /etc/di-netboot-assistant/elilo.HEAD
           The  content  of  this  file  is  prepended to the generated Elilo config file (i.e boot menu). Elilo
           bootloader is used on EFI based systems like ia64 and a few i386 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>.