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.
xzis the default and works with 2.6.38 and later kernels.gzipworks with all kernels.lzoworks with 2.6.36 and later kernels.lzmawill only work with custom kernels.xz1mis interpreted as"xz -b 1M -Xdict-size 1M -norecovery". Set toNoneto force reading the compressor used in BASE_ON. Ifgzipis 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
$releaseverin 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).