livecd-creator - Man Page
creates live CD or DVD images.
Synopsis
livecd-creator [Options]
Description
livecd-creator creates live CD or DVD images (ISO images) from kickstart files. Kickstart files contain information about packages and configuration settings which are used to build the image.
Options
- -h, --help
Shows the help message and exits.
Image Options
These options define the created image.
- -c KSCFG, --config=KSCFG
Path to kickstart configuration file.
- -b BASE_ON, --base-on=BASE_ON
Add packages to an existing live CD iso9660 image.
- -f FS_LABEL, --fslabel=FS_LABEL
Defines the file system label. The default is based on the configuration name.
- --title=TITLE
Title used by syslinux.cfg file.
- --product=PRODUCT
Product name used in syslinux.cfg boot stanzas and countdown.
- -p, --plugins
Use DNF plugins during image creation.
- --compression-type=COMPRESS_ARGS
Specify a compressor recognized by mksquashfs.
xz
is the default and works with 2.6.38 and later kernels.gzip
works with all kernels.lzo
works with 2.6.36 and later kernels.lzma
will only work with custom kernels.xz1m
is interpreted as"xz -b 1M -Xdict-size 1M -norecovery"
. Set toNone
to force reading the compressor used in BASE_ON. Ifgzip
is used, the -comp option is not passed to mksquashfs to allow the use of older versions of mksquashfs. Multiple arguments should be specified in one string, i.e.,--compression-type "type arg1 arg2 ..."
.- --releasever=VER
Set the value to substitute for
$releasever
in kickstart repo urls.
System Directory Options
These options define directories used on your system for creating the live image.
- -t TMPDIR, --tmpdir=TMPDIR
defines the temporary directory to use. The default directory is /var/tmp.
- --cache=CACHEDIR
Defines the cache directory to use (default: private cache).
- --cacheonly
Work offline from cache, use together with --cache (default: False).
- --nocleanup
Skip cleanup of temporary files.
Debugging Options
These options control the output of logging information during image creation.
- -d, --debug
Output debugging information.
- -v, --verbose
Output verbose progress information.
- -q, --quiet
Supress stdout.
- --logfile=FILE
Save debug information to FILE.
Examples
Barebones LiveCD
livecd-creator \ --config=/usr/share/livecd-tools/livecd-fedora-minimal.ks
Fedora Desktop Live CD
livecd-creator \ --config=/usr/share/livecd-tools/livecd-fedora-desktop.ks \ --fslabel=Fedora9-LiveCD-foo
Repo Extensions
livecd-creator provides for some extensions to the repo commands similar to what DNF supports. The strings $arch
, $basearch
and $releasever
are replaced with the system arch, basearch and release version respectively. When no --releasever is passed it defaults to the current system's version. This allows the use of repo commands such as the following:
repo --name=fedora --mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=fedora-$releasever&arch=$basearch
Note that in a chroot environment (like koji) the rpmdb is not available, so either don't use $releasever
in that case, or pass --releasever=VER.
Contributors
David Zeuthen, Jeremy Katz, Douglas McClendon and a team of many other contributors. See the AUTHORS file in the source distribution for the complete list of credits.
Bugs
Report bugs to the mailing list <http://www.redhat.com/mailman/listinfo/fedora-livecd-list> or directly to Bugzilla <http://bugzilla.redhat.com/bugzilla/> against the Fedora
product, and the livecd-tools
component.
Copyright
Copyright (C) Fedora Project 2008,2009,2020, and various contributors. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
See Also
livecd-iso-to-disk(8)
, project website <http://fedoraproject.org/wiki/FedoraLiveCD>
Referenced By
livecd-iso-to-disk(8), mkbiarch(8), virt-p2v-make-kickstart(1).