X fdZddlZddlZddlZddlmZmZmZddlm Z m Z m Z m Z ddl mZejeZde j$j&dee j(j*fdZd eee j(j*d ee j.j0deee j(j*fd Z dd ee j(j*de j$j&d ee j4j6ee j4j6fd ede j:deej<f dZy)a0Automagic modules allow the framework to populate configuration elements that a user has not provided. Automagic objects accept a `context` and a `configurable`, and will make appropriate changes to the `context` in an attempt to fulfill the requirements of the `configurable` object (or objects upon which that configurable may rely). Several pre-existing modules include one to stack layers on top of each other (allowing automatic detection and loading of file format types) as well as a module to reconstruct layers based on their provided requirements. N)ListTypeUnion)class_subclasses import_files interfaces constants) requirementscontextreturnc Dttjttj }t ttjjDcgc]3}||tjj||j5c}dScc}w)alReturns an ordered list of all subclasses of :class:`~volatility3.framework.interfaces.automagic.AutomagicInterface`. The order is based on the priority attributes of the subclasses, in order to ensure the automagics are listed in an appropriate order. Args: context: The context that will contain any automagic configuration values. c|jSN)priority)xs Z/home/panchajanya/Development/work/volatility3/volatility3/framework/automagic/__init__.pyzavailable...s ajj)key) rsysmodules__name__r AUTOMAGIC_CONFIG_PATHsortedrr automagicAutomagicInterface configuration path_join)r config_pathclazzs r availabler!sX&'11K  ***>*>*Q*QR   11;;KX  !  s8B automagicsplugincd}|jjd}t|}tjD]*} |j ||kr|j |}|},|tjvrtjd|Stjd|dg}|D]}||jvs||gz }|S#t $rYwxYw)zOChooses which automagics to run, maintaining the order they were handed in.None.zNo plugin category detectedz Detected a z category plugin) __module__splitlenr OS_CATEGORIESindex ValueErrorvolloginfoexclusion_list)r"r#plugin_categoryplugin_categories lowest_indexosoutputamagics rchoose_automagicr62sO))//4()L%%  &&r*\9066r: "$ i555 12 KK+o..>?@ F &"7"7 7 vh F  M   s'C CC configurablerprogress_callbackc|D]1}t|tjjr(t dt|tj j s/t|tj j s t dt|tj j r |j}n|}tj|j}|jD]}|j|g} |D]:} tjd|jj|||||<| S#t $r8} | j#t$j&j)| Yd} ~ {d} ~ wwxYw)avRuns through the list of `automagics` in order, allowing them to make changes to the context. Args: automagics: A list of :class:`~volatility3.framework.interfaces.automagic.AutomagicInterface` objects context: The context (that inherits from :class:`~volatility3.framework.interfaces.context.ContextInterface`) for modification configurable: An object that inherits from :class:`~volatility3.framework.interfaces.configuration.ConfigurableInterface` config_path: The path within the `context.config` for options required by the `configurable` progress_callback: A function that takes a percentage (and an optional description) that will be called periodically This is where any automagic is allowed to run, and alter the context in order to satisfy/improve all requirements Returns a list of traceback objects that occurred during the autorun procedure Note: The order of the `automagics` list is important. An `automagic` that populates configurations may be necessary for an `automagic` that populates the context based on the configuration information. z:Automagics must only contain AutomagicInterface subclassesz(Automagic operates on configurables only)namezRunning automagic: N) isinstancerrr TypeErrorrConfigurableInterface issubclass __class__r MultiRequirementrget_requirementsadd_requirementr-r. Exceptionappend tracebackTracebackExceptionfrom_exception) r"r r7rr8rconfigurable_class requirementreq exceptionsexcps rrunrMSsi8  )Z%9%9%L%LML  j..DD z'?'?'U'UVBCC , 8 8 N NO)33)//5G5P5PQK,,.)##C()JQ  Q KK-i.A.A.J.J-KL M g{K9J KQ  Q   i::II$O P P Qs 7E F.FFr) __doc__loggingrrEtypingrrrvolatility3.frameworkrrrr #volatility3.framework.configurationr getLoggerrr-r ContextInterfacerrr!pluginsPluginInterfacer6rr=strProgressCallbackrFrMrrrZsb $$WW<   8 $    0 0 *   1 122T*..AABC ##33 4 $z##66 78R59:Z))<<=:    0 0:  66 Z % % ; ;< >::!11: ) & &':r