summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--tools/libvmdk.py54
-rw-r--r--tools/libvslvm.py56
2 files changed, 110 insertions, 0 deletions
diff --git a/tools/libvmdk.py b/tools/libvmdk.py
new file mode 100644
index 0000000..ca67161
--- /dev/null
+++ b/tools/libvmdk.py
@@ -0,0 +1,54 @@
+import logging
+import os
+import tempfile
+
+from subprocess import run
+from . import log, rmdir
+
+__all__ = ["mount"]
+
+L = logging.getLogger(__name__)
+
+
+@log
+def mount(path):
+ """Mount a VMware Virtual Machine Disk (VMDK) file as a RAW image in the
+ local filesystem with read-only support using `libvmdk`.
+
+ See also:
+ https://github.com/libyal/libvmdk/wiki/Building
+ https://github.com/libyal/libvmdk/wiki/Mounting
+
+ Make sure you have downloaded the latest source distribution package from
+ https://github.com/libyal/libvmdk/releases, e.g.
+ libvmdk-alpha-20210807.tar.gz and built it as follows:
+ $ sudo apt install build-essential libfuse-dev
+ $ tar xfv libvmdk-alpha-20210807.tar.gz
+ $ cd libvmdk-20210807/
+ $ ./configure
+ $ make
+ $ sudo make install
+ $ sudo ldconfig
+
+ Args:
+ path (str): Path to the VMDK file.
+
+ Returns:
+ Path to the directory containing a single virtual file named `vmdk1`.
+ """
+ mp = tempfile.mkdtemp()
+ cmd = ["vmdkmount", path, mp]
+ try:
+ p = run(cmd, capture_output=True, check=False, text=True)
+ except Exception as e:
+ L.error("failed to execute command %s: %r", cmd, e)
+ rmdir(mp)
+ return ""
+
+ out, err = p.stdout.strip(), p.stderr.strip()
+ if p.returncode or not os.path.ismount(mp):
+ L.error("retcode: %d, stdout: %s, stderr: %s", p.returncode, out, err)
+ rmdir(mp)
+ return ""
+
+ return mp
diff --git a/tools/libvslvm.py b/tools/libvslvm.py
new file mode 100644
index 0000000..ec1fdbb
--- /dev/null
+++ b/tools/libvslvm.py
@@ -0,0 +1,56 @@
+import logging
+import os
+import tempfile
+
+from subprocess import run
+from . import log, rmdir
+
+__all__ = ["mount"]
+
+L = logging.getLogger(__name__)
+
+
+@log
+def mount(path, offset):
+ """Mount a Linux Logical Volume Manager (LVM) volume system using
+ `libvslvm`.
+
+ See also:
+ https://github.com/libyal/libvslvm/wiki/Mounting
+ https://github.com/libyal/libvslvm/wiki/Building
+
+ Make sure you have downloaded the latest source distribution package from
+ https://github.com/libyal/libvslvm/releases, e.g.
+ libvslvm-experimental-20210807.tar.gz and built it as follows:
+ $ sudo apt install build-essential libfuse-dev
+ $ tar xfv libvslvm-experimental-20210807.tar.gz
+ $ cd libvslvm-20210807/
+ $ ./configure
+ $ make
+ $ sudo make install
+ $ sudo ldconfig
+
+ Args:
+ path (str): Path to the RAW image file containing LVM volume system.
+ offset (str|int): Value in bytes where the LVM volume system starts.
+
+ Returns:
+ Path to the directory containing volumes as a virtual file named
+ `lvm1`, `lvm2`, etc.
+ """
+ mp = tempfile.mkdtemp()
+ cmd = ["vslvmmount", "-o", str(offset), path, mp]
+ try:
+ p = run(cmd, capture_output=True, check=False, text=True)
+ except Exception as e:
+ L.error("failed to execute command %s: %r", cmd, e)
+ rmdir(mp)
+ return ""
+
+ out, err = p.stdout.strip(), p.stderr.strip()
+ if p.returncode or not os.path.ismount(mp):
+ L.error("retcode: %d, stdout: %s, stderr: %s", p.returncode, out, err)
+ rmdir(mp)
+ return ""
+
+ return mp