This file is indexed.

/usr/share/doc/live-manual/html/customizing-contents.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
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
<!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>
    customizing-contents -
    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="customizing-package-installation.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-run-time-behaviours.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="customizing-package-installation.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-run-time-behaviours.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="456" href="#456" class="lnkocn">456</a></label>
  <h1 class="norm" id="o456"><a name="456"></a>
    9. Customizing contents
  </h1>
</div><div class="substance">
  <label class="ocn"><a name="457" href="#457" class="lnkocn">457</a></label>
  <p class="i0" id="o457">
    This chapter discusses fine-tuning customization of the live system contents beyond merely choosing which packages to include. Includes allow you to add or replace arbitrary files in your Debian Live image, hooks allow you to execute arbitrary commands at different stages of the build and at boot time, and preseeding allows you to configure packages when they are installed by supplying answers to debconf questions.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="458" href="#458" class="lnkocn">458</a></label>
  <p class="bold" id="o458"><a name="458"></a> <a name="h9.1" id="h9.1"></a>
    <a name="9.1" ></a><a name="h9.1" ></a>9.1 Includes
  </p>
</div><div class="substance">
  <label class="ocn"><a name="459" href="#459" class="lnkocn">459</a></label>
  <p class="i0" id="o459">
    While ideally a Debian live system would include files entirely provided by unmodified Debian packages, it is sometimes convenient to provide or modify some content by means of files. Using includes, it is possible to add (or replace) arbitrary files in your Debian Live image. <i>live-build</i> provides three mechanisms for using them:
  </p>
</div><div class="substance">
  <label class="ocn"><a name="460" href="#460" class="lnkocn">460</a></label>
  <li class="bullet" id="o460">
    Chroot local includes: These allow you to add or replace files to the chroot/Live filesystem. Please see  <a href="customizing-contents.html#live-chroot-local-includes">Live/chroot local includes</a>  for more information.
  </li>
</div><div class="substance">
  <label class="ocn"><a name="461" href="#461" class="lnkocn">461</a></label>
  <li class="bullet" id="o461">
    Binary local includes: These allow you to add or replace files in the binary image. Please see  <a href="customizing-contents.html#binary-local-includes">Binary local includes</a>  for more information.
  </li>
</div><div class="substance">
  <label class="ocn"><a name="462" href="#462" class="lnkocn">462</a></label>
  <li class="bullet" id="o462">
    Binary includes: These allow you to add or replace Debian specific files in the binary image, such as the templates and tools directories. Please see  <a href="customizing-contents.html#binary-includes">Binary includes</a>  for more information.
  </li>
</div><div class="substance">
  <label class="ocn"><a name="463" href="#463" class="lnkocn">463</a></label>
  <p class="i0" id="o463">
    Please see  <a href="about-manual.html#terms">Terms</a>  for more information about the distinction between the "Live" and "binary" images.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="464" href="#464" class="lnkocn">464</a></label>
  <p class="bold" id="o464"><a name="464"></a> <a name="hlive-chroot-local-includes" id="hlive-chroot-local-includes"></a>
    <a name="h9.1.1" ></a><a name="live-chroot-local-includes" ></a>9.1.1 Live/chroot local includes
  </p>
</div><div class="substance">
  <label class="ocn"><a name="465" href="#465" class="lnkocn">465</a></label>
  <p class="i0" id="o465">
    Chroot local includes can be used to add or replace files in the chroot/Live filesystem so that they may be used in the Live system. A typical use is to populate the skeleton user directory (<tt>/etc/skel</tt>) used by the Live system to create the live user's home directory. Another is to supply configuration files that can be simply added or replaced in the image without processing; see  <a href="customizing-contents.html#live-chroot-local-hooks">Live/chroot local hooks</a>  if processing is needed.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="466" href="#466" class="lnkocn">466</a></label>
  <p class="i0" id="o466">
    To include files, simply add them to your <tt>config/includes.chroot</tt> directory. This directory corresponds to the root directory (<tt>/</tt>) of the live system. For example, to add a file <tt>/var/www/index.html</tt> in the live system, use:
  </p>
