prettytable/README.md

53 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2023-04-15 19:47:45 +02:00
# FAT32 Filesystem Parser
This python script is a FAT32 filesystem parser that allows you to analyze and parse FAT32 filesystems.
## Options
```
-h, --help - Print out the help menu
-i, --image IMAGE - Enter the path to the file system raw image
-m, --mbr - Parse Master Boot Record (MBR) only
-p, --partition - Select the partition number (from 1 to 4) for which you would like to retrieve the boot sector information.
-v, --verbose - Print out a quick documentation of every parsed field
```
## Usage
#### Parsing Master Boot Record only:
```bash
$ python3 --image /path/to/image --mbr
```
2023-04-15 20:21:26 +02:00
![1](https://user-images.githubusercontent.com/101610095/232246774-44cbe18f-ceaa-4c57-a505-ddddcd545fd8.gif)
2023-04-15 19:47:45 +02:00
* Using verbose Mode:
```bash
$ python3 --image /path/to/image --mbr --verbose
```
2023-04-15 20:26:23 +02:00
![2](https://user-images.githubusercontent.com/101610095/232246865-af0ef9df-58c1-4ab2-b048-c351e0057ffa.gif)
2023-04-15 19:47:45 +02:00
#### Parsing the entire disk image:
```bash
$ python3 --image /path/to/image
```
2023-04-15 20:29:47 +02:00
![3](https://user-images.githubusercontent.com/101610095/232247263-66e09adc-5b7a-4150-861f-98617219fa2f.gif)
2023-04-15 19:47:45 +02:00
* Using verbose mode:
```bash
$ python3 --image /path/to/image --verbose
```
2023-04-16 00:28:22 +02:00
![4](https://user-images.githubusercontent.com/101610095/232255736-f78f21ed-f901-49f6-b3e3-1c914d0e364c.gif)
2023-04-15 19:47:45 +02:00
#### Parsing the boot sector of a specific partition
```bash
$ python3 --image /path/to/image -p [1-4]
```
## Requirements
```bash
$ pip3 install -r requirements.txt
```
2023-04-15 19:52:58 +02:00
## Contributing
Contributions are welcome! If you'd like to contribute to this project, please fork the repository and submit a pull request with your changes.
## License
This project is licensed under the MIT License - see the [License](https://github.com/YounesTasra-R4z3rSw0rd/FAT32-Parser/blob/main/LICENSE) file for details.