Script 'mail_helper' called by obssrc Hello community, here is the log from the commit of package supermin for openSUSE:Factory checked in at 2024-09-05 15:47:11 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/supermin (Old) and /work/SRC/openSUSE:Factory/.supermin.new.10096 (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "supermin" Thu Sep 5 15:47:11 2024 rev:26 rq:1198828 version:5.3.5 Changes: -------- --- /work/SRC/openSUSE:Factory/supermin/supermin.changes 2024-07-29 21:55:10.283482857 +0200 +++ /work/SRC/openSUSE:Factory/.supermin.new.10096/supermin.changes 2024-09-05 15:47:56.237938919 +0200 @@ -1,0 +2,6 @@ +Wed Sep 4 15:06:41 MDT 2024 - carn...@suse.com + +- Update to version 5.3.5 (jsc#PED-8910) + * Fix qemu-kvm example command + +------------------------------------------------------------------- @@ -12 +18 @@ -- Update to version 5.3.4 (jsc#PED-6305) +- Update to version 5.3.4 (jsc#PED-8910) Old: ---- supermin-5.3.4.tar.gz supermin-5.3.4.tar.gz.sig New: ---- supermin-5.3.5.tar.gz supermin-5.3.5.tar.gz.sig ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ supermin.spec ++++++ --- /var/tmp/diff_new_pack.LPgTeE/_old 2024-09-05 15:47:56.881965665 +0200 +++ /var/tmp/diff_new_pack.LPgTeE/_new 2024-09-05 15:47:56.885965831 +0200 @@ -17,14 +17,14 @@ Name: supermin -Version: 5.3.4 +Version: 5.3.5 Release: 0 Summary: Bootstrapping tool for creating supermin appliances License: GPL-3.0-or-later Group: System/Filesystems URL: https://libguestfs.org/ -Source0: https://download.libguestfs.org/supermin/5.3-development/supermin-5.3.4.tar.gz -Source1: https://download.libguestfs.org/supermin/5.3-development/supermin-5.3.4.tar.gz.sig +Source0: https://download.libguestfs.org/supermin/5.3-development/supermin-5.3.5.tar.gz +Source1: https://download.libguestfs.org/supermin/5.3-development/supermin-5.3.5.tar.gz.sig Source9: supermin.keyring Patch30: suse_release.patch Patch31: supermin-kernel_version_compressed.patch ++++++ supermin-5.3.4.tar.gz -> supermin-5.3.5.tar.gz ++++++ ++++ 4084 lines of diff (skipped) ++++ retrying with extended exclude list diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/supermin-5.3.4/config.h.in new/supermin-5.3.5/config.h.in --- old/supermin-5.3.4/config.h.in 2024-01-11 13:20:57.000000000 +0100 +++ new/supermin-5.3.5/config.h.in 2024-08-31 11:25:16.000000000 +0200 @@ -3,7 +3,7 @@ /* caml_alloc_initialized_string found at compile time. */ #undef HAVE_CAML_ALLOC_INITIALIZED_STRING -/* Define to 1 if you have the `ext2fs_close2' function. */ +/* Define to 1 if you have the 'ext2fs_close2' function. */ #undef HAVE_EXT2FS_CLOSE2 /* Define to 1 if you have the <inttypes.h> header file. */ @@ -42,11 +42,11 @@ /* Define to 1 if you have the <wchar.h> header file. */ #undef HAVE_WCHAR_H -/* Define to 1 if `major', `minor', and `makedev' are declared in <mkdev.h>. +/* Define to 1 if 'major', 'minor', and 'makedev' are declared in <mkdev.h>. */ #undef MAJOR_IN_MKDEV -/* Define to 1 if `major', `minor', and `makedev' are declared in +/* Define to 1 if 'major', 'minor', and 'makedev' are declared in <sysmacros.h>. */ #undef MAJOR_IN_SYSMACROS @@ -74,12 +74,12 @@ /* Define to 1 if the C compiler supports function prototypes. */ #undef PROTOTYPES -/* Define to 1 if all of the C90 standard headers exist (not just the ones +/* Define to 1 if all of the C89 standard headers exist (not just the ones required in a freestanding environment). This macro is provided for backward compatibility; new code need not use it. */ #undef STDC_HEADERS -/* Enable extensions on AIX 3, Interix. */ +/* Enable extensions on AIX, Interix, z/OS. */ #ifndef _ALL_SOURCE # undef _ALL_SOURCE #endif @@ -140,11 +140,15 @@ #ifndef __STDC_WANT_IEC_60559_DFP_EXT__ # undef __STDC_WANT_IEC_60559_DFP_EXT__ #endif +/* Enable extensions specified by C23 Annex F. */ +#ifndef __STDC_WANT_IEC_60559_EXT__ +# undef __STDC_WANT_IEC_60559_EXT__ +#endif /* Enable extensions specified by ISO/IEC TS 18661-4:2015. */ #ifndef __STDC_WANT_IEC_60559_FUNCS_EXT__ # undef __STDC_WANT_IEC_60559_FUNCS_EXT__ #endif -/* Enable extensions specified by ISO/IEC TS 18661-3:2015. */ +/* Enable extensions specified by C23 Annex H and ISO/IEC TS 18661-3:2015. */ #ifndef __STDC_WANT_IEC_60559_TYPES_EXT__ # undef __STDC_WANT_IEC_60559_TYPES_EXT__ #endif @@ -173,8 +177,14 @@ /* Number of bits in a file offset, on hosts where this is settable. */ #undef _FILE_OFFSET_BITS -/* Define for large files, on AIX-style hosts. */ +/* Define to 1 on platforms where this makes off_t a 64-bit type. */ #undef _LARGE_FILES +/* Number of bits in time_t, on hosts where this is settable. */ +#undef _TIME_BITS + +/* Define to 1 on platforms where this makes time_t a 64-bit type. */ +#undef __MINGW_USE_VC2005_COMPAT + /* Define like PROTOTYPES; this can be used by system headers. */ #undef __PROTOTYPES diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/supermin-5.3.4/configure.ac new/supermin-5.3.5/configure.ac --- old/supermin-5.3.4/configure.ac 2024-01-11 13:19:41.000000000 +0100 +++ new/supermin-5.3.5/configure.ac 2024-08-31 11:23:07.000000000 +0200 @@ -1,5 +1,5 @@ dnl supermin configure.ac -dnl (C) Copyright 2009-2019 Red Hat Inc. +dnl (C) Copyright 2009-2024 Red Hat Inc. dnl dnl This program is free software; you can redistribute it and/or modify dnl it under the terms of the GNU General Public License as published by @@ -20,7 +20,7 @@ dnl MAJOR = 5 (unless we break the command line again) dnl MINOR = even for stable branch, odd for development branch dnl RELEASE = increments for each release -AC_INIT([supermin],[5.3.4]) +AC_INIT([supermin],[5.3.5]) AM_INIT_AUTOMAKE(foreign) AC_REQUIRE_AUX_FILE([supermin-test-driver]) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/supermin-5.3.4/examples/build-basic-vm.sh new/supermin-5.3.5/examples/build-basic-vm.sh --- old/supermin-5.3.4/examples/build-basic-vm.sh 2014-02-25 10:17:11.000000000 +0100 +++ new/supermin-5.3.5/examples/build-basic-vm.sh 2024-08-31 10:57:20.000000000 +0200 @@ -75,7 +75,7 @@ echo "To run the full appliance, use a command such as:" echo " qemu-kvm -m 512 -kernel kernel -initrd initrd \\" -echo " -append 'vga=773 selinux=0' \\" +echo " -append 'vga=773 selinux=0 root=/dev/vda' \\" echo " -drive file=root,format=raw,if=virtio" echo diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/supermin-5.3.4/src/config.ml new/supermin-5.3.5/src/config.ml --- old/supermin-5.3.4/src/config.ml 2024-01-11 13:20:56.000000000 +0100 +++ new/supermin-5.3.5/src/config.ml 2024-08-31 11:25:16.000000000 +0200 @@ -18,7 +18,7 @@ *) let package_name = "supermin" -let package_version = "5.3.4" +let package_version = "5.3.5" let host_cpu = "x86_64" let apt_get = "no" diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/supermin-5.3.4/src/supermin.1 new/supermin-5.3.5/src/supermin.1 --- old/supermin-5.3.4/src/supermin.1 2021-08-26 17:32:28.000000000 +0200 +++ new/supermin-5.3.5/src/supermin.1 2023-12-07 12:29:34.000000000 +0100 @@ -1,4 +1,5 @@ -.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== @@ -15,29 +16,12 @@ .ft R .fi .. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' . ds C` . ds C' 'br\} @@ -71,21 +55,21 @@ .\" ======================================================================== .\" .IX Title "SUPERMIN 1" -.TH SUPERMIN 1 "2017-10-24" "supermin-5.3.0" "Virtualization Support" +.TH SUPERMIN 1 2023-11-16 supermin-5.3.3 "Virtualization Support" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh -.SH "NAME" +.SH NAME supermin \- Tool for creating and building supermin appliances -.SH "SYNOPSIS" +.SH SYNOPSIS .IX Header "SYNOPSIS" .Vb 1 \& supermin \-\-prepare \-o OUTPUTDIR PACKAGE [PACKAGE ...] \& \& supermin \-\-build \-o OUTPUTDIR \-f chroot|ext2 INPUT [INPUT ...] .Ve -.SH "EXAMPLE" +.SH EXAMPLE .IX Header "EXAMPLE" .Vb 1 \& supermin \-\-prepare bash util\-linux \-o /tmp/supermin.d @@ -112,7 +96,7 @@ \& Welcome to supermin \& bash\-4.3# .Ve -.SH "DESCRIPTION" +.SH DESCRIPTION .IX Header "DESCRIPTION" Supermin is a tool for building supermin appliances. These are tiny appliances (similar to virtual machines), usually around 100KB in @@ -123,7 +107,7 @@ documents supermin 5.x which is a complete rewrite and quite different from febootstrap 2.x. If you are looking for the febootstrap 2.x tools, then this is not the right place. -.SS "\s-1BASIC OPERATION\s0" +.SS "BASIC OPERATION" .IX Subsection "BASIC OPERATION" The supermin tool can be used in two modes, \fBpreparing\fR a tiny supermin appliance, which is done on a build system. And \fBbuilding\fR, @@ -134,7 +118,7 @@ be run as root. It does not affect the host system or the packages installed on the host system. .PP -\fI\s-1PREPARE MODE\s0\fR +\fIPREPARE MODE\fR .IX Subsection "PREPARE MODE" .PP \&\fI\-\-prepare\fR creates the tiny supermin appliance in the given output @@ -151,13 +135,13 @@ creates a supermin appliance containing the packages \f(CW\*(C`bash\*(C'\fR and \&\f(CW\*(C`coreutils\*(C'\fR. Specifically, it creates some files in directory \&\fIsupermin.d\fR. This directory \fIis\fR the supermin appliance. (See -\&\*(L"\s-1SUPERMIN APPLIANCES\*(R"\s0 below). +"SUPERMIN APPLIANCES" below). .PP It is intended that the \fI\-\-prepare\fR step is done on a central build machine, and the supermin appliance is distributed to end users (which is easy because supermin appliances are so small). .PP -\fI\s-1BUILD MODE\s0\fR +\fIBUILD MODE\fR .IX Subsection "BUILD MODE" .PP \&\fI\-\-build\fR (previously a separate program called \f(CW\*(C`supermin\-helper\*(C'\fR) @@ -195,25 +179,25 @@ Note that the lock file \fBmust not\fR be stored inside the \fI\-o\fR directory. .PP -\fI\s-1PACKAGES\s0\fR +\fIPACKAGES\fR .IX Subsection "PACKAGES" .PP -By \*(L"package\*(R" we mean the \s-1RPM,\s0 Debian, (etc.) package, +By "package" we mean the RPM, Debian, (etc.) package, eg. \f(CW\*(C`coreutils\*(C'\fR, \f(CW\*(C`perl\*(C'\fR. .PP In all cases supermin can only build a supermin appliance which is identical in distro, version and architecture to the host. It does \&\fInot\fR do cross-builds. -.SH "OPTIONS" +.SH OPTIONS .IX Header "OPTIONS" -.IP "\fB\-\-help\fR" 4 +.IP \fB\-\-help\fR 4 .IX Item "--help" Display brief command line usage, and exit. -.IP "\fB\-\-build\fR" 4 +.IP \fB\-\-build\fR 4 .IX Item "--build" Build the full appliance from the supermin appliance. This used to be a separate program called \f(CW\*(C`supermin\-helper\*(C'\fR. -.IP "\fB\-\-copy\-kernel\fR" 4 +.IP \fB\-\-copy\-kernel\fR 4 .IX Item "--copy-kernel" (\fI\-\-build\fR mode only) .Sp @@ -222,10 +206,10 @@ .Sp This is fractionally slower, but is necessary if you want to change the permissions or SELinux label on the kernel or device tree. -.IP "\fB\-f\fR \s-1FORMAT\s0" 4 +.IP "\fB\-f\fR FORMAT" 4 .IX Item "-f FORMAT" .PD 0 -.IP "\fB\-\-format\fR \s-1FORMAT\s0" 4 +.IP "\fB\-\-format\fR FORMAT" 4 .IX Item "--format FORMAT" .PD (\fI\-\-build\fR mode only) @@ -237,41 +221,41 @@ .Sp Possible formats are: .RS 4 -.IP "chroot" 4 +.IP chroot 4 .IX Item "chroot" A directory tree in the host filesystem. .Sp -The filesystem tree is written to \fI\s-1OUTPUTDIR\s0\fR (ie. the \fI\-o\fR option). +The filesystem tree is written to \fIOUTPUTDIR\fR (ie. the \fI\-o\fR option). .Sp This is called a \f(CW\*(C`chroot\*(C'\fR because you could literally \fBchroot\fR\|(1) into this directory afterwards, although it's a better idea to use a -container technology (\s-1LXC,\s0 etc.). +container technology (LXC, etc.). .Sp No kernel or initrd is generated in this mode because it is assumed that you will be running the appliance using the host kernel. -.IP "ext2" 4 +.IP ext2 4 .IX Item "ext2" An ext2 filesystem disk image. .Sp The output kernel is written to \fIOUTPUTDIR/kernel\fR, a small initramfs which can mount the appliance to \fIOUTPUTDIR/initrd\fR, and the ext2 filesystem image to -\&\fIOUTPUTDIR/root\fR. (Where \fI\s-1OUTPUTDIR\s0\fR is specified by the \fI\-o\fR +\&\fIOUTPUTDIR/root\fR. (Where \fIOUTPUTDIR\fR is specified by the \fI\-o\fR option). .Sp -The filesystem (\fIOUTPUTDIR/root\fR) has a default size of 4 \s-1GB\s0 +The filesystem (\fIOUTPUTDIR/root\fR) has a default size of 4 GB (see also the \fI\-\-size\fR option). .RE .RS 4 .RE -.IP "\fB\-\-host\-cpu\fR \s-1CPU\s0" 4 +.IP "\fB\-\-host\-cpu\fR CPU" 4 .IX Item "--host-cpu CPU" (\fI\-\-build\fR mode only) .Sp -Specify the host \s-1CPU\s0 (eg. \f(CW\*(C`i686\*(C'\fR, \f(CW\*(C`x86_64\*(C'\fR). This is used as a +Specify the host CPU (eg. \f(CW\*(C`i686\*(C'\fR, \f(CW\*(C`x86_64\*(C'\fR). This is used as a substring match when searching for compatible kernels. If not -specified, it defaults to the host \s-1CPU\s0 that supermin was compiled on. -.IP "\fB\-\-if\-newer\fR" 4 +specified, it defaults to the host CPU that supermin was compiled on. +.IP \fB\-\-if\-newer\fR 4 .IX Item "--if-newer" (\fI\-\-build\fR mode only) .Sp @@ -285,7 +269,7 @@ directory. .Sp See also \fI\-\-lock\fR below. -.IP "\fB\-\-include\-packagelist\fR" 4 +.IP \fB\-\-include\-packagelist\fR 4 .IX Item "--include-packagelist" (\fI\-\-build\fR mode only) .Sp @@ -295,11 +279,11 @@ .Sp Mostly useful for debugging, as it makes it easier to find out e.g. which version of a package was copied in the appliance. -.IP "\fB\-\-list\-drivers\fR" 4 +.IP \fB\-\-list\-drivers\fR 4 .IX Item "--list-drivers" List the package manager drivers compiled into supermin, and whether the corresponding package manager is detected on the current system. -.IP "\fB\-\-lock\fR \s-1LOCKFILE\s0" 4 +.IP "\fB\-\-lock\fR LOCKFILE" 4 .IX Item "--lock LOCKFILE" (\fI\-\-build\fR mode only) .Sp @@ -312,7 +296,7 @@ .Sp Note that the lock file \fBmust not\fR be stored inside the output directory. -.IP "\fB\-o\fR \s-1OUTPUTDIR\s0" 4 +.IP "\fB\-o\fR OUTPUTDIR" 4 .IX Item "-o OUTPUTDIR" Select the output directory. .Sp @@ -324,12 +308,12 @@ new output directory is created. .Sp The output directory is created (nearly) atomically by constructing a -temporary directory called something like \fI\s-1OUTPUTDIR\s0.abc543\fR, then +temporary directory called something like \fIOUTPUTDIR.abc543\fR, then renaming the old output directory (if present) and deleting it, and -then renaming the temporary directory to \fI\s-1OUTPUTDIR\s0\fR. By combining +then renaming the temporary directory to \fIOUTPUTDIR\fR. By combining this option with \fI\-\-lock\fR you can ensure that multiple parallel runs of supermin do not conflict with each other. -.IP "\fB\-\-packager\-config\fR \s-1CONFIGFILE\s0" 4 +.IP "\fB\-\-packager\-config\fR CONFIGFILE" 4 .IX Item "--packager-config CONFIGFILE" (\fI\-\-prepare\fR mode only) .Sp @@ -341,10 +325,10 @@ .Sp For Yum/RPM distributions, this sets the yum configuration file (default \fI/etc/yum.conf\fR). See \fByum.conf\fR\|(5). -.IP "\fB\-\-prepare\fR" 4 +.IP \fB\-\-prepare\fR 4 .IX Item "--prepare" Prepare the supermin appliance. -.IP "\fB\-\-use\-installed\fR" 4 +.IP \fB\-\-use\-installed\fR 4 .IX Item "--use-installed" (\fI\-\-prepare\fR mode only) .Sp @@ -358,28 +342,28 @@ However this option is useful in some controlled situations: for example when using supermin inside a freshly installed chroot, or if you have no network access during the build. -.IP "\fB\-\-size\fR \s-1SIZE\s0" 4 +.IP "\fB\-\-size\fR SIZE" 4 .IX Item "--size SIZE" (\fI\-\-build\fR mode only) .Sp Select the size of the output ext2 filesystem, where the size can be specified using common names such as \f(CW\*(C`32G\*(C'\fR (32 gigabytes) etc. .Sp -If the size is not specified, a default size of 4 \s-1GB\s0 is used. +If the size is not specified, a default size of 4 GB is used. .Sp To specify size in bytes, the number must be followed by the lowercase -letter \fIb\fR, eg: \f(CW\*(C`\-\-size 10737418240b\*(C'\fR. -.IP "\fB\-v\fR" 4 +letter \fIb\fR, eg: \f(CW\*(C`\-\-size\ 10737418240b\*(C'\fR. +.IP \fB\-v\fR 4 .IX Item "-v" .PD 0 -.IP "\fB\-\-verbose\fR" 4 +.IP \fB\-\-verbose\fR 4 .IX Item "--verbose" .PD Enable verbose messages. .Sp You can give this option multiple times to enable even more messages: .RS 4 -.IP "\fI\-v\fR" 4 +.IP \fI\-v\fR 4 .IX Item "-v" Debugging of overall stages. .IP "\fI\-v \-v\fR" 4 @@ -392,10 +376,10 @@ .RE .RS 4 .RE -.IP "\fB\-V\fR" 4 +.IP \fB\-V\fR 4 .IX Item "-V" .PD 0 -.IP "\fB\-\-version\fR" 4 +.IP \fB\-\-version\fR 4 .IX Item "--version" .PD Print the package name and version number, and exit. @@ -403,7 +387,7 @@ .IX Header "SUPERMIN APPLIANCES" Supermin appliances consist of just enough information to be able to build an appliance containing the same operating system (Linux -version, distro, release etc) as the host \s-1OS.\s0 Since the host and +version, distro, release etc) as the host OS. Since the host and appliance share many common files such as \fI/bin/bash\fR and \&\fI/lib/libc.so\fR there is no reason to ship these files in the appliance. They can simply be read from the host on demand when the @@ -419,16 +403,16 @@ .PP Therefore the supermin appliance normally consists of at least two control files (\fIpackages\fR and \fIbase.tar.gz\fR). -.IP "\fIpackages\fR" 4 +.IP \fIpackages\fR 4 .IX Item "packages" The list of packages to be copied from the host. Dependencies are resolved automatically. .Sp The file is plain text, one package name per line. -.IP "\fIbase.tar\fR" 4 +.IP \fIbase.tar\fR 4 .IX Item "base.tar" .PD 0 -.IP "\fIbase.tar.gz\fR" 4 +.IP \fIbase.tar.gz\fR 4 .IX Item "base.tar.gz" .PD This tar file (which may be compressed) contains the skeleton @@ -437,7 +421,7 @@ .Sp All paths in the tar file should be relative to the root directory of the appliance. -.IP "\fIhostfiles\fR" 4 +.IP \fIhostfiles\fR 4 .IX Item "hostfiles" Any other files that are to be copied from the host. This is a plain text file with one pathname per line. @@ -453,11 +437,11 @@ .Sp Each pathname in the file should start with a \f(CW\*(C`/\*(C'\fR character. .Sp -Supermin itself does not create hostfiles (although before version 5, this was the main mechanism used to create the full appliance). +Supermin itself does not create hostfiles (although before version\ 5, this was the main mechanism used to create the full appliance). However you may drop one or more of these files into the supermin appliance directory if you want to copy random unpackaged files into the full appliance. -.IP "\fIexcludefiles\fR" 4 +.IP \fIexcludefiles\fR 4 .IX Item "excludefiles" A list of filenames, directory names, or wildcards prefixed by \f(CW\*(C`\-\*(C'\fR which are excluded from the final appliance. @@ -474,7 +458,7 @@ you want, as supermin detects the contents of each file when it reconstructs the appliance. You can also have multiple of each type of file. -.SS "\s-1RECONSTRUCTING THE APPLIANCE\s0" +.SS "RECONSTRUCTING THE APPLIANCE" .IX Subsection "RECONSTRUCTING THE APPLIANCE" The separate mode \f(CW\*(C`supermin \-\-build\*(C'\fR is used to reconstruct an appliance from the supermin appliance files. @@ -495,9 +479,9 @@ it into the directory, and additional host files can be added (\fIzz-hostfiles\fR in the example above). When the appliance is constructed, the extra files will appear in the appliance. -.SS "\s-1MINIMIZING THE SUPERMIN APPLIANCE\s0" +.SS "MINIMIZING THE SUPERMIN APPLIANCE" .IX Subsection "MINIMIZING THE SUPERMIN APPLIANCE" -You may want to \*(L"minimize\*(R" the supermin appliance in order to save +You may want to "minimize" the supermin appliance in order to save time and space when it is instantiated. Typically you might want to remove documentation, info files, man pages and locales. .PP @@ -515,7 +499,7 @@ .PP Be careful what you remove because files may be necessary for correct operation of the appliance. -.SS "\s-1KERNEL AND KERNEL MODULES\s0" +.SS "KERNEL AND KERNEL MODULES" .IX Subsection "KERNEL AND KERNEL MODULES" Usually the kernel and kernel modules are \fInot\fR included in the supermin appliance. @@ -523,12 +507,12 @@ When the full appliance is built, the kernel modules from the host are copied in, and it is booted using the host kernel. .PP -\fI\s-1USING A CUSTOM KERNEL AND KERNEL MODULES\s0\fR +\fIUSING A CUSTOM KERNEL AND KERNEL MODULES\fR .IX Subsection "USING A CUSTOM KERNEL AND KERNEL MODULES" .PP Supermin is able to choose the best host kernel available to boot the appliance. However you can override this by setting environment -variables (see \*(L"\s-1ENVIRONMENT VARIABLES\*(R"\s0 below). +variables (see "ENVIRONMENT VARIABLES" below). .PP If you build a custom kernel (eg. by compiling Linux from source), then you should do something like this: @@ -544,30 +528,30 @@ \& \& supermin \-\-build \-f ext2 [etc] .Ve -.SS "\s-1ENFORCING AVAILABILITY OF PACKAGES\s0" +.SS "ENFORCING AVAILABILITY OF PACKAGES" .IX Subsection "ENFORCING AVAILABILITY OF PACKAGES" Supermin builds the appliance by copying in the packages listed in \&\fIpackages\fR. For this to work those packages must be available. We -usually enforce this by adding requirements (eg. \s-1RPM\s0 \f(CW\*(C`Requires:\*(C'\fR +usually enforce this by adding requirements (eg. RPM \f(CW\*(C`Requires:\*(C'\fR lines) on the package that uses the supermin appliance, so that package cannot be installed without pulling in the dependent packages and thus making sure the packages are installed for supermin to use. .SH "ENVIRONMENT VARIABLES" .IX Header "ENVIRONMENT VARIABLES" -.IP "\s-1SUPERMIN_KERNEL\s0" 4 +.IP SUPERMIN_KERNEL 4 .IX Item "SUPERMIN_KERNEL" If this environment variable is set, then automatic selection of the kernel is bypassed and this kernel is used. .Sp The environment variable should point to a kernel file, eg. \fI/boot/vmlinuz\-3.0.x86_64\fR -.IP "\s-1SUPERMIN_MODULES\s0" 4 +.IP SUPERMIN_MODULES 4 .IX Item "SUPERMIN_MODULES" This specifies the kernel modules directory to use. .Sp The environment variable should point to a module directory, eg. \fI/lib/modules/3.0.x86_64/\fR -.IP "\s-1SUPERMIN_KERNEL_VERSION\s0" 4 +.IP SUPERMIN_KERNEL_VERSION 4 .IX Item "SUPERMIN_KERNEL_VERSION" On non\-x86 architectures, you may need to set this environment variable if supermin cannot determine the kernel version of @@ -577,26 +561,26 @@ <http://people.redhat.com/~rjones/supermin/>, \&\fBguestfs\fR\|(3), <http://libguestfs.org/>. -.SH "AUTHORS" +.SH AUTHORS .IX Header "AUTHORS" -.IP "\(bu" 4 +.IP \(bu 4 Richard W.M. Jones <http://people.redhat.com/~rjones/> -.IP "\(bu" 4 +.IP \(bu 4 Matthew Booth -.SH "COPYRIGHT" +.SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2009\-2016 Red Hat Inc. .PP This program is free software; you can redistribute it and/or modify -it under the terms of the \s-1GNU\s0 General Public License as published by +it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. .PP This program is distributed in the hope that it will be useful, -but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of -\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the -\&\s-1GNU\s0 General Public License for more details. +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. .PP -You should have received a copy of the \s-1GNU\s0 General Public License +You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software -Foundation, Inc., 675 Mass Ave, Cambridge, \s-1MA 02139, USA.\s0 +Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
