dissect.target.plugins.os.unix.linux.redhat.yum#

Module Contents#

Classes#

YumPlugin

Base class for plugins.

Attributes#

dissect.target.plugins.os.unix.linux.redhat.yum.YUM_LOG_KEYWORDS = ['Installed', 'Updated', 'Erased', 'Obsoleted']#
dissect.target.plugins.os.unix.linux.redhat.yum.RE_TS#
class dissect.target.plugins.os.unix.linux.redhat.yum.YumPlugin(target: dissect.target.Target)#

Bases: dissect.target.plugin.Plugin

Base class for plugins.

Plugins can optionally be namespaced by specifying the __namespace__ class attribute. Namespacing results in your plugin needing to be prefixed with this namespace when being called. For example, if your plugin has specified test as namespace and a function called example, you must call your plugin with test.example:

A Plugin class has the following private class attributes:

  • __namespace__

  • __record_descriptors__

With the following three being assigned in register():

  • __plugin__

  • __functions__

  • __exports__

Additionally, the methods and attributes of Plugin receive more private attributes by using decorators.

The export() decorator adds the following private attributes

  • __exported__

  • __output__: Set with the export() decorator.

  • __record__: Set with the export() decorator.

The internal() decorator and InternalPlugin set the __internal__ attribute. Finally. args() decorator sets the __args__ attribute.

Parameters:

target – The Target object to load the plugin for.

__namespace__ = 'yum'#
LOG_DIR_PATH = '/var/log'#
LOG_FILES_GLOB = 'yum.*'#
check_compatible() None#

Perform a compatibility check with the target.

This function should return None if the plugin is compatible with the current target (self.target). For example, check if a certain file exists. Otherwise it should raise an UnsupportedPluginError.

Raises:

UnsupportedPluginError – If the plugin could not be loaded.

logs() Iterator[dissect.target.plugins.os.unix.packagemanager.PackageManagerLogRecord]#

Package manager log parser for CentOS’ Yellowdog Updater (Yum).

Example log format:

Dec 16 04:41:22 Installed: unzip-6.0-24.el7_9.x86_64
Dec 16 04:41:25 Installed: unzip-6.0-22.el7_9.x86_64
Dec 16 04:41:28 Updated: unzip-6.0-24.el7_9.x86_64
Dec 16 04:41:30 Erased: unzip-6.0-24.el7_9.x86_64
Dec 16 04:41:34 Installed: unzip-6.0-24.el7_9.x86_64