~timrchavez/live-build/lb-sg-2.x-add-suppport-for-pxz

« back to all changes in this revision

Viewing changes to make-live.8

  • Committer: Daniel Baumann
  • Date: 2007-09-23 08:04:20 UTC
  • Revision ID: daniel@debian.org-20070923080420-nc0xzqlh0gz60r5t
Adding live-package 0.99-1.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH MAKE-LIVE 8 "Jul, 27 2006" "0.99" "Debian Live framework"
 
2
 
 
3
.SH NAME
 
4
make-live \- An utility for building Debian Live systems.
 
5
 
 
6
.SH SYNOPSIS
 
7
.B make-live
 
8
.RB [\| \-a \||\| \-\-architecture
 
9
.IR ARCHITECTURE \|]
 
10
.RB [\| \-c \||\| \-\-conffile
 
11
.IR FILE \|]
 
12
.RB [\| \-\-clone
 
13
.IR DIRECTORY \|]
 
14
.RB [\| \-d \||\| \-\-distribution
 
15
.IR DISTRIBUTION \|]
 
16
.BR [\| \-\-debug \|]
 
17
.RB [\| \-f \||\| \-\-filesystem
 
18
.IR FILESYSTEM \|]
 
19
.RB [\| \-\-flavour
 
20
.IR FLAVOUR \|]
 
21
.RB [\| \-\-hook
 
22
.RI \|" COMMAND .\|.\|.\|"\|]
 
23
.RB [\| \-\-include\-image
 
24
.IR FILE \||\| DIRECTORY \|]
 
25
.RB [\| \-\-include\-rootfs
 
26
.IR FILE \||\| DIRECTORY \|]
 
27
.RB [\| \-\-linux\-image
 
28
.IR FLAVOUR \|]
 
29
.RB [\| \-\-logfile
 
30
.IR FILE \|]
 
31
.RB [\| \-p \||\| \-\-package-list
 
32
.IR FILE \|]
 
33
.RB [\| \-\-preseed
 
34
.IR FILE \|]
 
35
.RB [\| \-\-rootfs
 
36
.IR DIRECTORY \|]
 
37
.RB [\| \-s \||\| \-\-section
 
38
.RI \|" SECTION \|.\|.\|.\|"\|]
 
39
.RB [\| \-\-splashy
 
40
.RI [\| THEME \|]\|]
 
41
.RB [\| \-t \||\| \-\-type
 
42
.IR TYPE \|]
 
43
.RB [\| \-\-templates
 
44
.IR DIRECTORY \|]
 
45
.RB [\| \-\-verbose \|]
 
46
.RI [\| LIST \|]
 
47
.PP
 
48
.B make-live
 
49
.RB [\| \-h \||\| \-\-help \|]
 
50
.br
 
51
.B make-live
 
52
.RB [\| \-u \||\| \-\-usage \|]
 
53
.br
 
54
.B make-live
 
55
.RB [\| \-v \||\| \-\-version \|]
 
56
 
 
57
.SH DESCRIPTION
 
58
The Debian Live framework lets you automagically create live system images.
 
59
.PP
 
60
 
 
61
.SH OPTIONS
 
62
.TP
 
63
.BI "\-a, \-\-architecture " ARCHITECTURE
 
64
Build an image for another architecture than the autodetected one. This is
 
65
usefull for e.g. building i386 images on an amd64 machine. Instead of this flag,
 
66
the environment variable LIVE_ARCHITECTURE can be used.
 
67
.TP
 
68
.BI "\-c, \-\-conffile " FILE
 
69
Uses another configuration file in addition to the default one, if existing, in
 
70
/etc/make-live.conf. Settings in the additional configuration file do overwrite
 
71
the settings from /etc/make-live.conf. Instead of this flag, the environment
 
72
varibale LIVE_CONFFILE can be used.
 
73
.TP
 
74
.BI "\-\-clone " DIRECTORY
 
75
Clones the package selection and configuration from a given root directory. It
 
76
will output the settings to $LIVE_ROOT/preseed.cloned and $LIVE_ROOT/plist.clone
 
77
for easy reuse with \-\-preseed and \-\-package-list. Instead of this flag, the
 
78
environment variable LIVE_CLONE can be used.
 
79
.TP
 
80
.BI "\-d, \-\-distribution " DISTRIBUTION
 
81
Specifies the distribution to be used. Allowed values are all Debian
 
82
distributions (oldstable, stable, testing, unstable), although only unstable
 
83
(default) is possible for now. Instead of this flag, the environment variable
 
84
LIVE_DISTRIBUTION can be used.
 
85
.TP
 
86
.B \-\-debug
 
87
Enables debut output of make-live itself (this includes \-\-verbose too).
 
88
Instead of this environment variable, LIVE_DEBUG can be used.
 
