This file is indexed.

/usr/share/doc/live-manual/html/customization-overview.en.html is in live-manual-html 1:3.0~a9-1ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">

<head>
  <title>
    customization-overview -
    Debian Live Manual
  </title>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
  <meta name="dc.title" content="Debian Live Manual" />
  <meta name="dc.author" content="Debian Live Project &#60;debian-live@lists.debian.org&#62;" />
  <meta name="dc.publisher" content="Debian Live Project &#60;debian-live@lists.debian.org&#62;" />
  <meta name="dc.date" content="2011-12-04"  />
  <meta name="dc.rights" content="Copyright (C) 2006-2011 Debian Live Project;&#60;br&#62; License: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.&#60;br&#62;&#60;br&#62;This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.&#60;br&#62;&#60;br&#62;You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. &#60;br&#62;&#60;br&#62;The complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file." />

  <meta name="generator" content="SiSU 3.1.9 of 2011w51/1 (2011-12-19) (n*x and Ruby!)" />
    <link rel="generator" href="http://www.sisudoc.org/" />
  <link rel="shortcut icon" href="../_sisu/image/rb7.ico" />

  <link rel="stylesheet" href="../_sisu/css/html.css" type="text/css" />
</head>
<body bgcolor="#ffffff" text="#000000" link="#003090" lang="en" xml:lang="en">
<a name="top" id="top"></a>
<a name="up" id="up"></a>
<a name="start" id="start"></a><table summary="segment navigation band with banner" bgcolor="#ffffff" width="100%"><tr>
<td width="20%" align="left">
<table summary="band" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#ffffff"><a href="http://live.debian.net/" target="_top"><img border="0" src="../_sisu/image/debian_home.png" alt="Debian --&gt;" /></a></td></tr>
</table>
</td>
<td width="75%" align="center">
  
<table summary="segment navigation available documents types: toc,doc,pdf,concordance" border="0" cellpadding="3" cellspacing="0">
<tr>
<td align="center" bgcolor="#ffffff">
  <td align="center" bgcolor="#ffffff">
  <a href="sisu_manifest.en.html" target="_top" >
      <font face="verdana, arial, georgia, tahoma, sans-serif, helvetica, times, roman" size="2">
    [&nbsp;document&nbsp;manifest&nbsp;]
  </font> 
  </a>
</td>
  
</tr></table>
</td>
<td width="5%" align="right">
  <table summary="segment navigation pre/next" border="0" cellpadding="3" cellspacing="0">
<tr>
<td align="center" bgcolor="#ffffff">
  <a href="managing-a-configuration.en.html" target="_top" >
    <img border="0" width="22" height="22" src="../_sisu/image_sys/arrow_prev_red.png" alt="&lt;&lt;&nbsp;previous" />
  </a>
</td>
<td align="center" bgcolor="#ffffff">
  <a href="toc.en.html" target="_top" >
    <img border="0" width="22" height="22" src="../_sisu/image_sys/arrow_up_red.png" alt="TOC" />
  </a>
</td>
<td align="center" bgcolor="#ffffff">
  <a href="customizing-package-installation.en.html" target="_top" >
    <img border="0" width="22" height="22" src="../_sisu/image_sys/arrow_next_red.png" alt="next&nbsp;&gt;&gt;" />
  </a>
</td>
<td>
</td></tr>
</table>
</td></tr>
</table>
<table summary="segment hidden control pre and next" width="100%" border="0" cellpadding="0" bgcolor=#eeeeee align="center">
<tr><td align="left">
  <a href="managing-a-configuration.en.html" target="_top" >
    <img border="0" width="100%" height="20" src="../_sisu/image_sys/dot_white.png" alt="&lt;" />
  </a>
</td>
<td align="center">
  <a href="toc.en.html" target="_top" >
    <img border="0" width="100%" height="20" src="../_sisu/image_sys/dot_white.png" alt="&#094;" />
  </a>
</td>
<td align="right">
  <a href="customizing-package-installation.en.html" target="_top" >
    <img border="0" width="100%" height="20" src="../_sisu/image_sys/dot_white.png" alt="&gt;" />
  </a>
