Sign Up
Log In
Log In
or
Sign Up
Places
All Projects
Status Monitor
Collapse sidebar
SUSE:SLE-12-SP4:Update
kgraft
kgr.man
Overview
Repositories
Revisions
Requests
Users
Attributes
Meta
File kgr.man of Package kgraft
.\" Libor Pechacek <lpechacek@suse.com> .\" .TH KGR 8 2017-12-12 "SLES 12" "SLE Live Patching" .SH NAME kgr \- query and manipulate kGraft patching status .SH SYNOPSIS .ll +8 .B kgr .RB [ " \-hv " ] .RI COMMAND .ll -8 .SH DESCRIPTION .I kgr command can be used for getting a quick overview of the kGraft patching status. Also it can poke blocking processes and move forward with the patching. For some of the commands, the output can be made more verbose by using .B \-v option. .SH COMMANDS .TP .B status Display the overall status of kGraft patching (ready or in_progress) .TP .B check Indicate the overall kGraft patching status with exit code. This command is intended for use in scripts. .TP .B patches Display the list of loaded patches. By default the command prints lists only kernel modules which contain kGraft patches. With .B \-v additional fields are printed. .I Active tells whether the patch is currently in use or can be unloaded. .I RPM shows the RPM package name in which the kGraft patch was distributed. .I CVE lists fixes included in this kGraft patch, which have CVE numbers assigned. .I "Bug fixes and enhancements" lists changes included in this kGraft patch, which do not have CVEs assigned. More information about individual changes can be found in the patch RPM package change log, SUSE Security Advisories, CVE database and the patch RPM source code. .TP .B blocking List processes that are preventing kGraft patching from finishing. By default just the PIDs are listed. Specifying .B \-v will make .I kgr print out the command line. Another .B \-v will display also stack traces if available. .TP .B blocking_threads List process threads that are preventing kGraft patching from finishing. This commands gives a more detailed view than .I kgr .IR blocking . First column shows the process id, second column shows the thread id. Option .B \-v has the same effect as with .I kgr .IR blocking . .TP .B poke Send STOP and CONT signals to processess that are blocking kGraft progress. See .SM .B CAVEATS for discussion about this method. .SH OPTIONS .TP .B \-h --help Display a help screen and quit. .TP .B \-v --verbose Verbose. Makes .I kgr print out process command line with .B blocking and .B blocking_threads commands. Another .B \-v will display also strack traces. .TP .B \--version Version. Display the version number. .SH EXIT STATUS With .B check command the exit status is 0 when system is ready for kernel live patching and 1 when patching is in progress. For other commands the exit status is 0 upon successful command completion and 1 upon error. .SH CAVEATS By design, kGraft technology requires the processes to cross the user space/kernel boundary to present them with the patched kernel code. Processes that sleep in kernel code at the time the patch module is loaded will prevent patching process from finishing until they leave kernel space. These processes usually leave kernel after the event, for which they are waiting, happens or timeout elapses. .P Sending regular processes STOP signal followed by CONT signal achieves the goal of making them to cross the user space/kernel boundary immediately. However, this method may not be suitable for all processes running in the system and does not apply to kernel threads and processess in .B D process state.
Locations
Projects
Search
Status Monitor
Help
OpenBuildService.org
Documentation
API Documentation
Code of Conduct
Contact
Support
@OBShq
Terms
openSUSE Build Service is sponsored by
The Open Build Service is an
openSUSE project
.
Sign Up
Log In
Places
Places
All Projects
Status Monitor