dissect.target.plugins.os.unix.linux.services#

Module Contents#

Classes#

ServicesPlugin

Base class for plugins.

Functions#

should_ignore_file

Attributes#

RECORD_NAME

DEFAULT_ELEMENTS

LinuxServiceRecord

dissect.target.plugins.os.unix.linux.services.RECORD_NAME = 'linux/service'#
dissect.target.plugins.os.unix.linux.services.DEFAULT_ELEMENTS = [('datetime', 'ts'), ('string', 'type'), ('string', 'name'), ('path', 'source')]#
dissect.target.plugins.os.unix.linux.services.LinuxServiceRecord#
class dissect.target.plugins.os.unix.linux.services.ServicesPlugin(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.

SYSTEMD_PATHS = ['/etc/systemd/system', '/lib/systemd/system', '/usr/lib/systemd/system']#
INITD_PATHS = ['/etc/rc.d/init.d', '/etc/init.d']#
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.

services() → Iterator[LinuxServiceRecord]#

Return information about all installed systemd and init.d services.

References: - https://geeksforgeeks.org/what-is-init-d-in-linux-service-management - http://0pointer.de/blog/projects/systemd-for-admins-3.html - https://www.freedesktop.org/software/systemd/man/systemd.syntax.html

systemd() → Iterator[LinuxServiceRecord]#
initd() → Iterator[LinuxServiceRecord]#
dissect.target.plugins.os.unix.linux.services.should_ignore_file(needle: str, haystack: list) → bool#