You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
77 lines
2.2 KiB
77 lines
2.2 KiB
### Table of Contents
|
|
1. [About](#about)
|
|
2. [Getting Started](#getting-started)
|
|
3. [Description](#description)
|
|
4. [Package Contents](#package-contents)
|
|
5. [Issues](#issues)
|
|
6. [Screenshot](#screenshot)
|
|
|
|
|
|
### About <a name="about"></a>
|
|
mucc is a tool for processing data recovered by scalpel.
|
|
It's features include:
|
|
1. Splitting PDF files into sub-files.
|
|
2. Deleting duplicate files, which can be used independently.
|
|
|
|
<br>
|
|
<br>
|
|
|
|
### Getting Started <a name="getting-started"></a>
|
|
* Download and extract the [JavaFX SDK](https://gluonhq.com/products/javafx/).
|
|
* Add the `<your path>/javafx-sdk-11/lib/`as a library to your project.
|
|
* Add `--module-path <your path>/javafx-sdk-11/lib --add-modules=javafx.controls,javafx.fxml` to VM options.
|
|
* Run
|
|
|
|
<br>
|
|
<br>
|
|
|
|
### Descripton <a name="description"></a>
|
|
|
|
##### Retrieving Sub-Files
|
|
|
|
scalpel parses disk images for %PDF headers
|
|
and %EOF footers.
|
|
If max_filsize is set high, the generated files will often consist of several
|
|
concatenated sub-files.
|
|
Here mucc finds the nested %PDF and %EOF tags
|
|
and returns the files with byte sized precision.
|
|
|
|
##### Deleting Duplicates
|
|
Here mucc calculates the md5 hash of each file and deletes the identical files.
|
|
|
|
<br>
|
|
<br>
|
|
|
|
### Package Contents <a name="package-contents"></a>
|
|
|
|
| Class | Description |
|
|
|---------------|-------------|
|
|
| Artifacts | Simple objects used by other classes.|
|
|
| Controller | JavaFX class containing application logic. |
|
|
| Execute | Issues shell commands.|
|
|
| layout.fxml | Contains layout data.|
|
|
| Main | Main JavaFX class. Run from here.|
|
|
| QuicksortMd5 | Quicksort algorithm.|
|
|
| routines | Contains higher level routines called by Controller.|
|
|
| Tools | Simple tools used by other classes.|
|
|
| Write | Writes to /tmp. Used for data storage.|
|
|
|
|
<br>
|
|
<br>
|
|
|
|
### Issues <a name="issues"></a>
|
|
|
|
- %PDF tags are not parsed correctly if cat output contains multiple tabs.
|
|
- Nested duplicates are not be deleted on first pass.
|
|
- Code formatting, documentation and IDE warnings.
|
|
- `scalpel` integration is missing.
|
|
- States require progress indicator instead of "__".
|
|
|
|
<br>
|
|
<br>
|
|
|
|
### Screenshot <a name="screenshot"></a>
|
|
|
|
|
|
|