Merge branch 'volatilityfoundation:develop' into issue_985

.github/workflows/stale.yml

@@ -0,0 +1,23 @@
+name: Close inactive issues
+on:
+  schedule:
+    - cron: "30 1 * * *"
+
+jobs:
+  close-issues:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+      - uses: actions/stale@v5
+        with:
+          days-before-issue-stale: 200
+          days-before-issue-close: 60
+          stale-issue-label: "stale"
+          stale-issue-message: "This issue is stale because it has been open for 200 days with no activity."
+          close-issue-message: "This issue was closed because it has been inactive for 60 days since being marked as stale."
+          days-before-pr-stale: -1
+          days-before-pr-close: -1
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          exempt-issue-labels: "enhancement,plugin-request,question"

doc/source/using-as-a-library.rst

@@ -67,9 +67,10 @@ return a dictionary of plugin names and the plugin classes.
 Determine what configuration options a plugin requires
 ------------------------------------------------------
 
-For each plugin class, we can call the classmethod `requirements` on it, which will return a list of objects that
-adhere to the :py:class:`~volatility3.framework.interfaces.configuration.RequirementInterface` method.  The various
-types of Requirement are split roughly in two,
+For each plugin class, we can call the classmethod 
+:py:func:`~volatility3.framework.interfaces.configuration.ConfigurableInterface.get_requirements` on it, which will 
+return a list of objects that adhere to the :py:class:`~volatility3.framework.interfaces.configuration.RequirementInterface` 
+method.  The various types of Requirement are split roughly in two,
 :py:class:`~volatility3.framework.interfaces.configuration.SimpleTypeRequirement` (such as integers, booleans, floats
 and strings) and more complex requirements (such as lists, choices, multiple requirements, translation layer
 requirements or symbol table requirements).  A requirement just specifies a type of data and a name, and must be

volatility3/framework/layers/avml.py

@@ -19,11 +19,18 @@ vollog = logging.getLogger(__name__)
 try:
     # TODO: Find library for windows if needed
     try:
-        # Linux/Mac
+        # Linux
         lib_snappy = ctypes.cdll.LoadLibrary("libsnappy.so.1")
     except OSError:
         lib_snappy = None
 
+    try:
+        if not lib_snappy:
+            # macOS
+            lib_snappy = ctypes.cdll.LoadLibrary("libsnappy.1.dylib")
+    except OSError:
+        lib_snappy = None
+
     try:
         if not lib_snappy:
             # Windows 64
@@ -31,7 +38,7 @@ try:
     except OSError:
         lib_snappy = None
 
-    if lib_snappy:
+    if not lib_snappy:
         # Windows 32
         lib_snappy = ctypes.cdll.LoadLibrary("snappy32")