</td></tr>
</table><div class="content">
<h1 class="tiny">
    Debian Live Manual
  </h1>
</div><div class="content">
<h2 class="tiny">
    User
  </h2>
</div><div class="content"><div class="substance">
  <label class="ocn"><a name="327" href="#327" class="lnkocn">327</a></label>
  <h1 class="norm" id="o327"><a name="327"></a>
    7. Customization overview
  </h1>
</div><div class="substance">
  <label class="ocn"><a name="328" href="#328" class="lnkocn">328</a></label>
  <p class="i0" id="o328">
    This chapter gives an overview of the various ways in which you may customize a Debian Live system.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="329" href="#329" class="lnkocn">329</a></label>
  <p class="bold" id="o329"><a name="329"></a> <a name="h7.1" id="h7.1"></a>
    <a name="7.1" ></a><a name="h7.1" ></a>7.1 Build time vs. boot time configuration
  </p>
</div><div class="substance">
  <label class="ocn"><a name="330" href="#330" class="lnkocn">330</a></label>
  <p class="i0" id="o330">
    Live system configuration options are divided into build-time options which are options that are applied at build time and boot-time options which are applied at boot time. Boot-time options are further divided into those occurring early in the boot, applied by the <i>live-boot</i> package, and those that happen later in the boot, applied by <i>live-config</i>. Any boot-time option may be modified by the user by specifying it at the boot prompt. The image may also be built with default boot parameters so users can normally just boot directly to the live system without specifying any options when all of the defaults are suitable. In particular, the argument to <tt>lb --bootappend-live</tt> consists of any default kernel command line options for the Live system, such as persistence, keyboard layouts, or timezone. See  <a href="customizing-run-time-behaviours.html#customizing-locale-and-language">Customizing locale and language</a>,  for example.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="331" href="#331" class="lnkocn">331</a></label>
  <p class="i0" id="o331">
    Build-time configuration options are described in the <tt>lb config</tt> man page. Boot-time options are described in the man pages for <i>live-boot</i> and <i>live-config</i>. Although the <i>live-boot</i> and <i>live-config</i> packages are installed within the live system you are building, it is recommended that you also install them on your build system for easy reference when you are working on your configuration. It is safe to do so, as none of the scripts contained within them are executed unless the system is configured as a live system.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="332" href="#332" class="lnkocn">332</a></label>
  <p class="bold" id="o332"><a name="332"></a> <a name="hstages-of-the-build" id="hstages-of-the-build"></a>
    <a name="h7.2" ></a><a name="stages-of-the-build" ></a>7.2 Stages of the build
  </p>
</div><div class="substance">
  <label class="ocn"><a name="333" href="#333" class="lnkocn">333</a></label>
  <p class="i0" id="o333">
    The build process is divided into stages, with various customizations applied in sequence in each. The first stage to run is the <b>bootstrap</b> stage. This is the initial phase of populating the chroot directory with packages to make a barebones Debian system. This is followed by the <b>chroot</b> stage, which completes the construction of chroot directory, populating it with all of the packages listed in the configuration, along with any other materials. Most customization of content occurs in this stage. The final stage of preparing the live image is the <b>binary</b> stage, which builds a bootable image, using the contents of the chroot directory to construct the root filesystem for the Live system, and including the installer and any other additional material on the target media outside of the Live system's filesystem. After the live image is built, if enabled, the source tarball is built in the <b>source</b> stage.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="334" href="#334" class="lnkocn">334</a></label>
  <p class="i0" id="o334">
    Within each of these stages, there is a particular sequence in which commands are applied. These are arranged in such a way as to ensure customizations can be layered in a reasonable fashion. For example, within the <b>chroot</b> stage, preseeds are applied before any packages are installed, packages are installed before any locally included files or patches are applied, and hooks are run later, after all of the materials are in place.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="335" href="#335" class="lnkocn">335</a></label>
  <p class="bold" id="o335"><a name="335"></a> <a name="h7.3" id="h7.3"></a>
    <a name="7.3" ></a><a name="h7.3" ></a>7.3 Supplement lb config with files
  </p>
