From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 756CB138334 for ; Mon, 25 Mar 2019 02:08:05 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7C18BE0967; Mon, 25 Mar 2019 02:08:04 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 3C017E0967 for ; Mon, 25 Mar 2019 02:08:04 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id E629F335C47 for ; Mon, 25 Mar 2019 02:08:01 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 4C2EE570 for ; Mon, 25 Mar 2019 02:08:00 +0000 (UTC) From: "Thomas Deutschmann" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Thomas Deutschmann" Message-ID: <1553477644.8de84b46dbd7c012c5f3c69b7b8b22e692b89c76.whissi@gentoo> Subject: [gentoo-commits] proj/genkernel:master commit in: doc/ X-VCS-Repository: proj/genkernel X-VCS-Files: doc/genkernel.8.txt X-VCS-Directories: doc/ X-VCS-Committer: whissi X-VCS-Committer-Name: Thomas Deutschmann X-VCS-Revision: 8de84b46dbd7c012c5f3c69b7b8b22e692b89c76 X-VCS-Branch: master Date: Mon, 25 Mar 2019 02:08:00 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 4c139fcc-312d-41c5-8eaa-b8cb82aa3a18 X-Archives-Hash: 26e67a2850b1dd9146db33c998d95a43 commit: 8de84b46dbd7c012c5f3c69b7b8b22e692b89c76 Author: Thomas Deutschmann gentoo org> AuthorDate: Mon Mar 25 00:59:47 2019 +0000 Commit: Thomas Deutschmann gentoo org> CommitDate: Mon Mar 25 01:34:04 2019 +0000 URL: https://gitweb.gentoo.org/proj/genkernel.git/commit/?id=8de84b46 man page: Update Signed-off-by: Thomas Deutschmann gentoo.org> doc/genkernel.8.txt | 93 ++++++++++++++++++++++++++++++----------------------- 1 file changed, 53 insertions(+), 40 deletions(-) diff --git a/doc/genkernel.8.txt b/doc/genkernel.8.txt index ca84816..26196db 100644 --- a/doc/genkernel.8.txt +++ b/doc/genkernel.8.txt @@ -68,7 +68,7 @@ You can specify your options in any order. CONFIGURATION OPTIONS ~~~~~~~~~~~~~~~~~~~~~ *--config*=:: - Genkernel configuration file to use + Genkernel configuration file to use. DEBUGGING OPTIONS @@ -97,18 +97,28 @@ KERNEL CONFIGURATION *--*[*no-*]*nconfig*:: Runs, or does not run "make nconfig" after running "make oldconfig". +*--*[*no-*]*gconfig*:: + Runs, or does not run "make gconfig" after "make oldconfig". + +*--*[*no-*]*xconfig*:: + Runs, or does not run "make xconfig" after "make oldconfig". + *--*[*no-*]*save-config*:: Saves, or does not save the kernel configuration to '/etc/kernels' if the kernel is successfully compiled. -*--virtio*:: - Adds Virtio support to kernel configuration. +*--*[*no-*]*hyperv*:: + Adds, or skip adding Microsoft Hyper-V support to kernel configuration. -*--*[*no-*]*gconfig*:: - Runs, or does not run "make gconfig" after "make oldconfig". +*--microcode*[=]:: + Adds early microcode loading support for all, only AMD or Intel processors + to kernel configuration. -*--*[*no-*]*xconfig*:: - Runs, or does not run "make xconfig" after "make oldconfig". +*--no-microcode*:: + Do not add early microcode loading support to kernel configuration. + +*--*[*no-*]*virtio*:: + Adds, or skip adding VirtIO support to kernel configuration. KERNEL COMPILATION @@ -202,10 +212,10 @@ LOW-LEVEL COMPILATION OPTIONS *--kernel-target*=:: Override default make target (bzImage), note that values like *--kernel-target=* are also valid (useful for Xen - based kernel sources) + based kernel sources). *--kernel-binary*=:: - Override default kernel binary path (arch/foo/boot/bar) + Override default kernel binary path (arch/foo/boot/bar). *--kernel-outputdir*=:: Save output files outside the source tree. This should be used rather than @@ -231,6 +241,9 @@ LOW-LEVEL COMPILATION OPTIONS *--utils-arch*=:: Force to arch for utils only instead of autodetect. +*--makeopts*=:: + GNU Make options such as -j2, etc. + *--*[*no-*]*mountboot*:: Mount, or not, BOOTDIR automatically if mountable. @@ -240,13 +253,11 @@ LOW-LEVEL COMPILATION OPTIONS *--modprobedir*=:: Set the location of the modprobe.d-directory, default is '/etc/modprobe.d'. -*--makeopts*=:: - GNU Make options such as -j2, etc. - *--*[*no-*]*nice*[=]:: Runs the kernel make at the default niceness (reduction in priority) of 10, or in the case of --no-nice, runs the kernel make at normal priority. + INITIALIZATION ~~~~~~~~~~~~~~ *--splash*=:: @@ -279,15 +290,17 @@ INITIALIZATION By default the ramdisk will be built *without* an mdadm.conf and will auto-detect arrays during boot-up. +*--*[*no-*]*microcode-initramfs*:: + Prepends, or do not prepend ucode(s) to the initramfs. + But only when kernel configuration does support early microcode loading. + See *--microcode* option to auto-update kernel configuration. + *--*[*no-*]*dmraid*:: Includes or excludes DMRAID support. *--*[*no-*]*nfs*:: Includes or excludes NFS support. -*--*[*no-*]*microcode*:: - Includes or excludes early microcode support. - *--*[*no-*]*e2fsprogs*:: Includes or excludes e2fsprogs. @@ -298,19 +311,16 @@ INITIALIZATION Includes or excludes Btrfs support. *--*[*no-*]*multipath*:: - Includes or excludes Multipath support + Includes or excludes Multipath support. *--*[*no-*]*iscsi*:: - Includes or excludes iSCSI support - -*--*[*no-*]*hyperv*:: - Includes or excludes Microsoft Hyper-V support + Includes or excludes iSCSI support. *--*[*no-*]*ssh*:: Includes or excludes SSH (dropbear) support for remote LUKS keys. -*--bootloader*=*grub*:: - Add new kernel to GRUB configuration. +*--bootloader*=:: + Add new kernel to GRUB or GRUB2 configuration. *--linuxrc*=:: Use for the linuxrc instead of the genkernel linuxrc. @@ -338,10 +348,10 @@ INITIALIZATION Includes or excludes busybox in the initrd or initramfs. *--*[*no-*]*unionfs*:: - Includes or excludes support for unionfs + Includes or excludes support for unionfs. *--*[*no-*]*netboot*:: - Creates or does not create a self-contained env in the initramfs + Creates or does not create a self-contained env in the initramfs. *--real-root*=:: Specify a default for *real_root*= kernel option. @@ -356,6 +366,9 @@ INTERNALS *--cachedir*=:: Override the default cache location. +*--*[*no-*]*clear-cachedir*:: + Clears or skips clearing all files in cache location on genkernel start. + *--tempdir*=:: Sets genkernel's temporary working directory to . @@ -367,14 +380,14 @@ OUTPUT SETTINGS ~~~~~~~~~~~~~~~ *--kernname*=<...>:: Tag the kernel and initrd with a name, if not defined this - option defaults to genkernel + option defaults to genkernel. *--minkernpackage*=:: File to output a .tar.bz2'd kernel and initrd: no modules outside of the initrd will be included... *--modulespackage*=:: - File to output a .tar.bz2'd modules after the callbacks have run + File to output a .tar.bz2'd modules after the callbacks have run. *--kerncache*=:: File to output a .tar.bz2'd kernel, contents of '/lib/modules/' @@ -388,14 +401,7 @@ OUTPUT SETTINGS *--initramfs-overlay*=:: Directory structure to include in the initramfs, only available - on >=2.6 kernels - -*--strip*=:: - Strip debug symbols from none, all, installed kernel (obsolete) or - modules (default). - -*--no-strip*:: - Alias for *--strip=none*. + on >=2.6 kernels. *--*[*no-*]*firmware*:: Enable or disables copying of firmware into initramfs. @@ -428,6 +434,13 @@ OUTPUT SETTINGS "Best" causes selection of the best available algorithm that is selected in your kernel configuration. +*--strip*=:: + Strip debug symbols from none, all, installed kernel (obsolete) or + modules (default). + +*--no-strip*:: + Alias for *--strip=none*. + RAMDISK/INITRAMFS OPTIONS ------------------------- @@ -466,7 +479,7 @@ recognized by the kernel itself. *root_trim*=(yes|no):: Enables TRIM support for a Luks-based root device. Only useful - with SSD setups. Have a look at 'http://en.wikipedia.org/wiki/TRIM' + with SSD setups. Have a look at 'https://en.wikipedia.org/wiki/TRIM' for more information. *swap_key*=<...>:: @@ -510,17 +523,17 @@ recognized by the kernel itself. *nfsroot*=<...>:: If present, the initrd will try to mount a livecd from that location. Otherwise the location will be deduced from the DCHP - request (option root-path) + request (option root-path). *dolvm*:: - Activate LVM volumes on bootup + Activate LVM volumes on bootup. *lvmraid*=<...>:: Specify RAID devices to set up before the activation of LVM volumes. Implies option *dolvm*. *domdadm*:: - Scan for RAID arrays on bootup + Scan for RAID arrays on bootup. *dozfs*[=cache,force]:: Scan for bootable ZFS pools on bootup. Optionally use cachefile or force import if @@ -530,7 +543,7 @@ recognized by the kernel itself. Scan for attached Btrfs devices on bootup. *domultipath*:: - Activate Multipath on bootup + Activate Multipath on bootup. *doscsi*:: Activate SCSI devices on bootup, necessary when SCSI support is @@ -614,7 +627,7 @@ recognized by the kernel itself. *aufs.modules*=<...>:: Use an alternate location for filesystem overlays to be added on top of - the livecd and below the writable tmpfs. Default is /modules/ + the livecd and below the writable tmpfs. Default is /modules/. *overlayfs*:: Enables support for Overlayfs (if available in the kernel).