RepoMirrors
/
kpatch
mirror of https://github.com/dynup/kpatch
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
kpatch/man/kpatch-build.1

84 lines
1.9 KiB
Groff
Raw Normal View History

added man pages and updated SPEC file
2014-03-25 07:36:20 +00:00
.\" 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
Allow OOT modules to be built with non-distro kernels Previously OOT-module builds used `--sourcedir` to specify oot-module source directory which was a bit confusing and also denied users ability to build kpatches agains oot modules built against non-distro kernels. This patch adds `-p/--oot-module-src` option to specify source dir for oot module while keeping `--sourcedir` for kernel source directory specification. I also tried to disambiguate `SRCDIR` in kpatch-build a bit. Now there are 3 variables: - `KERNEL_SRCDIR` - contains path to kernel source directory - `OOT_MODULEL_SRCDIR` - contains path to out-of-tree module source directory - `BUILDDIR` - can be set to either of the above and is used for patch-related actions Another attempt at this was done by @omatiusha in #1234 Signed-off-by: Artem Savkov <asavkov@redhat.com>
2021-12-06 14:02:04 +00:00
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
added man pages and updated SPEC file
2014-03-25 07:36:20 +00:00
effect.
.SH OPTIONS
-h|--help
Show this help message
add sourcerpm option to kpatch-build man page Signed-off-by: Seth Jennings <sjenning@redhat.com>
2014-04-07 17:02:33 +00:00
updated man page
2017-12-21 17:15:57 +00:00
-a|--archversion
Specify the kernel arch version
add sourcerpm option to kpatch-build man page Signed-off-by: Seth Jennings <sjenning@redhat.com>
2014-04-07 17:02:33 +00:00
-r|--sourcerpm
Specify kernel source RPM
Allow OOT modules to be built with non-distro kernels Previously OOT-module builds used `--sourcedir` to specify oot-module source directory which was a bit confusing and also denied users ability to build kpatches agains oot modules built against non-distro kernels. This patch adds `-p/--oot-module-src` option to specify source dir for oot module while keeping `--sourcedir` for kernel source directory specification. I also tried to disambiguate `SRCDIR` in kpatch-build a bit. Now there are 3 variables: - `KERNEL_SRCDIR` - contains path to kernel source directory - `OOT_MODULEL_SRCDIR` - contains path to out-of-tree module source directory - `BUILDDIR` - can be set to either of the above and is used for patch-related actions Another attempt at this was done by @omatiusha in #1234 Signed-off-by: Artem Savkov <asavkov@redhat.com>
2021-12-06 14:02:04 +00:00
added man pages and updated SPEC file
2014-03-25 07:36:20 +00:00
-s|--sourcedir
Specify kernel source directory
-c|--config
Specify kernel config file
added missing options -v, -t and -d
2014-09-26 17:12:45 +00:00
-v|--vmlinux
Specify original vmlinux
updated man page
2017-12-21 17:15:57 +00:00
-j|--jobs
Specify the number of make jobs
added missing options -v, -t and -d
2014-09-26 17:12:45 +00:00
-t|--target
Specify custom kernel build targets
updated man page
2017-12-21 17:15:57 +00:00
-n|--name
Specify the name of the kpatch module
-o|--output
Specify output folder
added missing options -v, -t and -d
2014-09-26 17:12:45 +00:00
-d|--debug
Keep scratch files in /tmp
updated man page
2017-12-21 17:15:57 +00:00
(can be specified multiple times)
Allow OOT modules to be built with non-distro kernels Previously OOT-module builds used `--sourcedir` to specify oot-module source directory which was a bit confusing and also denied users ability to build kpatches agains oot modules built against non-distro kernels. This patch adds `-p/--oot-module-src` option to specify source dir for oot module while keeping `--sourcedir` for kernel source directory specification. I also tried to disambiguate `SRCDIR` in kpatch-build a bit. Now there are 3 variables: - `KERNEL_SRCDIR` - contains path to kernel source directory - `OOT_MODULEL_SRCDIR` - contains path to out-of-tree module source directory - `BUILDDIR` - can be set to either of the above and is used for patch-related actions Another attempt at this was done by @omatiusha in #1234 Signed-off-by: Artem Savkov <asavkov@redhat.com>
2021-12-06 14:02:04 +00:00
--oot-module
manpages: update kpatch-build with --oot-module option Signed-off-by: Joe Lawrence <joe.lawrence@redhat.com>
2019-02-21 14:47:47 +00:00
Enable patching out-of-tree module,
specify current version of module
Allow OOT modules to be built with non-distro kernels Previously OOT-module builds used `--sourcedir` to specify oot-module source directory which was a bit confusing and also denied users ability to build kpatches agains oot modules built against non-distro kernels. This patch adds `-p/--oot-module-src` option to specify source dir for oot module while keeping `--sourcedir` for kernel source directory specification. I also tried to disambiguate `SRCDIR` in kpatch-build a bit. Now there are 3 variables: - `KERNEL_SRCDIR` - contains path to kernel source directory - `OOT_MODULEL_SRCDIR` - contains path to out-of-tree module source directory - `BUILDDIR` - can be set to either of the above and is used for patch-related actions Another attempt at this was done by @omatiusha in #1234 Signed-off-by: Artem Savkov <asavkov@redhat.com>
2021-12-06 14:02:04 +00:00
--oot-module-src
Specify out-of-tree module source directory
manpages: update kpatch-build with -R | --non-replace option Signed-off-by: Song Liu <song@kernel.org>
2021-05-25 22:20:59 +00:00
-R|--non-replace
Disable replace flag of KLP
(replace is on by default)
updated man page
2017-12-21 17:15:57 +00:00
--skip-cleanup
Skip post-build cleanup
added missing options -v, -t and -d
2014-09-26 17:12:45 +00:00
kpatch-build: clang support Add support for clang-built kernels. This is completely automatic, we check if the kernel was built with clang by looking for CONFIG_CC_IS_CLANG in config. This has almost no effect on non-clang built kernels with one exception: we now do compliler checks _after_ we download kernel sources which is a waste of resources in case when compilers don't match. Signed-off-by: Artem Savkov <asavkov@redhat.com>
2021-01-27 10:41:49 +00:00
--skip-compiler-check
Skips check that ensures that the system compiler version and
the compiler version that built the kernel match. Skipping this
check is not recommended, but is useful if the exact compiler
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 18:57:53 +00:00
version is not available or is not easily installed. Use
kpatch-build: clang support Add support for clang-built kernels. This is completely automatic, we check if the kernel was built with clang by looking for CONFIG_CC_IS_CLANG in config. This has almost no effect on non-clang built kernels with one exception: we now do compliler checks _after_ we download kernel sources which is a waste of resources in case when compilers don't match. Signed-off-by: Artem Savkov <asavkov@redhat.com>
2021-01-27 10:41:49 +00:00
only when confident that the two versions of compiler output
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 18:57:53 +00:00
identical objects for a given target. Otherwise, use of
this option might result in unexpected changed objects
being detected.
added missing options -v, -t and -d
2014-09-26 17:12:45 +00:00
added man pages and updated SPEC file
2014-03-25 07:36:20 +00:00
.SH SEE ALSO
kpatch(1)
.SH BUGS
No known bugs.
.SH AUTHOR
Udo Seidel (udoseidel@gmx.de)
fixed typos
2014-03-25 16:12:50 +00:00
.SH COPYRIGHT
Allow OOT modules to be built with non-distro kernels Previously OOT-module builds used `--sourcedir` to specify oot-module source directory which was a bit confusing and also denied users ability to build kpatches agains oot modules built against non-distro kernels. This patch adds `-p/--oot-module-src` option to specify source dir for oot module while keeping `--sourcedir` for kernel source directory specification. I also tried to disambiguate `SRCDIR` in kpatch-build a bit. Now there are 3 variables: - `KERNEL_SRCDIR` - contains path to kernel source directory - `OOT_MODULEL_SRCDIR` - contains path to out-of-tree module source directory - `BUILDDIR` - can be set to either of the above and is used for patch-related actions Another attempt at this was done by @omatiusha in #1234 Signed-off-by: Artem Savkov <asavkov@redhat.com>
2021-12-06 14:02:04 +00:00
Copyright (C) 2014: Seth Jennings <sjenning@redhat.com>, Copyright (C)
added man pages and updated SPEC file
2014-03-25 07:36:20 +00:00
2013,2014: Josh Poimboeuf <jpoimboe@redhat.com>