</div><div class="substance">
  <label class="ocn"><a name="336" href="#336" class="lnkocn">336</a></label>
  <p class="i0" id="o336">
    Although <tt>lb config</tt> does create a skeletal configuration in the config/ directory, to accomplish your goals, you may need to provide additional files in subdirectories of config/. Depending on where the files are stored in the configuration, they may be copied into the live system's filesystem or into the binary image filesystem, or may provide build-time configurations of the system that would be cumbersome to pass as command-line options. You may include things such as custom lists of packages, custom artwork, or hook scripts to run either at build time or at boot time, boosting the already considerable flexibility of debian-live with code of your own.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="337" href="#337" class="lnkocn">337</a></label>
  <p class="bold" id="o337"><a name="337"></a> <a name="h7.4" id="h7.4"></a>
    <a name="7.4" ></a><a name="h7.4" ></a>7.4 Customization tasks
  </p>
</div><div class="substance">
  <label class="ocn"><a name="338" href="#338" class="lnkocn">338</a></label>
  <p class="i0" id="o338">
    The following chapters are organized by the kinds of customization task users typically perform:  <a href="customizing-package-installation.html#customizing-package-installation">Customizing package installation</a>,   <a href="customizing-contents.html#customizing-contents">Customizing contents</a>  and  <a href="customizing-run-time-behaviours.html#customizing-locale-and-language">Customizing locale and language</a>  cover just a few of the things you might want to do.
  </p>
</div></div><br /><div class="main_column">
  <table summary="segment navigation band" bgcolor="#ffffff" width="100%"><tr>
  <td width="70%" align="center">
    
<table summary="segment navigation available documents types: toc,doc,pdf,concordance" border="0" cellpadding="3" cellspacing="0">
<tr>
<td align="center" bgcolor="#ffffff">
  <td align="center" bgcolor="#ffffff">
  <a href="sisu_manifest.en.html" target="_top" >
      <font face="verdana, arial, georgia, tahoma, sans-serif, helvetica, times, roman" size="2">
    [&nbsp;document&nbsp;manifest&nbsp;]
  </font> 
  </a>
</td>
  
</tr></table>
  </td>
  <td width="5%" align="right">
    <table summary="segment navigation pre/next" border="0" cellpadding="3" cellspacing="0">
<tr>
<td align="center" bgcolor="#ffffff">
  <a href="managing-a-configuration.en.html" target="_top" >
    <img border="0" width="22" height="22" src="../_sisu/image_sys/arrow_prev_red.png" alt="&lt;&lt;&nbsp;previous" />
  </a>
</td>
<td align="center" bgcolor="#ffffff">
  <a href="toc.en.html" target="_top" >
    <img border="0" width="22" height="22" src="../_sisu/image_sys/arrow_up_red.png" alt="TOC" />
  </a>
</td>
<td align="center" bgcolor="#ffffff">
  <a href="customizing-package-installation.en.html" target="_top" >
    <img border="0" width="22" height="22" src="../_sisu/image_sys/arrow_next_red.png" alt="next&nbsp;&gt;&gt;" />
  </a>
</td>
<td>
</td></tr>
</table>
  </td></tr>
  </table>
  <table summary="segment hidden control pre and next" width="100%" border="0" cellpadding="0" bgcolor=#eeeeee align="center">
<tr><td align="left">
  <a href="managing-a-configuration.en.html" target="_top" >
    <img border="0" width="100%" height="20" src="../_sisu/image_sys/dot_white.png" alt="&lt;" />
  </a>
</td>
<td align="center">
  <a href="toc.en.html" target="_top" >
    <img border="0" width="100%" height="20" src="../_sisu/image_sys/dot_white.png" alt="&#094;" />
  </a>
</td>
<td align="right">
  <a href="customizing-package-installation.en.html" target="_top" >
    <img border="0" width="100%" height="20" src="../_sisu/image_sys/dot_white.png" alt="&gt;" />
  </a>
</td></tr>
</table>
</div><div class="main_column">


<a name="bottom" id="bottom"></a>
<a name="down" id="down"></a>
<a name="end" id="end"></a>
<a name="finish" id="finish"></a>
<a name="stop" id="stop"></a>
<a name="credits" id="credits"></a>
</div></div></body>
</html>