summaryrefslogtreecommitdiff
path: root/manpages/de/lb_config.de.1
blob: caae24aa2823b0de8116c043c4317d1bdb8a22e1 (plain)
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
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH LIVE\-BUILD 1 2011\-07\-28 3.0~a25 "Debian Live Project"

.SH NAME
\fBlb config\fP \- Create config directory

.SH SYNOPSIS
\fBlb config\fP [\fIlive\-build options\fP]
.PP
.\" FIXME
\fBlb config\fP
.br
  [\fB\-\-apt\fP apt|aptitude]
.br
  [\fB\-\-apt\-ftp\-proxy\fP \fIURL\fP]
.br
  [\fB\-\-apt\-http\-proxy\fP \fIURL\fP]
.br
  [\fB\-\-apt\-indices\fP true|false|none]
.br
  [\fB\-\-apt\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"]
.br
  [\fB\-\-aptitude\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"]
.br
  [\fB\-\-apt\-pipeline\fP \fIDEPTH\fP]
.br
  [\fB\-\-apt\-recommends\fP true|false]
.br
  [\fB\-\-apt\-secure\fP true|false]
.br
  [\-a|\fB\-\-architectures\fP \fIARCHITECTURE\fP]
.br
  [\-b|\fB\-\-binary\-images\fP iso|iso\-hybrid|net|tar|usb\-hdd|virtual\-hdd]
.br
  [\fB\-\-binary\-filesystem\fP fat16|fat32|ext2]
.br
  [\fB\-\-bootappend\-install\fP \fIPARAMETER\fP|\fI"PARAMETERS"\fP]
.br
  [\fB\-\-bootappend\-live\fP \fIPARAMETER\fP|\fI"PARAMETERS"\fP]
.br
  [\fB\-\-bootloader\fP grub|syslinux|yaboot]
.br
  [\fB\-\-bootstrap\fP cdebootstrap|cdebootstrap\-static|debootstrap|copy]
.br
  [\-f|\fB\-\-bootstrap\-flavour\fP minimal|standard]
.br
  [\fB\-\-bootstrap\-keyring\fP \fIPACKAGE\fP]
.br
  [\fB\-\-cache\fP true|false]
.br
  [\fB\-\-cache\-indices\fP true|false]
.br
  [\fB\-\-cache\-packages\fP true|false]
.br
  [\fB\-\-cache\-stages\fP \fISTAGE\fP|\fI"STAGES"\fP]
.br
  [\fB\-\-checksums\fP md5|sha1|sha256|none]
.br
  [\fB\-\-compression\fP bzip2|gzip|lzip|none]
.br
  [\fB\-\-build\-with\-chroot\fP true|false]
.br
  [\fB\-\-chroot\-filesystem\fP ext2|ext3|squashfs|plain|jffs2]
.br
  [\fB\-\-clean\fP]
.br
  [\-c|\fB\-\-conffile\fP \fIFILE\fP]
.br
  [\fB\-\-debconf\-frontend\fP dialog|editor|noninteractive|readline]
.br
  [\fB\-\-debconf\-nowarnings\fP true|false]
.br
  [\fB\-\-debconf\-priority\fP low|medium|high|critical]
.br
  [\fB\-\-debian\-installer\fP true|cdrom|netinst|netboot|businesscard|live|false]
.br
  [\fB\-\-debian\-installer\-distribution\fP daily|\fICODENAME\fP]
.br
  [\fB\-\-debian\-installer\-preseedfile\fP \fIFILE\fP|\fIURL\fP]
.br
  [\fB\-\-debian\-installer\-gui\fP true|false]
.br
  [\fB\-\-debug\fP]
.br
  [\-d|\fB\-\-distribution\fP \fICODENAME\fP]
.br
  [\fB\-\-parent\-distribution\fP \fICODENAME\fP]
.br
  [\fB\-\-parent\-debian\-installer\-distribution\fP \fICODENAME\fP]
.br
  [\fB\-\-dump\fP]
.br
  [\fB\-\-fdisk\fP fdisk|fdisk.dist]
.br
  [\fB\-\-force\fP]
.br
  [\fB\-\-grub\-splash\fP \fIFILE\fP]
.br
  [\fB\-\-gzip\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"]
.br
  [\fB\-\-hooks\fP \fIFILE\fP]
.br
  [\fB\-\-hostname\fP \fINAME\fP]
.br
  [\fB\-\-ignore\-system\-defaults\fP]
.br
  [\fB\-\-includes\fP \fIPATH\fP]
.br
  [\fB\-\-initramfs\fP auto|none|live\-boot|casper]
.br
  [\fB\-\-initramfs\-compression\fP bzip2|gzip|lzma]
.br
  [\fB\-\-initsystem\fP sysvinit|runit|systemd|upstart|none]
.br
  [\fB\-\-interactive\fP shell]
.br
  [\fB\-\-isohybrid\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"]
.br
  [\fB\-\-iso\-application\fP \fINAME\fP]
.br
  [\fB\-\-iso\-preparer\fP \fINAME\fP]
.br
  [\fB\-\-iso\-publisher\fP \fINAME\fP]
.br
  [\fB\-\-iso\-volume\fP \fINAME\fP]
.br
  [\fB\-\-jffs2\-eraseblock\fP \fISIZE\fP]
.br
  [\fB\-\-keyring\-packages\fP \fIPACKAGE|"PACKAGES"\fP]
.br
  [\-l|\fB\-\-language\fP \fILANGUAGE\fP]
.br
  [\-k|\fB\-\-linux\-flavours\fP \fIFLAVOUR\fP|\fI"FLAVOURS"\fP]
.br
  [\fB\-\-linux\-packages\fP \fI"PACKAGES"\fP]
.br
  [\fB\-\-losetup\fP losetup|losetup.orig]
.br
  [\fB\-\-memtest\fP memtest86+|memtest86|none]
.br
  [\-m|\fB\-\-parent\-mirror\-bootstrap\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-chroot\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-chroot\-security\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-chroot\-volatile\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-chroot\-backports\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-binary\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-binary\-security\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-binary\-volatile\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-binary\-backports\fP \fIURL\fP]
.br
  [\fB\-\-parent\-mirror\-debian\-installer\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-bootstrap\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-chroot\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-chroot\-security\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-chroot\-volatile\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-chroot\-backports\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-binary\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-binary\-security\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-binary\-volatile\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-binary\-backports\fP \fIURL\fP]
.br
  [\fB\-\-mirror\-debian\-installer\fP \fIURL\fP]
.br
  [\fB\-\-mode\fP debian|emdebian|progress|ubuntu|kubuntu]
.br
  [\fB\-\-net\-root\-filesystem\fP nfs|cfs]
.br
  [\fB\-\-net\-root\-mountoptions\fP \fIOPTIONS\fP]
.br
  [\fB\-\-net\-root\-path\fP \fIPATH\fP]
.br
  [\fB\-\-net\-root\-server\fP \fIIP\fP|\fIHOSTNAME\fP]
.br
  [\fB\-\-net\-cow\-filesystem\fP nfs|cfs]
.br
  [\fB\-\-net\-cow\-mountoptions\fP \fIOPTIONS\fP]
.br
  [\fB\-\-net\-cow\-path\fP \fIPATH\fP]
.br
  [\fB\-\-net\-cow\-server\fP \fIIP\fP|\fIHOSTNAME\fP]
.br
  [\fB\-\-net\-tarball\fP true|false]
.br
  [\-p|\fB\-\-package\-lists\fP \fILIST\fP|\fI"LISTS"\fP]
.br
  [\fB\-\-quiet\fP]
.br
  [\fB\-\-root\-command\fP sudo]
.br
  [\fB\-\-use\-fakeroot\fP true|false]
.br
  [\fB\-\-archives\fP \fIARCHIVE\fP|\fI"ARCHIVES"\fP]
.br
  [\fB\-\-archive\-areas\fP \fIARCHIVE_AREA\fP|\fI"ARCHIVE_AREAS"\fP]
.br
  [\fB\-\-security\fP true|false]
.br
  [\fB\-\-source\fP true|false]
.br
  [\-s|\fB\-\-source\-images\fP iso|net|tar|usb\-hdd]
.br
  [\fB\-\-syslinux\-splash\fP \fIFILE\fP]
.br
  [\fB\-\-syslinux\-timeout\fP \fISECONDS\fP]
.br
  [\fB\-\-syslinux\-menu\fP true|false]
.br
  [\fB\-\-tasksel\fP apt|aptitude|tasksel]
.br
  [\fB\-\-templates\fP \fIPATH\fP]
.br
  [\fB\-\-virtual\-root\-size \fP\fIMB\fP]
.br
  [\fB\-\-volatile\fP true|false]
.br
  [\fB\-\-backports\fP true|false]
.br
  [\fB\-\-exposed\-root\fP true|false]
.br
  [\fB\-\-username\fP \fINAME\fP]
.br
  [\fB\-\-verbose\fP]
.br
.\" FIXME
  [\fB\-\-win32\-loader true|false]\fP

.SH DESCRIPTION
\fBlb config\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the
Debian Live tool suite.
.PP
.\" FIXME
\fBlb config\fP populates the configuration directory for live\-build. By
default, this directory is named 'config' and is created in the current
directory where \fBlb config\fP was executed.
.PP
.\" FIXME
Note: Currently \fBlb config\fP tries to be smart and sets defaults for some
options depending on the setting of other options (e.g. which linux packages
to be used depending on if a squeeze system gets build or not). This means
that when generating a new configuration, you should call \fBlb config\fP only
once with all options specified. Calling it several times with only a subset
of the options each can result in non working configurations. This is also
caused by the fact that \fBlb config\fP called with one option only changes
that option, and leaves everything else as is unless its not
defined. However, \fBlb config\fP does warn about know impossible or likely
impossible combinations that would lead to non working live systems. If
unsure, remove config/{binary,bootstrap,chroot,common,source} and call \fBlb
config\fP again.

.SH OPTIONS
In addition to its specific options \fBlb config\fP understands all generic
live\-build options. See \fIlive\-build\fP(7) for a complete list of all generic
live\-build options.
.PP
.\" FIXME
.IP "\fB\-\-apt\fP apt|aptitude" 4
defines if apt\-get or aptitude is used to install packages when building the
image. The default is apt.
.IP "\fB\-\-apt\-ftp\-proxy\fP \fIURL\fP" 4
sets the ftp proxy to be used by apt. By default, this is empty but if the
host has the environment variable ftp_proxy set, apt\-ftp\-proxy gets
automatically set to the value of ftp_proxy.
.IP "\fB\-\-apt\-http\-proxy\fP \fIURL\fP" 4
sets the http proxy to be used by apt. By default, this is empty but if the
host has the environment variable http_proxy set, apt\-http\-proxy gets
automatically set to the value of http_proxy.
.IP "\fB\-\-apt\-indices\fP true|false|none" 4
defines if the resulting images should have apt indices or not and defaults
to true. If set to none, no indices are included at all.
.IP "\fB\-\-apt\-options\fP \fIOPTION\fP|\(dq\fIOPTIONS\fP\(dq" 4
defines the default options that will be appended to every apt call that is
made inside chroot during the building of the image. By default, this is set
to \-\-yes to allow non\-interactive installation of packages.
.IP "\fB\-\-aptitude\-options\fP \fIOPTION\fP|\(dq\fIOPTIONS\fP\(dq" 4
defines the default options that will be appended to every aptitude call
that is made inside chroot during building of the image. By default, this is
set to \-\-assume\-yes to allow non\-interactive installation of packages.
.IP "\fB\-\-apt\-pipeline\fP \fIDEPTH\fP" 4
sets the depth of the apt/aptitude pipeline. In cases where the remote
server is not RFC conforming or buggy (such as Squid 2.0.2) this option can
be a value from 0 to 5 indicating how many outstanding requests APT should
send. A value of zero MUST be specified if the remote host does not properly
linger on TCP connections \- otherwise data corruption will occur. Hosts
which require this are in violation of RFC 2068. By default, live\-build does
not set this option.
.IP "\fB\-\-apt\-recommends\fP true|false" 4
defines if apt should install recommended packages automatically. By
default, this is true except in emdebian mode.
.IP "\fB\-\-apt\-secure\fP true|false" 4
defines if apt should check repository signatures. This is true by default.
.IP "\-a|\fB\-\-architectures\fP \fIARCHITECTURE\fP" 4
defines the architecture of the to be build image. By default, this is set
to the host architecture. Note that you cannot crossbuild for another
architecture if your host system is not able to execute binaries for the
target architecture natively. For example, building amd64 images on i386 and
vice versa is possile if you have a 64bit capable i386 processor and the
right kernel. But building powerpc images on an i386 system is not possible.
.IP "\-b|\fB\-\-binary\-images\fP iso|iso\-hybrid|net|tar|usb\-hdd" 4
defines the image type to build. By default, for images using syslinux this
is set to iso\-hybrid to build CD/DVD images that may also be used like
usb\-hdd images, for non\-syslinux images, it defaults to iso.
.IP "\fB\-\-binary\-filesystem\fP fat16|fat32|ext2" 4
defines the filesystem to be used in the image type. This only has an effect
if the selected binary image type does allow to choose a filesystem. For
example, when selection iso the resulting CD/DVD has always the filesystem
ISO9660. When building usb\-hdd images for usb sticks, this is active. Note
that it defaults to fat16 on all architectures except sparc where it
defaults to ext2. Also note that if you choose fat16 and your resulting
binary image gets bigger than 2GB, the binary filesystem automatically gets
switched to fat32.
.IP "\fB\-\-bootappend\-install\fP \fIPARAMETER\fP|\(dq\fIPARAMETERS\fP\(dq" 4
sets boot parameters specific to debian\-installer, if included.
.IP "\fB\-\-bootappend\-live\fP \fIPARAMETER\fP|\(dq\fIPARAMETERS\fP\(dq" 4
sets boot parameters specific to debian\-live. A complete list of boot
parameters can be found, for etch, in the manpage of casper, for all other
distributions in the manpage of live\-boot and live\-config. On the images, a
list of all parameters (without comments) is included in the
/parameters.txt.
.IP "\fB\-\-bootloader\fP grub|syslinux|yaboot" 4
defines which bootloader is beeing used in the generated image. This has
only an effect if the selected binary image type does allow to choose the
bootloader. For example, if you build a iso, always syslinux (or more
precise, isolinux) is being used. Also note that some combinations of binary
images types and bootloaders may be possible but live\-build does not support
them yet. \fBlb config\fP will fail to create such a not yet supported
configuration and give a explanation about it. For usb\-hdd images on amd64
and i386, the default is syslinux. yaboot is only used on powerpc.
.IP "\fB\-\-bootstrap\fP cdebootstrap|cdebootstrap\-static|debootstrap|copy" 4
defines which program is used to bootstrap the debian chroot, default is
debootstrap. Note that if you set the bootstrap program to copy, then your
host system is copied. This can be useful if you want to convert/clone your
existing host system into a live system, however, make sure you do have
enough free space as this can, depending on your host system, get quite big.
.IP "\-f|\fB\-\-bootstrap\-flavour\fP minimal|standard" 4
defines if the bootstrap program should bootstrap the standard system (all
packages of priority required and important, which is the default) or a
minimal system (only packages of priority required, plus apt).
.IP "\fB\-\-bootstrap\-keyring\fP \fIPACKAGE\fP" 4
sets the archive keyring package to be used. Default is
debian\-archive\-keyring.
.IP "\fB\-\-cache\fP true|false" 4
defines globally if any cache should be used at all. Different caches can be
controled through the their own options.
.IP "\fB\-\-cache\-indices\fP true|false" 4
defines if downloaded package indices and lists should be cached which is
false by default. Enabling it would allow to rebuild an image completely
offline, however, you would not get updates anymore then.
.IP "\fB\-\-cache\-packages\fP true|false" 4
defines if downloaded packages files should be cached which is true by
default. Disabling it does save space consumtion in your build directory,
but remember that you will cause much unnecessary traffic if you do a couple
of rebuilds. In general you should always leave it true, however, in some
particular rare build setups, it can be faster to refetch packages from the
local network mirror rather than to utilize the local disk.
.IP "\fB\-\-cache\-stages\fP true|false|\fISTAGE\fP|\(dq\fISTAGES\fP\(dq" 4
sets which stages should be cached. By default set to bootstrap. As an
exception to the normal stage names, also rootfs can be used here which does
only cache the generated root filesystem in
filesystem.{dir,ext*,squashfs}. This is useful during development if you
want to rebuild the binary stage but not regenerate the root filesystem all
the time.
.IP "\fB\-\-checksums\fP md5|sha1|sha256|none" 4
defines if the binary image should contain a file called md5sums.txt,
sha1sums.txt and/or sha256sums.txt. These lists all files on the image
together with their checksums. This in turn can be used by live\-boots
built\-in integrity\-check to verify the medium if specified at boot
prompt. In general, this should not be false and is an important feature of
live system released to the public. However, during development of very big
images it can save some time by not calculating the checksums.
.IP "\fB\-\-compression\fP bzip2|gzip|lzip|none" 4
defines the compression program to be used to compress tarballs. Defaults to
gzip.
.IP "\fB\-\-build\-with\-chroot\fP true|false" 4
defines whetever live\-build should use the tools from within the chroot to
build the binary image or not by using and including the host systems
tools. This is a very dangerous option, using the tools of the host system
can lead to tainted and even non\-bootable images if the host systems version
of the required tools (mainly these are the bootloaders such as syslinux,
grub and yaboot, and the auxilliary tools such as dosfstools, genisoimage,
squashfs\-tools and others) do not \fBexactely\fP match what is present at
build\-time in the target distribution. Never do disable this option unless
you are \fBexactely\fP sure what you are doing and have \fBcompletely\fP\fI
understood its consequences.\fP
.IP "\fB\-\-chroot\-filesystem\fP ext2|ext3|squashfs|plain|jffs2" 4
defines which filesystem type should be used for the root filesystem
image. If you use plain, then no filesystem image is created and the root
filesystem content is copied on the binary image filesystem as flat
files. Depending on what binary filesystem you have choosen, it may not be
possible to build with a plain root filesystem, e.g. fat16/fat32 and plain
don't work as linux does not support to run on them.
.IP \fB\-\-clean\fP 4
minimizes config directory by automatically removing unused and thus empty
subdirectories.
.IP "\-c|\fB\-\-conffile\fP \fIFILE\fP" 4
using a user specified alternative configuration file in addition to the
normally used one in the config directory.
.IP "\fB\-\-debconf\-frontend\fP dialog|editor|noninteractive|readline" 4
defines what value the debconf frontend should be set to inside the
chroot. Note that setting it to anything by noninteractive, which is the
default, makes your build asking questions during the build.
.IP "\fB\-\-debconf\-nowarnings\fP true|false" 4
defines if warnings of debconf should be displayed or not. Warnings from
debconf are generally very rare and by default, we skipp them, if any, in
order to keep the build process entirely non interactive.
.IP "\fB\-\-debconf\-priority\fP low|medium|high|critical" 4
defines what value the debconf priority shoul dbe set to inside the
chroot. By default, it is set to critical, which means that almost no
questions are displayed. Note that this only has an effect if you use any
debconf frontend different from noninteractive.
.IP "\fB\-\-debian\-installer\fP true|cdrom|netinst|netboot|businesscard|live|false" 4
defines which type, if any, of the debian\-installer should be included in
the resulting binary image. By default, no installer is included. All
available flavours except live are the identical configurations used on the
installer media produced by regular debian\-cd. When live is choosen, the
live\-installer udeb is included so that debian\-installer will behave
different than usual \- instead of installing the debian system from packages
from the medium or the network, it installs the live system to the disk.
.IP "\fB\-\-debian\-installer\-distribution\fP daily|\fICODENAME\fP" 4
defines the distribution where the debian\-installer files should be taken
out from. Normally, this should be set to the same distribution as the live
system. However, some times, one wants to use a newer or even daily built
installer.
.IP "\fB\-\-debian\-installer\-preseedfile\fP \fIFILE\fP|\fIURL\fP" 4
sets the filename or URL for an optionally used and included preseeding file
for debian\-installer.
.IP "\fB\-\-debian\-installer\-gui\fP true|false" 4
defines if the debian\-installer graphical GTK interface should be true or
not. In Debian mode and for most versions of Ubuntu, this option is true,
whereas otherwise false, by default.
.IP \fB\-\-debug\fP 4
turn on debugging informational messages.
.IP "\-d|\fB\-\-distribution\fP \fICODENAME\fP" 4
defines the distribution of the resulting live system.
.IP "\-d|\fB\-\-parent\-distribution\fP \fICODENAME\fP" 4
defines the parent distribution for derivatives of the resulting live
system.
.IP "\-d|\fB\-\-parent\-debian\-installer\-distribution\fP \fICODENAME\fP" 4
defines the parent debian\-installer distribution for derivatives of the
resulting live system.
.IP \fB\-\-dump\fP 4
prepares a report of the currently present live system configuration and the
version of live\-build used. This is useful to provide if you submit bug
reports, we do get all informations required for us to locate and replicate
an error.
.IP "\fB\-\-fdisk\fP fdisk|fdisk.dist" 4
sets the filename of the fdisk binary from the host system that should be
used. This is autodetected and does generally not need any customization.
.IP \fB\-\-force\fP 4
forces re\-execution of already run stages. Use only if you know what you are
doing. It is generally safer to use \fBlb clean\fP to clean up before
re\-executing \fBlb build\fP.
.IP "\fB\-\-grub\-splash\fP \fIFILE\fP" 4
defines the name of an optional to be included splash screen graphic for the
grub bootloader.
.IP "\fB\-\-gzip\-options\fP \fIOPTION\fP|\(dq\fIOPTIONS\fP\(dq" 4
defines the default options that will be appended to (almost) every gzip
call during the building of the image. By default, this is set to \-\-best to
use highest (but slowest) compression. Dynamically, if the host system
supports it, also \-\-rsyncable is added.
.IP "\fB\-\-hooks\fP \fIFILE\fP" 4
defines which hooks available in /usr/share/live/build/examples/hooks should
be activated. Normally, there are no hooks executed. Make sure you know and
understood the hook before you enable it.
.IP "\fB\-\-hostname\fP \fINAME\fP" 4
sets the hostname of the live system.
.IP \fB\-\-ignore\-system\-defaults\fP 4
\fBlb config\fP by default reads system defaults from /etc/live/build.conf and
/etc/live/build.d when generating a new live system config directory. This
is useful if you want to set global settings, such as mirror locations, and
don't want to specify them all of the time.
.IP "\fB\-\-includes\fP \fIPATH|none\fP" 4
sets the path to the includes that live\-build is going to use,
e.g. additional minimal documentation that you want to have on all live
systems. By default, this is set to /usr/share/live/build/includes/. Choose
none to disable inclusion of documentation.
.IP "\fB\-\-initramfs\fP auto|none|live\-boot|casper" 4
sets the name of package that contains the live system specific initramfs
modification. By default, auto is used, which means that at build time of
the image rather than on configuration time, the value will be expanded to
casper when building ubuntu systems, to live\-boot for all other
systems. Using 'none' is useful if the resulting system image should not be
a live image (experimental).
.IP "\fB\-\-initramfs\-compression\fP bzip2|gzip|lzma]"
defines the compression program to be used to compress the
initramfs. Defaults to gzip.
.IP "\fB\-\-interactive\fP shell" 4
defines if after the chroot stage and before the beginning of the binary
stage, a interactive shell login should be spawned in the chroot in order to
allow you to do manual customizations. Once you close the shell with logout
or exit, the build will continue as usual. Note that it's strongly
discouraged to use this for anything else than testing. Modifications that
should be present in all builds of a live system should be properly made
through hooks. Everything else destroys the beauty of being able to
completely automatise the build process and making it non interactive. By
default, this is of course false.
.IP "\fB\-\-isohybrid\-options\fP \fIOPTION\fP|\(dq\fIOPTIONS\fP\(dq" 4
defines options to pass to isohybrid.
.IP "\fB\-\-iso\-application\fP \fINAME\fP" 4
sets the APPLICATION field in the header of a resulting CD/DVD image and
defaults to "Debian Live" in debian mode, and to "Emdebian Live" in emdebian
mode, and "Ubuntu Live" in ubuntu mode.
.IP "\fB\-\-iso\-preparer\fP \fINAME\fP" 4
sets the PREPARER field in the header of a resulting CD/DVD image. By
default this is set to "live\-build \fIVERSION\fP;
http://packages.qa.debian.org/live\-build", whereas VERSION is expanded to
the version of live\-build that was used to build the image.
.IP "\fB\-\-iso\-publisher\fP \fINAME\fP" 4
sets the PUBLISHED field in the header of a resulting CD/DVD image. By
default, this is set to 'Debian Live project; http:/live.debian.net/;
debian\-live@lists.debian.org'. Remember to change this to the appropriate
values at latest when you distributing custom and unofficial images.
.IP "\fB\-\-iso\-volume\fP \fINAME\fP" 4
sets the VOLUME field in the header of a resulting CD/DVD and defaults to
\&'(\fIMODE\fP) (\fIDISTRIBUTION\fP) (\fIDATE\fP)' whereas MODE is expanded to the name
of the mode in use, DISTRIBUTION the distribution name, and DATE with the
current date and time of the generation.
.IP "\fB\-\-jffs2\-eraseblock\fP \fISIZE\fP" 4
sets the eraseblock size for a JFFS2 (Second Journalling Flash File System)
filesystem. The default is 64 KiB. If you use an erase block size different
than the erase block size of the target MTD device, JFFS2 may not perform
optimally. If the SIZE specified is below 4096, the units are assumed to be
KiB.
.IP "\fB\-\-keyring\-packages\fP \fIPACKAGE|\(dqPACKAGES\fP\(dq" 4
sets the keyring package or additional keyring packages. By default this is
set to debian\-archive\-keyring.
.IP "\-l|\fB\-\-language\fP \fILANGUAGE\fP" 4
sets the language of a live system by installing l10n related packages. It
doesn't enable generation of the correct locales through setting the right
boot parameters, those need to be done through the bootappend\-live
parameter.
.IP "\-k|\fB\-\-linux\-flavours\fP \fIFLAVOUR\fP|\(dq\fIFLAVOURS\fP\(dq" 4
sets the kernel flavours to be installed. Note that in case you specify more
than that the first will be configured the default kernel that gets booted.
.IP "\fB\-\-linux\-packages\fP \(dq\fIPACKAGES\fP\(dq" 4
sets the internal name of the kernel packages naming scheme. If you use
debian kernel packages, you will not have to adjust it. If you decide to use
custom kernel packages that do not follow the debian naming scheme, remember
to set this option to the stub of the packages only (for debian this is
linux\-image\-2.6), so that \fISTUB\fP\-\fIFLAVOUR\fP results in a valid package name
(for debian e.g. linux\-image\-2.6\-486). Preferably you use the meta package
name, if any, for the stub, so that your configuration is ABI
independent. Also don't forget that you have to include stubs of the binary
modules packages for unionfs or aufs, and squashfs if you built them
out\-of\-tree.
.IP "\fB\-\-losetup\fP losetup|losetup.orig" 4
sets the filename of the losetup binary from the host system that should be
used. This is autodetected and does generally not need any customization.
.IP "\fB\-\-memtest\fP memtest86+|memtest86|none" 4
defines if memtest, memtest86+ or no memory tester at all should be included
as secondary bootloader configuration. This is only available on amd64 and
i386 and defaults to memtest86+.
.IP "\-m|\fB\-\-parent\-mirror\-bootstrap\fP \fIURL\fP" 4
sets the location of the debian package mirror that should be used to
bootstrap from. This defaults to http://ftp.de.debian.org/debian/ which may
not be a good default if you live outside of Europe.
.IP "\fB\-\-parent\-mirror\-chroot\fP \fIURL\fP" 4
sets the location of the debian package mirror that will be used to fetch
the packages in order to build the live system. By default, this is set to
the value of \-\-parent\-mirror\-bootstrap.
.IP "\fB\-\-parent\-mirror\-chroot\-security\fP \fIURL\fP" 4
sets the location of the debian security package mirror that will be used to
fetch the packages in order to build the live system. By default, this
points to http://security.debian.org/debian/.
.IP "\fB\-\-parent\-mirror\-chroot\-volatile\fP \fIURL\fP" 4
sets the location of the debian volatile package mirror that will be used to
fetch packages in order to build the live system. By default, this is set to
the value of \-\-parent\-mirror\-chroot.
.IP "\fB\-\-parent\-mirror\-chroot\-backports\fP \fIURL\fP" 4
sets the location of the debian backports package mirror that will be used
to fetch packages in order to build the live system. By default, this points
to http://backports.debian.org/debian\-backports/.
.IP "\fB\-\-parent\-mirror\-binary\fP \fIURL\fP" 4
sets the location of the debian package mirror that should end up configured
in the final image and which is the one a user would see and use. This has
not necessarily to be the same that is used to build the image, e.g. if you
use a local mirror but want to have an official mirror in the image. By
default, 'http://cdn.debian.net/debian/' is used.
.IP "\fB\-\-parent\-mirror\-binary\-security\fP \fIURL\fP" 4
sets the location of the debian security package mirror that should end up
configured in the final image. By default,
\&'http://cdn.debian.net/debian\-security/' is used.
.IP "\fB\-\-parent\-mirror\-binary\-volatile\fP \fIURL\fP" 4
sets the location of the debian volatile package mirror that should end up
configured in the final image. By default, the value of
\-\-parent\-mirror\-binary is used.
.IP "\fB\-\-parent\-mirror\-binary\-backports\fP \fIURL\fP" 4
sets the location of the debian backports package mirror that should end up
configured in the final image. By default,
\&'http://backports.debian.org/debian\-backports/' is used.
.IP "\fB\-\-parent\-mirror\-debian\-installer\fP \fIURL\fP" 4
sets the location of the mirror that will be used to fetch the debian
installer images. By default, this points to the same mirror used to build
the live system, i.e. the value of \-\-parent\-mirror\-bootstrap.
.IP "\fB\-\-mirror\-bootstrap\fP \fIURL\fP" 4
sets the location of the debian package mirror that should be used to
bootstrap the derivative from. This defaults to
http://ftp.de.debian.org/debian/ which may not be a good default if you live
outside of Europe.
.IP "\fB\-\-mirror\-chroot\fP \fIURL\fP" 4
sets the location of the debian package mirror that will be used to fetch
the packages of the derivative in order to build the live system. By
default, this is set to the value of \-\-mirror\-bootstrap.
.IP "\fB\-\-mirror\-chroot\-security\fP \fIURL\fP" 4
sets the location of the debian security package mirror that will be used to
fetch the packages of the derivative in order to build the live system. By
default, this points to http://security.debian.org/debian/.
.IP "\fB\-\-mirror\-chroot\-volatile\fP \fIURL\fP" 4
sets the location of the debian volatile package mirror that will be used to
fetch packages of the derivative in order to build the live system. By
default, this is set to the value of \-\-mirror\-chroot.
.IP "\fB\-\-mirror\-chroot\-backports\fP \fIURL\fP" 4
sets the location of the debian backports package mirror that will be used
to fetch packages of the derivative in order to build the live system. By
default, this points to http://backports.debian.org/debian\-backports/.
.IP "\fB\-\-mirror\-binary\fP \fIURL\fP" 4
sets the location of the derivative package mirror that should end up
configured in the final image and which is the one a user would see and
use. This has not necessarily to be the same that is used to build the
image, e.g. if you use a local mirror but want to have an official mirror in
the image.
.IP "\fB\-\-mirror\-binary\-security\fP \fIURL\fP" 4
sets the location of the derivatives security package mirror that should end
up configured in the final image.
.IP "\fB\-\-mirror\-binary\-volatile\fP \fIURL\fP" 4
sets the location of the derivatives volatile package mirror that should end
up configured in the final image.
.IP "\fB\-\-mirror\-binary\-backports\fP \fIURL\fP" 4
sets the location of the derivatives backports package mirror that should
end up configured in the final image.
.IP "\fB\-\-mirror\-debian\-installer\fP \fIURL\fP" 4
sets the location of the mirror that will be used to fetch the debian
installer images of the derivative. By default, this points to the same
mirror used to build the live system, i.e. the value of \-\-mirror\-bootstrap.
.IP "\fB\-\-mode\fP debian|emdebian|progress|ubuntu" 4
defines a global mode to load project specific defaults. By default this is
set to debian.
.IP "\fB\-\-net\-root\-filesystem\fP nfs|cfs" 4
defines the filesystem that will be configured in the bootloader
configuration for your netboot image. This defaults to nfs.
.IP "\fB\-\-net\-root\-mountoptions\fP \fIOPTIONS\fP" 4
sets additional options for mounting the root filesystem in netboot images
and is by default empty.
.IP "\fB\-\-net\-root\-path\fP \fIPATH\fP" 4
sets the file path that will be configured in the bootloader configuration
for your netboot image. This defaults to /srv/debian\-live in debian mode and
to /srv/emebian\-live when being in emdebian mode, and /srv/ubuntu\-live when
in ubuntu mode.
.IP "\fB\-\-net\-root\-server\fP \fIIP\fP|\fIHOSTNAME\fP" 4
sets the IP or hostname that will be configured in the bootloader
configuration for the root filesystem of your netboot image. This defaults
to 192.168.1.1.
.IP "\fB\-\-net\-cow\-filesystem\fP nfs|cfs" 4
defines the filesystem type for the copy\-on\-write layer and defaults to nfs.
.IP "\fB\-\-net\-cow\-mountoptions\fP \fIOPTIONS\fP" 4
sets additional options for mounting the copy\-on\-write layer in netboot
images and is by default empty.
.IP "\fB\-\-net\-cow\-path\fP \fIPATH\fP" 4
defines the path to client writable filesystem. Anywhere that
\fIclient_mac_address\fP is specified in the path live\-boot will substitute the
MAC address of the client delimited with hyphens.
.PP
.IP "" 4
Example:
.br
/export/hosts/client_mac_address
.br
/export/hosts/00\-16\-D3\-33\-92\-E8
.IP "\fB\-\-net\-cow\-server\fP \fIIP\fP|\fIHOSTNAME\fP" 4
sets the IP or hostname that will be configured in the bootloader
configuration for the copy\-on\-write filesystem of your netboot image and is
by default empty.
.IP "\fB\-\-net\-tarball\fP true|false" 4
defines if a compressed tarball should be created. Disabling this options
leads to no tarball at all, the plain binary directory is considered the
output in this case. Default is true.
.IP "\-p|\fB\-\-package\-lists\fP \fILIST\fP|\(dq\fILISTS\fP\(dq" 4
defines which lists available in /usr/share/live/build/package\-lists should
be used. By default, this is set to standard. Note that in case you have
local package lists, you don't need to list them here. Putting them into
config/package\-lists is enough (the filename needs to have the .list suffix
though).
.IP \fB\-\-quiet\fP 4
reduces the verbosity of messages output by \fBlb build\fP.
.IP "\fB\-\-archives\fP \fIARCHIVE\fP|\(dq\fIARCHIVES\fP\(dq" 4
enables one of available third\-party archive configurations in
/usr/share/live/build/archives.
.IP "\fB\-\-root\-command\fP sudo" 4
controls if live\-build should use sudo internally to build the live
image. Note that this is not well tested and that you should, when relying
on sudo, call the individual live\-build command with sudo itself.
.IP "\fB\-\-use\-fakeroot\fP true|false" 4
controls if live\-build should utilize fakeroot and fakechroot to try and
avoid requiring root privillages where possible. By default, this option is
false.
.IP "\fB\-\-archive\-areas\fP \fIARCHIVE_AREA\fP|\(dq\fIARCHIVE_AREAS\fP\(dq" 4
defines which package archive areas of a debian packages archive should be
used for configured debian package mirrors. By default, this is set to
main. Remember to check the licenses of each packages with respect to their
redistributability in your juristiction when enabling contrib or non\-free
with this mechanism.
.IP "\fB\-\-security\fP true|false" 4
defines if the security repositories specified in the security mirror
options should be used or not.
.IP "\fB\-\-source\fP true|false" 4
defines if a corresponding source image to the binary image should be
build. By default this is false because most people do not require this and
would require to download quite a few source packages. However, once you
start distributing your live image, you should make sure you build it with a
source image alongside.
.IP "\-s|\fB\-\-source\-images\fP iso|net|tar|usb\-hdd" 4
defines the image type for the source image. Default is tar.
.IP "\fB\-\-swap\-file\-path\fP \fIPATH\fP" 4
defines the path to a swap file to create in the binary image. Default is
not to create a swap file.
.IP "\fB\-\-swap\-file\-size\fP \fIMB\fP" 4
defines what size in megabytes the swap file should be, if one is to be
created. Default is 512MB.
.IP "\fB\-\-syslinux\-splash\fP \fIFILE\fP" 4
defines the file of the syslinux splash graphic that should be used instead
of the default one.
.IP "\fB\-\-syslinux\-timeout\fP \fISECONDS\fP" 4
defines the timeout the syslinux bootloader should wait for input from the
user at the bootprompt prior booting the default kernel. This defaults to 0
which means it will wait forever.
.IP "\fB\-\-syslinux\-menu\fP true|false" 4
defines if syslinux should be make use of the vgamenu capabilities or not.
.IP "\fB\-\-tasksel\fP apt|aptitude|tasksel" 4
selects which program is used to install tasks. By default, this is set to
tasksel.
.IP "\fB\-\-templates\fP \fIPATH\fP" 4
sets the path to the templates that live\-build is going to use, e.g. for
bootloaders. By default, this is set to /usr/share/live/build/templates/.
.IP "\fB\-\-virtual\-root\-size\fP MB" 4
defines what size the virtual\-hdd image should be. Note that although the
default is set to 10000 (= 10GB), it will not need 10GB space on your
harddisk as the files are created as sparse files.
.IP "\fB\-\-volatile\fP true|false" 4
defines if debian volatile package archives should be included in the image
or not.
.IP "\fB\-\-backports\fP true|false" 4
defines if debian backports package archives should be included in the image
or not.
.IP "\fB\-\-exposed\-root\fP true|false" 4
defines whether to expose the root filesystem as read only and not covered
by the union filesystem. This has useful implications for certain speciality
setups such as LTSP. By default, this option is false.
.IP "\fB\-\-username\fP \fINAME\fP" 4
sets the name of the account of the default user in the live system.
.IP \fB\-\-verbose\fP 4
increases the verbosity of messages output by \fBlb build\fP.
.IP "\fB\-\-win32\-loader true|false\fP" 4
.\" FIXME
defines if win32\-loader should be included in the binary image or not.

.SH ENVIRONMENT
.\" FIXME
Currently, command line switches can also be specified through the
corresponding environment variable. However, this generally should not be
relied upon, as it is an implementation detail that is subject to change in
future releases. For options applying directly to live\-build, environment
variables are named LB_FOO, meaning, e.g. \fB\-\-apt\-ftp\-proxy\fP becomes
LB_APT_FTP_PROXY (the exception being internal options such as
\fB\-\-debug\fP). For options passed to another program, as in APT_OPTIONS or
GZIP_OPTIONS, no LB_ prefix is used.


.\" FIXME
.SH FILES
.\" FIXME
.IP \fBauto/config\fP 4
.IP "\fB/etc/live/build.conf, /etc/live/build.d\fP" 4
.\" FIXME
An optional, global configuration file for \fBlb config\fP variables. It is
useful to specify a few system wide defaults, like
LB_PARENT_MIRROR_BOOTSTRAP. This feature can be false by specifying the
\fB\-\-ignore\-system\-defaults\fP option.

.SH "SEE ALSO"
\fIlive\-build\fP(7)
.PP
This program is a part of live\-build.

.SH HOMEPAGE
More information about live\-build and the Debian Live project can be found
on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at
<\fIhttp://live.debian.net/manual/\fP>.

.SH BUGS
Bugs can be reported by submitting a bugreport for the live\-build package in
the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by
writing a mail to the Debian Live mailing list at
<\fIdebian\-live@lists.debian.org\fP>.

.SH AUTHOR
live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for
the Debian project.