Source code for insights.combiners.grub_conf

GrubConf - The valid GRUB configuration
Combiner for Red Hat Grub v1 and Grub v2 information.

This combiner uses the parsers:
:class:`insights.parsers.grub_conf.Grub2EFIConfig`, and

It determines which parser was used by checking one of the follwing
:class:`insights.parsers.ls_sys_firmware.LsSysFirmware`, and


from insights.core.plugins import combiner
from insights.combiners.redhat_release import RedHatRelease
from insights.parsers.grub_conf import BootEntry, get_kernel_initrds
from insights.parsers.grub_conf import Grub1Config, Grub1EFIConfig
from insights.parsers.grub_conf import Grub2Config, Grub2EFIConfig
from insights.parsers.grub_conf import BootLoaderEntries as BLE
from insights.parsers.ls_sys_firmware import LsSysFirmware
from insights.parsers.installed_rpms import InstalledRpms
from insights.parsers.cmdline import CmdLine
from insights import SkipComponent

[docs]@combiner(BLE, optional=[LsSysFirmware]) class BootLoaderEntries(object): """ Combine all :class:`insights.parsers.grub_conf.BootLoaderEntries` parsers into one Combiner Raises: SkipComponent: when no any BootLoaderEntries Parsers. Attributes: version (int): The version of the GRUB configuration, 1 or 2 is_efi (bool): If the host is boot with EFI entries (list): List of all boot entries in GRUB configuration. boot_entries (list): List of all boot entries which only contains the name and cmdline. kernel_initrds (dict): Dict of the `kernel` and `initrd` files referenced in GRUB configuration files is_kdump_iommu_enabled (bool): If any kernel entry contains "intel_iommu=on" """ def __init__(self, grub_bles, sys_firmware): self.version = self._version = 2 self.is_efi = self._efi = '/sys/firmware/efi' in sys_firmware if sys_firmware else False self.entries = [] self.boot_entries = [] self.is_kdump_iommu_enabled = False for ble in grub_bles: self.entries.append(ble.entry) self.boot_entries.append(BootEntry({'name': ble.title, 'cmdline': ble.cmdline})) self.is_kdump_iommu_enabled = self.is_kdump_iommu_enabled or ble.is_kdump_iommu_enabled self.kernel_initrds = get_kernel_initrds(self.entries) if not self.entries: raise SkipComponent()
[docs]@combiner([Grub1Config, Grub2Config, Grub1EFIConfig, Grub2EFIConfig, BootLoaderEntries], optional=[InstalledRpms, CmdLine, LsSysFirmware, RedHatRelease]) class GrubConf(object): """ Process Grub configuration v1 or v2 based on which type is passed in. Examples: >>> type(grub_conf) <class 'insights.combiners.grub_conf.GrubConf'> >>> grub_conf.version 2 >>> grub_conf.is_efi False >>> grub_conf.kernel_initrds {'grub_initrds': ['/initramfs-3.10.0-327.36.3.el7.x86_64.img'], 'grub_kernels': ['/vmlinuz-3.10.0-327.36.3.el7.x86_64']} >>> grub_conf.is_kdump_iommu_enabled False >>> grub_conf.get_grub_cmdlines('') [] Raises: Exception: when cannot find any valid grub configuration. Attributes: version (int): returns 1 or 2, version of the GRUB configuration is_efi (bool): returns True if the host is boot with EFI kernel_initrds (dict): returns a dict of the `kernel` and `initrd` files referenced in GRUB configuration files is_kdump_iommu_enabled (bool): returns True if any kernel entry contains "intel_iommu=on" """ def __init__(self, grub1, grub2, grub1_efi, grub2_efi, grub_bles, rpms, cmdline, sys_firmware, rh_rel): self.version = self.is_kdump_iommu_enabled = None self.grub = self.kernel_initrds = None _grubs = list(filter(None, [grub1, grub2, grub1_efi, grub2_efi, grub_bles])) # Check if `/sys/firmware/efi` exist? self.is_efi = '/sys/firmware/efi' in sys_firmware if sys_firmware else False if len(_grubs) == 1: self.grub = _grubs[0] self.is_efi = self.is_efi if sys_firmware else self.grub._efi else: _grub1, _grub2 = (grub1_efi, grub2_efi) if self.is_efi else (grub1, grub2) if rh_rel and rh_rel.rhel8: self.grub = grub_bles # Check grub version via installed-rpms else: if rpms: # grub1 if 'grub2' not in rpms and 'grub' in rpms and _grub1 is not None: self.grub = _grub1 # grub2 if 'grub' not in rpms and 'grub2' in rpms and _grub2 is not None: self.grub = _grub2 # Check grub version via the booted CmdLine if self.grub is None and cmdline: # grub1 if "BOOT_IMAGE" not in cmdline or 'rd_LVM_LV' in cmdline: self.grub = _grub1 # grub2 if "BOOT_IMAGE" in cmdline or '' in cmdline: self.grub = _grub2 if self.grub: self.version = self.grub._version self.is_kdump_iommu_enabled = self.grub.is_kdump_iommu_enabled self.kernel_initrds = self.grub.kernel_initrds or {} else: raise Exception('No valid grub configuration is found.')
[docs] def get_grub_cmdlines(self, search_text=None): """ Get the boot entries in which `cmdline` contains the `search_text`, return all the boot entries by default. Arguments: search_text(str): keyword to find in the `cmdline`, being set to None by default. Returns: A list of :class:`insights.parsers.grub_conf.BootEntry` objects fo each boot entry in which the `cmdline` contains the `search_text`. When `search_text` is None, returns the objects of all of the boot entries. """ if search_text is None: return self.grub.boot_entries elif search_text: return [e for e in self.grub.boot_entries if search_text in e.get('cmdline', '')] return []