1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
These are simple utils for debian-installer:
mapdevfs: Given a devfs device name, returns the name that would be used on
a non devfs system. Only works for some devices, used by eg, boot loader
installers.
log-output: Runs a command, logging any stdout/stderr output to the syslog,
and preserving the command's exit code. If you use the --pass-stdout option,
it will pass stdout through rather than logging it, so that you can redirect
it to a file or pipe it to another process. Note that the command must be
in the path, shell builtins won't work.
anna-install: Each parameter is a udeb that anna should install. If this
command is run before anna has configured a default retriever, the udebs
will be queued for the future anna run. If it's run after a default
retriever is configured, the specified udebs will be installed immediately.
apt-install: The parameter is a deb that should be installed into /target.
If the /target environment is not yet set up, the package will be queued for
later installation (at the end of base-installation).
If /target is already set up, the package will be installed straightaway.
apt-install makes use of in-target and debconf-apt-progress to allow
configuration questions to be asked and to allow media changes if multiple
CD/DVD sources have been set up.
In case multiple CD/DVD sources are defined in the sources.list and the
installation CD is not already unmounted, apt-install will unmount it
in the D-I environment for the duration of the package installation so as not
to block CD changes by apt in the target environment. Afterwards, if it was
mounted at the start, it will ensure the installation CD/DVD is reloaded.
in-target: Runs the specified command in /target and returns its exit
status. The debconf passthrough frontend is used to make debconf questions
be asked using cdebconf in the installer. This is especially useful for
running things like dpkg-reconfigure, debconf-apt-progress, and tasksel.
The log-output utility is used to log any output; if in-target is called
with the option --pass-stdout, log-output will respect it.
Both apt-install and in-target will by default use the locale selected for
the target system. The environment variable IT_LANG_OVERRIDE can be set to
override this. This is for example needed to avoid locale errors when the
locales package has not yet been installed in the target environment
debconf-get: Prints out the value of a debconf question.
debconf-set: Sets a debconf question to a value.
fetch-url: fetch-url [-c|-r] <url> <file>
Grabs the url and puts it in the file. It uses methods for each protocol
that it finds in /usr/lib/fetch-url/ (this allows for new protocols
to be added). It returns 0 on success, 1 on failure.
The options modify its behaviour thus (for those methods where they
make sense -- ftp & http currently -- otherwise they're ignored):
-r Retry. For retryable errors on methods that are worth
retrying (i.e. http/ftp downloads), will repeat the download
attempt once.
-c Continuation Retry. Likewise, retries, but will attempt to
continue (i.e. with wget's -c) the download, and will try up
to 3 times after the initial attempt.
Only use this if you're downloading something that subsequently
gets checksummed, as rumour has it that busybox's wget is not
very bright when it comes to continuing partial downloads.
It's probably best not to combine these two options, as they're
currently implemented in nested loops, and the combination will retry
too many times, and alternate between full and continuation attempts
in a senseless manner.
register-module: Register a module to go in /etc/modules on the target. May
be called before the target is mounted. Can optionally pass parameters that
should be passed to the module on load; these are added to the appropriate
files in /etc to make modprobe use them. If the -p parameter is passed then
the module is not added to /etc/modules and only the specified parameters
are set for it. The -t parameter is used to specify the type of options
(currently only the default type "options" is used).
The -a parameter makes register-module add a param, without removing any
other params that might have been previously registered.
The -i parameter makes the module be added to the initrd used to boot the
installed system, and loaded during boot. If the script is called with the
-b parameter, the module will be blacklisted.
user-params: Output the parameters the user passed to the kernel on boot,
one per line. This should include only parameters the user entered by hand,
and will skip over parameters used to pre-seed debconf values or set kernel
module-specific parameters. For any of the user's parameters to be
recognised, the kernel command line must include "--" in it, and then all
parameters after the -- are assumed to be user input. Therefore, the
installer's boot loader should pass "--" at the end of its kernel command
line to make this work.
debconf-disconnect: Scripts running under the control of debconf can use
this to execute a command disconnected from debconf, with its standard file
descriptors the same as those of the debconf frontend itself. This is most
useful for starting interactive shells.
update-dev: Make sure that new device nodes have been created after loading
modules. This is particularly important for userdevfs, where disk device
nodes are not created automatically at all, but it is also important for
udev where there may be an asynchronous delay between loading the module and
udev getting around to creating the device node.
search-path: Returns true if a program is found in the path (d-i has no
"which" command); this is deprecated, and new code should simply use
"type PROGRAM >/dev/null 2>&1" instead.
list-devices: List device nodes representing devices of various types,
handling both devfs and udev naming schemes.
|