From 66ab83cd019b37ea25866e02068347676da0d961 Mon Sep 17 00:00:00 2001 From: Frans Pop Date: Tue, 26 Dec 2006 00:14:32 +0000 Subject: Clarifications based on comments from Tapio Lehtonen --- en/appendix/preseed.xml | 40 ++++++++++++++++++++++++++-------------- 1 file changed, 26 insertions(+), 14 deletions(-) (limited to 'en') diff --git a/en/appendix/preseed.xml b/en/appendix/preseed.xml index 9488398fb..bf3e77731 100644 --- a/en/appendix/preseed.xml +++ b/en/appendix/preseed.xml @@ -311,7 +311,18 @@ To set a value to be used inside &d-i;, just pass path/to/variable=value for any of the preseed variables listed in the examples in this appendix. If a value is to be used to configure packages for the target system, you -will need to prepend the owner of the variable as in +will need to prepend the owner + + +The owner of a debconf variable (or template) is normally the name of the +package that contains the corresponding debconf template. For variables +used in the installer itself the owner is d-i. +Templates and variables can have more than one owner which helps to +determine whether they can be removed from the debconf database if the +package is purged. + + + of the variable as in owner:path/to/variable=value. If you don't specify the owner, the value for the variable will not be copied to the debconf database in the target system and thus remain unused @@ -382,12 +393,12 @@ setup, it would result in the preseed file being retrieved from -The path segment of that comes from -auto-install/defaultroot, which includes the -directory etch by default to allow future versions -to specify their own codename to let people migrate forwards in a +The last part of that url (d-i/etch/./preseed.cfg) +is taken from auto-install/defaultroot. By default +this includes the directory etch to allow future versions +to specify their own codename and let people migrate forwards in a controlled manner. The /./ bit is used to indicate -a root relative to which subsequent paths can be anchored (for use in +a root, relative to which subsequent paths can be anchored (for use in preseed/include and preseed/run). This allows files to be specified either as full URLs, paths starting with / that are thus anchored, or even paths relative to the location where the last preseed file was @@ -402,12 +413,12 @@ fetched from -If there is no local DHCP or DNS infrastructure, or if you -do not want to use the default path to the preseed.cfg, you can still +If there is no local DHCP or DNS infrastructure, or if you do not want to +use the default path to preseed.cfg, you can still use an explicit url, and if you don't use the /./ -element it will be anchored to the start of the path (i.e. the third / -in the URL). Here is an example that requires minimal support from -the local network infrastructure: +element it will be anchored to the start of the path (i.e. the third +/ in the URL). Here is an example that requires minimal +support from the local network infrastructure: auto url=http://192.168.1.2/path/to/mypreseed.file @@ -432,8 +443,8 @@ path is added. In addition to specifying the url, you can also specify settings that do not directly affect the behavior of &d-i; itself, but can be passed -through to any scripts that might be specified preseed/run -settings in the loaded preseed file. At present, the only example of +through to scripts specified using preseed/run +in the loaded preseed file. At present, the only example of this is auto-install/classes, which has an alias classes. This can be used thus: @@ -1392,9 +1403,10 @@ settings for certain configurations in other files. # Most flexibly of all, this downloads a program and runs it. The program # can use commands such as debconf-set to manipulate the debconf database. +# More than one script can be listed, separated by spaces. # Note that if the filenames are relative, they are taken from the same # directory as the preconfiguration file that runs them. -d-i preseed/run string foo.sh +#d-i preseed/run string foo.sh -- cgit v1.2.3