Package: di-netboot-assistant
Version: 0.37
Severity: wishlist
File: /usr/share/man/man1/di-netboot-assistant.1.gz
Usertags: man-reportbug
*** NOTE
Please find attached a suggested improvement for the manpage:
/usr/share/man/man1/di-netboot-assistant.1.gz
(The diff file [di-netboot-assistant.1.diff] was generated against the output
of 'man -Tutf8 1 di-netboot-assistant', which is also attached for
referenced [di-netboot-assistant.1.orig]).
***
-- System Information:
Debian Release: squeeze/sid
APT prefers testing
APT policy: (500, 'testing'), (101, 'unstable'), (10, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.32-rc8-686 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages di-netboot-assistant depends on:
ii curl 7.19.7-1 Get a file from an HTTP, HTTPS or
ii wget 1.12-1.1 retrieves files from the web
Versions of packages di-netboot-assistant recommends:
ii tftpd-hpa 0.49-1 HPA's tftp server
Versions of packages di-netboot-assistant suggests:
ii dhcp3-server 3.1.3-1 DHCP server for automatic IP addre
ii elilo 3.10-1 Bootloader for systems using EFI-b
pn syslinux <none> (no description available)
-- no debconf information
---
/tmp/user/1000/man-reportbug.di-netboot-assistant.1.kVo/di-netboot-assistant.1.orig
2009-12-02 21:52:20.000000000 +0100
+++
/tmp/user/1000/man-reportbug.di-netboot-assistant.1.kVo/di-netboot-assistant.1
2009-12-02 21:52:23.000000000 +0100
@@ -1,4 +1,3 @@
-DI-NETBOOT-ASSISTANT(1) User Commands DI-NETBOOT-ASSISTANT(1)
DI-NETBOOT-ASSISTANT(1) User Commands DI-NETBOOT-ASSISTANT(1)
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 usefull 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 --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 /usr/share/doc/di-netboot-
assistant/examples/peruser.di-netboot-assistant.conf)
/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 <[email protected]>.
Frank Lin Piat August 2009 DI-NETBOOT-ASSISTANT(1)
