============
imagemounter
============
imagemounter is a command-line utility and Python package to ease the mounting and unmounting of EnCase, Affuse, vmdk
and dd disk images (and other formats supported by supported tools). It supports mounting disk images using xmount (with
optional RW cache), affuse, ewfmount and vmware-mount; detecting DOS, BSD, Sun, Mac and GPT volume systems; mounting
FAT, Ext, XFS UFS, HFS+, LUKS and NTFS volumes, in addition to some less known filesystems; detecting (nested) LVM
volume systems and mounting its subvolumes; and reconstructing Linux Software RAID arrays.
In its default mode, imagemounter will try to start mounting the base image on a temporary mount point,
detect the volume system and then mount each volume seperately. If it fails finding a volume system,
it will try to mount the entire image as a whole if it succeeds in detecting what it actually is.
This package supports Python 3.6+.
Example
=======
A very basic example of a valid mount is as follows. The command-line utility has much more features, but results vary
wildly depending on the exact type of disk you are trying to mount::
# imount lvm_containing_dos_volumesystem_containing_ext4
[+] Mounting image lvm_containing_dos_volumesystem_containing_ext4 using auto...
[+] Mounted raw image [1/1]
[+] Mounted volume 2.0 GiB 4.0.2:Ext4 / [Linux] on /tmp/im_4.0.2_8l86mZ.
>>> Press [enter] to unmount the volume, or ^C to keep mounted...
[+] Parsed all volumes!
[+] Analysis complete, unmounting...
[+] All cleaned up
If you want to see for yourself, you could try executing ``imount /dev/sda`` first.
Documentation
=============
Full documentation of this project is available from http://imagemounter.readthedocs.org/ or in the ``docs/`` directory.
Installation
============
This package does not require other packages, though ``termcolor`` is recommended and ``pytsk3`` is needed if you wish to
use this package for volume detection.
Just perform the following commands for a basic installation::
apt-get install xmount ewf-tools afflib-tools sleuthkit
pip3 install imagemounter-mitre
imount --check
Use ``imount --check`` to verify which packages are (not) installed. Install additional packages as needed.
Contributing
============
Since imagemounter is an open source project, contributions of many forms are welcomed. Examples of possible
contributions include:
* Bug patches
* New features
* Documentation improvements
* Bug reports and reviews of pull requests
RELEASE STATEMENT
-----------------
Approved for Public Release; Distribution Unlimited. Public Release Case Number 22-3208.
Raw data
{
"_id": null,
"home_page": "https://github.com/mitre/imagemounter",
"name": "imagemounter-mitre",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "encase, aff, dd, disk image, ewfmount, affuse, xmount, imount",
"author": "The MITRE Corporation",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/00/1a/a21d8b3184a61c816aa9df2c6e49cd33641c5af2e55e821aab3fe94dcb72/imagemounter-mitre-2024.7.31.tar.gz",
"platform": null,
"description": "============\nimagemounter\n============\n\nimagemounter is a command-line utility and Python package to ease the mounting and unmounting of EnCase, Affuse, vmdk\nand dd disk images (and other formats supported by supported tools). It supports mounting disk images using xmount (with\noptional RW cache), affuse, ewfmount and vmware-mount; detecting DOS, BSD, Sun, Mac and GPT volume systems; mounting\nFAT, Ext, XFS UFS, HFS+, LUKS and NTFS volumes, in addition to some less known filesystems; detecting (nested) LVM\nvolume systems and mounting its subvolumes; and reconstructing Linux Software RAID arrays.\n\nIn its default mode, imagemounter will try to start mounting the base image on a temporary mount point,\ndetect the volume system and then mount each volume seperately. If it fails finding a volume system,\nit will try to mount the entire image as a whole if it succeeds in detecting what it actually is.\n\nThis package supports Python 3.6+.\n\nExample\n=======\nA very basic example of a valid mount is as follows. The command-line utility has much more features, but results vary\nwildly depending on the exact type of disk you are trying to mount::\n\n # imount lvm_containing_dos_volumesystem_containing_ext4\n [+] Mounting image lvm_containing_dos_volumesystem_containing_ext4 using auto...\n [+] Mounted raw image [1/1]\n [+] Mounted volume 2.0 GiB 4.0.2:Ext4 / [Linux] on /tmp/im_4.0.2_8l86mZ.\n >>> Press [enter] to unmount the volume, or ^C to keep mounted...\n [+] Parsed all volumes!\n [+] Analysis complete, unmounting...\n [+] All cleaned up\n\nIf you want to see for yourself, you could try executing ``imount /dev/sda`` first.\n\nDocumentation\n=============\nFull documentation of this project is available from http://imagemounter.readthedocs.org/ or in the ``docs/`` directory.\n\nInstallation\n============\nThis package does not require other packages, though ``termcolor`` is recommended and ``pytsk3`` is needed if you wish to\nuse this package for volume detection.\n\nJust perform the following commands for a basic installation::\n\n apt-get install xmount ewf-tools afflib-tools sleuthkit\n pip3 install imagemounter-mitre\n imount --check\n\nUse ``imount --check`` to verify which packages are (not) installed. Install additional packages as needed.\n\nContributing\n============\nSince imagemounter is an open source project, contributions of many forms are welcomed. Examples of possible\ncontributions include:\n\n* Bug patches\n* New features\n* Documentation improvements\n* Bug reports and reviews of pull requests\n\n\nRELEASE STATEMENT\n-----------------\nApproved for Public Release; Distribution Unlimited. Public Release Case Number 22-3208.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Command line utility and Python package to ease the (un)mounting of forensic disk images.",
"version": "2024.7.31",
"project_urls": {
"Homepage": "https://github.com/mitre/imagemounter"
},
"split_keywords": [
"encase",
" aff",
" dd",
" disk image",
" ewfmount",
" affuse",
" xmount",
" imount"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "21c71cb49f325a1eadf9b1ab4bd366f656eb35819b67898f12102390a10638e8",
"md5": "5df102daa7c3f8087e5e1e1590cd7e9a",
"sha256": "2bf6fe747aa544def050fea4002699011c307357e7ef524c57338e1fa2227fae"
},
"downloads": -1,
"filename": "imagemounter_mitre-2024.7.31-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5df102daa7c3f8087e5e1e1590cd7e9a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 54495,
"upload_time": "2024-07-31T16:05:56",
"upload_time_iso_8601": "2024-07-31T16:05:56.546442Z",
"url": "https://files.pythonhosted.org/packages/21/c7/1cb49f325a1eadf9b1ab4bd366f656eb35819b67898f12102390a10638e8/imagemounter_mitre-2024.7.31-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "001aa21d8b3184a61c816aa9df2c6e49cd33641c5af2e55e821aab3fe94dcb72",
"md5": "e4798de162539e1efba753c0ce1bf9a8",
"sha256": "127f84e3d0322b70655404f53247c49e286ac42b8aea7fb2cc08f5218763e6d8"
},
"downloads": -1,
"filename": "imagemounter-mitre-2024.7.31.tar.gz",
"has_sig": false,
"md5_digest": "e4798de162539e1efba753c0ce1bf9a8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 72282,
"upload_time": "2024-07-31T16:05:58",
"upload_time_iso_8601": "2024-07-31T16:05:58.251861Z",
"url": "https://files.pythonhosted.org/packages/00/1a/a21d8b3184a61c816aa9df2c6e49cd33641c5af2e55e821aab3fe94dcb72/imagemounter-mitre-2024.7.31.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-31 16:05:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mitre",
"github_project": "imagemounter",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "imagemounter-mitre"
}
JSON