89
.TP
 
90
.BI "\-f, \-\-filesystem " FILESYSTEM
 
91
Specifies the filesystem for the compressed image. At the moment, only squashfs
 
92
(default) and ext2 are allowed values. Instead of this flag, the environment
 
93
variable LIVE_FILESYSTEM can be used.
 
94
.TP
 
95
.BI "\-\-flavour " FLAVOUR
 
96
Specifies the bootstrap flavour. This can be either standard (default) or
 
97
minimal. Instead of this flag, the environment variable LIVE_FLAVOUR can be
 
98
used.
 
99
.TP
 
100
.\" FIXME
 
101
.BI "\-\-hook " COMMAND "\|.\|.\|.\|"
 
102
Specifies a command which will be executed at the end of the chroot setup and
 
103
before the mastering of the image. Instead of this flag, the environment
 
104
variable LIVE_HOOK can be used.
 
105
.TP
 
106
.BI "\-\-include\-image " FILE \||\| DIRECTORY
 
107
specifies a file or directory which will be copied inside the image. Can be also
 
108
set through LIVE_INCLUDE_IMAGE environment variable.
 
109
.TP
 
110
.BI "\-\-include\-rootfs " FILE \||\| DIRECTORY
 
111
specifies a file or directory which will be copied inside the root filesystem of
 
112
the image. Can be also set through the LIVE_INCLUDE_ROOTFS environment variable.
 
113
.TP
 
114
.BI "\-\-linux\-image " FLAVOUR
 
115
.TP
 
116
.BI "\-p, \-\-package-list " FILE
 
117
specifies a package list file, one package for each line. It overrides list option.
 
118
.TP
 
119
.BI "\-\-logfile " FILE
 
120
specifies the location of the logfile. It can be set through LIVE_LOGFILE,
 
121
default is \$LIVE_ROOT/make-live.log
 
122
.TP
 
123
.BI "\-\-preseed " FILE
 
124
clone the packages selection and configuration from the provided
 
125
root directory.
 
126
.TP
 
127
.BI "\-\-rootfs " DIRECTORY
 
128
skip all phases of rootfs generation and just install casper and the
 
129
kernel in the specified root directory (must be a debian).
 
130
.TP
 
131
.BI "\-s, \-\-section " SECTION "\|.\|.\|.\|"
 
132
specifies which sections are going to be availble for the package selection inside the chroot (Default: main). Can be set to every combination of "main contrib non-free", also through LIVE_SECTIONS.
 
133
.TP
 
134
.BI "\-\-splashy [\|" THEME \|]
 
135
specifies that splashy should be installed and included in initamfs, an optional
 
136
official THEME could be selected or an exernal theme could be installed, in the
 
137
second case the .tar.gz theme should be passed without extension and must be in
 
138
the current directory. Can be also set through LIVE_SPLASHY and
 
139
LIVE_SPLASHY_THEME environment variables.
 
140
.TP
 
141
.BI "\-t, \-\-type " TYPE
 
142
specifies the image type to generate. Currently, only iso and net are available.
 
143
.TP
 
144
.BI "\-\-templates " DIRECTORY
 
145
specifies a templates directory to use instead of the default one.
 
146
.TP
 
147
.B \-\-verbose
 
148
providing debug information for third-party tools.
 
149
.TP
 
150
.B \-h, \-\-help
 
151
display this help and exit.
 
152
.TP
 
153
.B \-u, \-\-usage
 
154
show usage and exit.
 
155
.TP
 
156
.B \-v, \-\-version
 
157
output version information and exit.
 
158
 
 
159
.SH LISTS
 
160
Every list does already include the Debian standard package selection.
 
161
.TP
 
162
.B gnome | gnome-core | gnome-full
 
163
include GNOME.
 
164
.TP
 
165
.B kde | kde-core | kde-full | kde-extra
 
166
include KDE.
 
167
.TP
 
168
.B x11 | x11-core
 
169
include X-Window-System only.
 
170
.TP
 
171
.B xfce
 
172
include Xfce.
 
173
 
 
174
.SH BUGS
 
175
.B make-live
 
176
works fully on amd64 and i386, partially on alpha, hppa, ia64, mips, mipsel,
 
177
powerpc, s390 and sparc. Other architectures, such as arm and m68k, as well as
 
178
non-linux ports of Debian, like hurd-i386, are currently not supported.
 
179
 
 
180
.SH HOMEPAGE
 
181
Debian Live project <http://live.debian.net/>
 
182
 
 
183
.SH SEE ALSO
 
184
.BR make-live.conf (8).
 
185
 
 
186
.SH AUTHOR
 
187
make-live was written by Daniel Baumann <daniel@debian.org> and Marco Amadori
 
188
<marco.amadori@gmail.com>.