kpatch/man/kpatch-build.1
Seth Jennings d3abeb667a Allow user to skip gcc version check
Right now, unless the entire gcc version string, including build date
and package version, matches the distro kernel exactly, kpatch-build
won't proceed.

For some distros, it is very difficult to rollback to a previous
version of gcc and keep that version pinned on the system so that the
package manager doesn't update it.

For these user, add a --skip-gcc-check flag to kpatch-build to allow the
version check to be skipped.  If the user does this, it is assumed they
know what they are doing.  This flag is documented as "not recommended".

Signed-off-by: Seth Jennings <sjenning@redhat.com>
2014-10-01 14:25:02 -05:00

60 lines
1.5 KiB
Groff

.\" Manpage for kpatch-build.
.\" Contact udoseidel@gmx.de to correct errors or typos.
.TH man 1 "23 Mar 2014" "1.0" "kpatch-build man page"
.SH NAME
kpatch-build \- build script
.SH SYNOPSIS
kpatch-build [options] <patch file>
.SH DESCRIPTION
This script takes a patch based on the version of the kernel
currently running and creates a kernel module that will replace
modified functions in the kernel such that the patched code takes
effect.
This script currently only works on Fedora and will need to be adapted
to work on other distros.
.SH OPTIONS
-h|--help
Show this help message
-r|--sourcerpm
Specify kernel source RPM
-s|--sourcedir
Specify kernel source directory
-c|--config
Specify kernel config file
-v|--vmlinux
Specify original vmlinux
-t|--target
Specify custom kernel build targets
-d|--debug
Keep scratch files in /tmp
--skip-gcc-check
Skips check that ensures that the system gcc version and
the gcc version that built the kernel match. Skipping this
check is not recommended, but is useful if the exact gcc
version is not available or is not easily installed. Use
only when confident that the two versions of gcc output
identical objects for a given target. Otherwise, use of
this option might result in unexpected changed objects
being detected.
.SH SEE ALSO
kpatch(1)
.SH BUGS
No known bugs.
.SH AUTHOR
Udo Seidel (udoseidel@gmx.de)
.SH COPYRIGHT
Copyright (C) 2014: Seth Jennings <sjenning@redhat.com>, Copyright (C)
2013,2014: Josh Poimboeuf <jpoimboe@redhat.com>