</div><div class="substance">
  <label class="ocn"><a name="467" href="#467" class="lnkocn">467</a></label>
  <p class="code" id="o467">
    $ mkdir -p config/includes.chroot/var/www<br />
$ cp /path/to/my/index.html config/includes.chroot/var/www<br /><br />
  </p>
</div><div class="substance">
  <label class="ocn"><a name="468" href="#468" class="lnkocn">468</a></label>
  <p class="i0" id="o468">
    Your configuration will then have the following layout:
  </p>
</div><div class="substance">
  <label class="ocn"><a name="469" href="#469" class="lnkocn">469</a></label>
  <p class="code" id="o469">
    -- config<br />
&nbsp;&nbsp;&nbsp;&nbsp;[...]<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-- includes.chroot<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;`-- var<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`-- www<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`-- index.html<br />
&nbsp;&nbsp;&nbsp;&nbsp;[...]<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`-- templates<br /><br />
  </p>
</div><div class="substance">
  <label class="ocn"><a name="470" href="#470" class="lnkocn">470</a></label>
  <p class="i0" id="o470">
    Chroot local includes are installed after package installation so that files installed by packages are overwritten.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="471" href="#471" class="lnkocn">471</a></label>
  <p class="bold" id="o471"><a name="471"></a> <a name="hbinary-local-includes" id="hbinary-local-includes"></a>
    <a name="h9.1.2" ></a><a name="binary-local-includes" ></a>9.1.2 Binary local includes
  </p>
</div><div class="substance">
  <label class="ocn"><a name="472" href="#472" class="lnkocn">472</a></label>
  <p class="i0" id="o472">
    To include material such as documentation or videos on the media filesystem so that it is accessible immediately upon insertion of the media without booting the Live system, you can use binary local includes. This works in a similar fashion to chroot local includes. For example, suppose the files <tt>~/video_demo.*</tt> are demo videos of the live system described by and linked to by an HTML index page. Simply copy the material to <tt>config/includes.binary/</tt> as follows:
  </p>
</div><div class="substance">
  <label class="ocn"><a name="473" href="#473" class="lnkocn">473</a></label>
  <p class="code" id="o473">
    $ cp ~/video_demo.* config/includes.binary/<br /><br />
  </p>
</div><div class="substance">
  <label class="ocn"><a name="474" href="#474" class="lnkocn">474</a></label>
  <p class="i0" id="o474">
    These files will now appear in the root directory of the live media.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="475" href="#475" class="lnkocn">475</a></label>
  <p class="bold" id="o475"><a name="475"></a> <a name="hbinary-includes" id="hbinary-includes"></a>
    <a name="h9.1.3" ></a><a name="binary-includes" ></a>9.1.3 Binary includes
  </p>
</div><div class="substance">
  <label class="ocn"><a name="476" href="#476" class="lnkocn">476</a></label>
  <p class="i0" id="o476">
    <i>live-build</i> has some standard files (like documentation) that gets included in the default configuration on every live media. This can be disabled with:
  </p>
</div><div class="substance">
  <label class="ocn"><a name="477" href="#477" class="lnkocn">477</a></label>
  <p class="code" id="o477">
    $ lb config --includes none<br /><br />
  </p>
</div><div class="substance">
  <label class="ocn"><a name="478" href="#478" class="lnkocn">478</a></label>
  <p class="i0" id="o478">
    Otherwise, the material will be installed by <i>live-build</i> in <tt>/includes/</tt> by default on the media filesystem, or else you can specify an alternate path with <tt>--includes</tt>.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="479" href="#479" class="lnkocn">479</a></label>
  <p class="bold" id="o479"><a name="479"></a> <a name="h9.2" id="h9.2"></a>
    <a name="9.2" ></a><a name="h9.2" ></a>9.2 Hooks
  </p>
