dissect.target.plugins.os.unix.bsd.ios._os

Module Contents

Classes

IOSPlugin

Base class for OS plugins.

class dissect.target.plugins.os.unix.bsd.ios._os.IOSPlugin(target: dissect.target.target.Target)

Bases: dissect.target.plugins.os.unix.bsd._os.BsdPlugin

Base class for OS plugins.

This provides a base class for certain common functions of OS’s, which each OS plugin has to implement separately.

For example, it provides an interface for retrieving the hostname and users of a target.

All derived classes MUST implement ALL the classmethods and exported methods with the same @classmethod or @export(...) annotation.

classmethod detect(target)

Provide detection of this OSPlugin on a given filesystem.

Parameters:

fsFilesystem to detect the OS on.

Returns:

The root filesystem / sysvol when found.

classmethod create(target, sysvol)

Initiate this OSPlugin with the given target and detected filesystem.

Parameters:
  • target – The Target object.

  • sysvol – The filesystem that was detected in the detect() function.

Returns:

An instantiated version of the OSPlugin.

hostname()

Return the target’s hostname.

Returns:

The hostname as string.

abstract ips()

Return the IP addresses configured in the target.

Returns:

The IPs as list.

abstract version()

Return the target’s OS version.

Returns:

The OS version as string.

abstract users()

Recover users from /etc/passwd, /etc/master.passwd or /var/log/syslog session logins.

os() str

Return a slug of the target’s OS name.

Returns:

A slug of the OS name, e.g. ‘windows’ or ‘linux’.