# vm-inspector

A sample tool for inspecting a disk image file, e.g. vmdk, vdi, qcow, etc., to determine which operating system and applications it contains.

## Usage

To inspect a disk image file:

```sh
python3 inspect.py foo.vmdk
```

or

```sh
./inspect.py foo.vmdk
```

## CLI options

```sh
./inspect.py --help
```

```
usage: inspect.py [-h] [-b {libvmdk,nbdfuse}] [-v] image

Tool for inspecting a disk image file to determine which operating
system and applications it contains.

positional arguments:
  image                 disk image file to inspect

optional arguments:
  -h, --help            show this help message and exit
  -b {libvmdk,nbdfuse}, --backend {libvmdk,nbdfuse}
                        used backend for mounting disk image files in
                        the local filesystem (default: nbdfuse)
  -v, --verbose         print debug messages
```

## Requirements

- Python >= 3.8

- Debian 11 Bullseye (recommended) or Ubuntu 20.04

General Packages
```sh
sudo apt install git python3 python3-pip python-is-python3
```

- [lklfuse](https://github.com/lkl/linux)

```sh
$ sudo apt install build-essential flex bison bc libfuse-dev libarchive-dev xfsprogs
$ git clone https://github.com/lkl/linux.git --depth=1
$ cd linux
$ echo "CONFIG_NTFS_FS=y" >> arch/lkl/configs/defconfig
$ make -j -C tools/lkl
$ sudo cp tools/lkl/lklfuse /usr/local/bin
```

- [nbdfuse](https://libguestfs.org/nbdfuse.1.html) + [qemu-nbd](https://www.qemu.org/docs/master/tools/qemu-nbd.html) (qcow2, vdi, vmdk, etc.) or [libvmdk](https://github.com/libyal/libvmdk) >= 20210807 (vmdk only)

```sh
$ sudo apt install qemu-utils nbdfuse
```

```sh
$ sudo apt install build-essential libfuse-dev
$ wget https://github.com/libyal/libvmdk/releases/download20210807/libvmdk-alpha-20210807.tar.gz
$ tar xfv libvmdk-alpha-20210807.tar.gz
$ cd libvmdk-20210807/
$ ./configure
$ make -j
$ sudo make install
$ sudo ldconfig
```

- [libvslvm](https://github.com/libyal/libvslvm) >= 20210807 (Library and tools to access the Linux Logical Volume Manager (LVM) volume system format )

```sh
$ sudo apt install build-essential libfuse-dev
$ wget https://github.com/libyal/libvslvm/releases/download20210807/libvslvm-experimental-20210807.tar.gz
$ tar xfv libvslvm-experimental-20210807.tar.gz
$ cd libvslvm-20210807/
$ ./configure
$ make -j
$ sudo make install
$ sudo ldconfig
```

- [pyparted](https://github.com/dcantrell/pyparted) (Python bindings for GNU parted )

```sh
$ sudo apt install python3-dev libparted-dev pkg-config
$ pip3 install pyparted

For Ubuntu 20.04 an older version is needed
$ pip3 install pyparted==3.11.7
```

- [python-registry](https://github.com/williballenthin/python-registry) (Pure Python parser for Windows Registry hives)

```sh
$ pip3 install python-registry
```

- [python3-rpm](https://github.com/rpm-software-management/rpm) >= 4.16.1.3

```sh
$ sudo apt install build-essential python3-dev zlib1g-devlibgcrypt20-dev libmagic-dev libpopt-dev libsqlite3-devlibarchive-dev
$ wget https://ftp.osuosl.org/pub/rpm/releases/rpm-4.16.xrpm-4.16.1.3.tar.bz2
$ tar xfv rpm-4.16.1.3.tar.bz2
$ cd rpm-4.16.1.3/
$ ./autogen.sh --enable-python --enable-bdb=no--enable-bdb-ro --enable-sqlite=yes --enable-ndb--without-lua --disable-plugins
$ make -j
$ sudo make install
$ sudo ldconfig
$ cd python && sudo python3 setup.py install
```