</div><div class="substance">
  <label class="ocn"><a name="480" href="#480" class="lnkocn">480</a></label>
  <p class="i0" id="o480">
    Hooks allow commands to be performed in the chroot and binary stages of the build in order to customize the image.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="481" href="#481" class="lnkocn">481</a></label>
  <p class="bold" id="o481"><a name="481"></a> <a name="hlive-chroot-local-hooks" id="hlive-chroot-local-hooks"></a>
    <a name="h9.2.1" ></a><a name="live-chroot-local-hooks" ></a>9.2.1 Live/chroot local hooks
  </p>
</div><div class="substance">
  <label class="ocn"><a name="482" href="#482" class="lnkocn">482</a></label>
  <p class="i0" id="o482">
    To run commands in the chroot stage, create a hook script with a <tt>.chroot</tt> suffix containing the commands in the <tt>config/hooks/</tt> directory. The hook will run in the chroot after the rest of your chroot configuration has been applied, so remember to ensure your configuration includes all packages and files your hook needs in order to run. See the example chroot hook scripts for various common chroot customization tasks provided in <tt>/usr/share/live/build/examples/hooks</tt> which you can copy or symlink to use them in your own configuration.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="483" href="#483" class="lnkocn">483</a></label>
  <p class="bold" id="o483"><a name="483"></a> <a name="hboot-time-hooks" id="hboot-time-hooks"></a>
    <a name="h9.2.2" ></a><a name="boot-time-hooks" ></a>9.2.2 Boot-time hooks
  </p>
</div><div class="substance">
  <label class="ocn"><a name="484" href="#484" class="lnkocn">484</a></label>
  <p class="i0" id="o484">
    To execute commands at boot time, you can supply <i>live-config</i> hooks as explained in the "Customization" section of its man page. Examine <i>live-config</i>' s own hooks provided in <tt>/lib/live/config/</tt>, noting the sequence numbers. Then provide your own hook prefixed with an appropriate sequence number, either as a chroot local include in <tt>config/includes.chroot/lib/live/config/</tt>, or as a custom package as discussed in  <a href="customizing-package-installation.html#installing-modified-or-third-party-packages">Installing modified or third-party packages</a>.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="485" href="#485" class="lnkocn">485</a></label>
  <p class="bold" id="o485"><a name="485"></a> <a name="h9.2.3" id="h9.2.3"></a>
    <a name="9.2.3" ></a><a name="h9.2.3" ></a>9.2.3 Binary local hooks
  </p>
</div><div class="substance">
  <label class="ocn"><a name="486" href="#486" class="lnkocn">486</a></label>
  <p class="i0" id="o486">
    To run commands in the binary stage, create a hook script with a <tt>.binary</tt> suffix containing the commands in the <tt>config/hooks/</tt> directory. The hook will run after all other binary commands are run, but before binary_checksums, the very last binary command. The commands in your hook do not run in the chroot, so take care to not modify any files outside of the build tree, or you may damage your build system! See the example binary hook scripts for various common binary customization tasks provided in <tt>/usr/share/live/build/examples/hooks</tt> which you can copy or symlink to use them in your own configuration.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="487" href="#487" class="lnkocn">487</a></label>
  <p class="bold" id="o487"><a name="487"></a> <a name="h9.3" id="h9.3"></a>
    <a name="9.3" ></a><a name="h9.3" ></a>9.3 Preseeding Debconf questions
  </p>
</div><div class="substance">
  <label class="ocn"><a name="488" href="#488" class="lnkocn">488</a></label>
  <p class="i0" id="o488">
    Files in the <tt>config/preseed/</tt> directory suffixed with <tt>.preseed</tt> followed by the stage (<tt>.chroot</tt> or <tt>.binary</tt>) are considered to be debconf preseed files and are installed by <i>live-build</i> using <tt>debconf-set-selections</tt> during the corresponding stage.
  </p>
</div><div class="substance">
  <label class="ocn"><a name="489" href="#489" class="lnkocn">489</a></label>
  <p class="i0" id="o489">
    For more information about debconf, please see debconf(7) in the <tt>debconf</tt> package.
  </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="customizing-package-installation.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-run-time-behaviours.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="customizing-package-installation.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-run-time-behaviours.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>