openc2lib.types.targets.process

 1from typing import Self
 2
 3from openc2lib.types.base import Map
 4from openc2lib.types.targets import File
 5from openc2lib.core.target import target
 6
 7@target('process')
 8class Process(Map):
 9	""" OpenC2 Process
10
11		Implements the `process` target (Section 3.4.1.15). 
12		Common properties of an instance of a computer program as executed on an operating system.
13
14	"""
15	fields = {'pid': int, 'name': str, 'cwd': str, 'executable': File, 'parent': Self, 'command_line': str}
16	"""
17		Internal class members are just provided as reference for valid fields and to map their name
18		to the expected type. They shall not be instantiated or used directly.
19		`pid`: Process ID of the process 
20		`name`: Name of the process 
21		`cwd`: Current working directory of the process 
22		`executable`: Executable that was executed to start the process 
23		`parent`: Process that spawned this one 
24		`command_line`: The full command line invocation used to start this process, including all arguments 
25	"""
26
27	def __init__(self, process: dict):
28		super().__init__(process)
29		# Explicit control on each field is carried out to manage the possibility of wrong
30		# inputs or inputs defined by extensions
31		for x in self.keys():
32			if x in self.fields:
33				return
34		raise ValueError("A 'Process' Target MUST contain at least one property.")