| Name | retdec-config-patch JSON |
| Version |
0.2.2
JSON |
| download |
| home_page | None |
| Summary | Patch for the broken `--config` option in `retdec-decompiler` |
| upload_time | 2024-07-30 00:44:50 |
| maintainer | None |
| docs_url | None |
| author | PhotonicGluon |
| requires_python | <4.0,>=3.8 |
| license | MIT |
| keywords |
patch
retdec
decompiler
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# RetDec-Config-Patch
[](https://pypi.org/project/retdec-config-patch/)
[](https://github.com/PhotonicGluon/RetDec-Config-Patch/actions/workflows/run-tests.yml)
[](https://github.com/PhotonicGluon/RetDec-Config-Patch/actions/workflows/publish-package.yml)
Patch for the broken `--config` option in [RetDec](https://github.com/avast/retdec).
The [rationale](#appendix-rationale) for why this package exists is given below.
## Installation
You can choose to install the patch from package or building from scratch. In either case, you will still need to [activate the patch](#activating-the-patch).
### Installing from Package
The [`retdec-config-patch`](https://pypi.org/project/retdec-config-patch/) is available on PyPi. It is important to note that the package is to be installed **system-wide** so that the patch binary can be accessed across the whole system.
```bash
pip install retdec-config-patch
```
Troubleshooting:
- If `pip` does not work, try `pip3`.
### Building the Package
One could also build the package from scratch. This is particularly useful for development and contributions.
1. Clone the repository.
2. If you are using VSCode, set up the devcontainer.
- If that doesn't work, follow the next few steps.
- Otherwise, go to step 6.
3. Create a new virtual environment by running `python3 -m venv venv`.
4. Activate the virtual environment.
5. Install [Poetry](https://python-poetry.org/) in the virtual environment using `pip install poetry`.
- Check that Poetry was successfully installed by running `poetry --version`.
6. Install the dependencies by running `poetry install`.
## Activating/Deactivating the Patch
Installing the package does not mean that the patch is active; you need to manually activate it.
### Activating the Patch
To activate the patch, run
```bash
retdec-config-patch
```
This will perform the necessary checks before implementing the patch.
Once the patch is activated, you can use `retdec-decompiler` as per normal. The only difference is that the `--config` option works properly now.
If the patch is activated, a `Using patched RetDec decompiler.` message should appear before every run of `retdec-decompiler`. See the help message provided by RetDec by running
```bash
retdec-decompiler --help
```
### Deactivating the Patch
If you want to deactivate the patch, run
```bash
undo-retdec-config-patch
```
Check that the patch was deactivated by running
```bash
retdec-decompiler
```
The `Using patched RetDec decompiler.` message should **no longer appear**.
### License
The `retdec-config-patch` is licensed under the MIT license.
```plain
MIT License
Copyright (c) 2024 Ryan Kan
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```
## Appendix: Rationale
_Why on earth does this package exist?_
RetDec is a "retargetable machine-code decompiler based on LLVM". It is a very useful open-source project to help decompile binaries compiled using different architectures and on different platforms.
The trouble began when one notices that `retdec-decompiler`, the main program, offers a flag `--config` with the following help description.
```plain
[--config] Specify JSON decompilation configuration file.
```
One would assume then that we could pass in a custom configuration file in order to adjust the decompilation process. For example, one can find an [example configuration file](https://github.com/avast/retdec/blob/b283e7e3fa111764d795a75418548fcf86d6e47d/src/retdec-decompiler/decompiler-config.json) in the RetDec repository. So one tries to create a custom configuration file, say `my_config.json`, which could contain
```json
{
"decompParams": {
"verboseOut": false
}
}
```
to disable verbose outputs, and then use this file in the `retdec-decompiler` by specifying the `--config` flag, i.e.
```bash
retdec-decompiler SOME_FILE --config my_config.json
```
However, _**this does not work at all**_. It appears as though _**RetDec ignores this configuration file**_ and proceeds with running through all the steps of the decompilation.
So why does this happen?
It turns out that in [`retdec_decompiler.cpp`](https://github.com/avast/retdec/blob/b283e7e3fa111764d795a75418548fcf86d6e47d/src/retdec-decompiler/retdec-decompiler.cpp#L995-L1000), lines 995 to 1000, there is the following code,
```cpp
retdec::config::Config config;
auto binpath = retdec::utils::getThisBinaryDirectoryPath();
fs::path configPath(fs::canonical(binpath).parent_path());
configPath.append("share");
configPath.append("retdec");
configPath.append("decompiler-config.json");
```
which explains why the configuration file that we specify is ignored — the code itself is hardcoded to use the default configuration file [`decompiler-config.json`](https://github.com/avast/retdec/blob/b283e7e3fa111764d795a75418548fcf86d6e47d/src/retdec-decompiler/decompiler-config.json)!
So, if we want to use our own configuration file, we need to perform the following steps.
1. Locate the `/share/retdec` folder within the RetDec installation.
2. Save the existing `decompiler-config.json` somewhere.
3. Replace the `decompiler-config.json` there with the custom configuration file.
4. Run `retdec-decompiler` _without_ specifying the `--config` flag (since this does nothing).
5. Delete the `decompiler-config.json` file in the `/share/retdec` folder (which is actually the custom configuration file).
6. Copy over the original `decompiler-config.json` (which was saved in step 2) back into the `/share/retdec` folder.
These steps are what are performed by the patched `retdec-decompiler` executable provided by this package.
Raw data
{
"_id": null,
"home_page": null,
"name": "retdec-config-patch",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "patch, retdec, decompiler",
"author": "PhotonicGluon",
"author_email": "25820201+PhotonicGluon@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/d4/47/f2f13e48ea573063c719a9575ba56d25ff1cee98434df0120b6a1bb09766/retdec_config_patch-0.2.2.tar.gz",
"platform": null,
"description": "# RetDec-Config-Patch\n\n\n[](https://pypi.org/project/retdec-config-patch/)\n\n\n\n[](https://github.com/PhotonicGluon/RetDec-Config-Patch/actions/workflows/run-tests.yml)\n[](https://github.com/PhotonicGluon/RetDec-Config-Patch/actions/workflows/publish-package.yml)\n\nPatch for the broken `--config` option in [RetDec](https://github.com/avast/retdec).\n\nThe [rationale](#appendix-rationale) for why this package exists is given below.\n\n## Installation\n\nYou can choose to install the patch from package or building from scratch. In either case, you will still need to [activate the patch](#activating-the-patch).\n\n### Installing from Package\n\nThe [`retdec-config-patch`](https://pypi.org/project/retdec-config-patch/) is available on PyPi. It is important to note that the package is to be installed **system-wide** so that the patch binary can be accessed across the whole system.\n\n```bash\npip install retdec-config-patch\n```\n\nTroubleshooting:\n\n- If `pip` does not work, try `pip3`.\n\n### Building the Package\n\nOne could also build the package from scratch. This is particularly useful for development and contributions.\n\n1. Clone the repository.\n2. If you are using VSCode, set up the devcontainer.\n - If that doesn't work, follow the next few steps.\n - Otherwise, go to step 6.\n3. Create a new virtual environment by running `python3 -m venv venv`.\n4. Activate the virtual environment.\n5. Install [Poetry](https://python-poetry.org/) in the virtual environment using `pip install poetry`.\n - Check that Poetry was successfully installed by running `poetry --version`.\n6. Install the dependencies by running `poetry install`.\n\n## Activating/Deactivating the Patch\n\nInstalling the package does not mean that the patch is active; you need to manually activate it.\n\n### Activating the Patch\n\nTo activate the patch, run\n\n```bash\nretdec-config-patch\n```\n\nThis will perform the necessary checks before implementing the patch.\n\nOnce the patch is activated, you can use `retdec-decompiler` as per normal. The only difference is that the `--config` option works properly now.\n\nIf the patch is activated, a `Using patched RetDec decompiler.` message should appear before every run of `retdec-decompiler`. See the help message provided by RetDec by running\n\n```bash\nretdec-decompiler --help\n```\n\n### Deactivating the Patch\n\nIf you want to deactivate the patch, run\n\n```bash\nundo-retdec-config-patch\n```\n\nCheck that the patch was deactivated by running\n\n```bash\nretdec-decompiler\n```\n\nThe `Using patched RetDec decompiler.` message should **no longer appear**.\n\n### License\n\nThe `retdec-config-patch` is licensed under the MIT license.\n\n```plain\nMIT License\n\nCopyright (c) 2024 Ryan Kan\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n## Appendix: Rationale\n\n_Why on earth does this package exist?_\n\nRetDec is a \"retargetable machine-code decompiler based on LLVM\". It is a very useful open-source project to help decompile binaries compiled using different architectures and on different platforms.\n\nThe trouble began when one notices that `retdec-decompiler`, the main program, offers a flag `--config` with the following help description.\n\n```plain\n [--config] Specify JSON decompilation configuration file.\n```\n\nOne would assume then that we could pass in a custom configuration file in order to adjust the decompilation process. For example, one can find an [example configuration file](https://github.com/avast/retdec/blob/b283e7e3fa111764d795a75418548fcf86d6e47d/src/retdec-decompiler/decompiler-config.json) in the RetDec repository. So one tries to create a custom configuration file, say `my_config.json`, which could contain\n\n```json\n{\n \"decompParams\": {\n \"verboseOut\": false\n }\n}\n```\n\nto disable verbose outputs, and then use this file in the `retdec-decompiler` by specifying the `--config` flag, i.e.\n\n```bash\nretdec-decompiler SOME_FILE --config my_config.json\n```\n\nHowever, _**this does not work at all**_. It appears as though _**RetDec ignores this configuration file**_ and proceeds with running through all the steps of the decompilation.\n\nSo why does this happen?\n\nIt turns out that in [`retdec_decompiler.cpp`](https://github.com/avast/retdec/blob/b283e7e3fa111764d795a75418548fcf86d6e47d/src/retdec-decompiler/retdec-decompiler.cpp#L995-L1000), lines 995 to 1000, there is the following code,\n\n```cpp\n retdec::config::Config config;\n auto binpath = retdec::utils::getThisBinaryDirectoryPath();\n fs::path configPath(fs::canonical(binpath).parent_path());\n configPath.append(\"share\");\n configPath.append(\"retdec\");\n configPath.append(\"decompiler-config.json\");\n```\n\nwhich explains why the configuration file that we specify is ignored — the code itself is hardcoded to use the default configuration file [`decompiler-config.json`](https://github.com/avast/retdec/blob/b283e7e3fa111764d795a75418548fcf86d6e47d/src/retdec-decompiler/decompiler-config.json)!\n\nSo, if we want to use our own configuration file, we need to perform the following steps.\n\n1. Locate the `/share/retdec` folder within the RetDec installation.\n2. Save the existing `decompiler-config.json` somewhere.\n3. Replace the `decompiler-config.json` there with the custom configuration file.\n4. Run `retdec-decompiler` _without_ specifying the `--config` flag (since this does nothing).\n5. Delete the `decompiler-config.json` file in the `/share/retdec` folder (which is actually the custom configuration file).\n6. Copy over the original `decompiler-config.json` (which was saved in step 2) back into the `/share/retdec` folder.\n\nThese steps are what are performed by the patched `retdec-decompiler` executable provided by this package.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Patch for the broken `--config` option in `retdec-decompiler`",
"version": "0.2.2",
"project_urls": {
"Issues": "https://github.com/PhotonicGluon/RetDec-Config-Patch/issues",
"Repository": "https://github.com/PhotonicGluon/RetDec-Config-Patch"
},
"split_keywords": [
"patch",
" retdec",
" decompiler"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1c6edf7785d429e3f80f88e4b03337b299dd7ebd3a9ae80aea83e8c62f85fc3f",
"md5": "658d415ae057bb0d2d90ffe80ae86ad7",
"sha256": "f64ab337520460d3dcc74f9fcae6e40c05fe9f86a6f1d18eab8cb15fffdc04e6"
},
"downloads": -1,
"filename": "retdec_config_patch-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "658d415ae057bb0d2d90ffe80ae86ad7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 13050,
"upload_time": "2024-07-30T00:44:48",
"upload_time_iso_8601": "2024-07-30T00:44:48.970335Z",
"url": "https://files.pythonhosted.org/packages/1c/6e/df7785d429e3f80f88e4b03337b299dd7ebd3a9ae80aea83e8c62f85fc3f/retdec_config_patch-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d447f2f13e48ea573063c719a9575ba56d25ff1cee98434df0120b6a1bb09766",
"md5": "da7c2eec2bd80d948104ae79381de55f",
"sha256": "747780310ef01e45b8374211279fed9cc6a0c2666e575951bf9d1834bb668004"
},
"downloads": -1,
"filename": "retdec_config_patch-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "da7c2eec2bd80d948104ae79381de55f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 12344,
"upload_time": "2024-07-30T00:44:50",
"upload_time_iso_8601": "2024-07-30T00:44:50.275497Z",
"url": "https://files.pythonhosted.org/packages/d4/47/f2f13e48ea573063c719a9575ba56d25ff1cee98434df0120b6a1bb09766/retdec_config_patch-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-30 00:44:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PhotonicGluon",
"github_project": "RetDec-Config-Patch",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "retdec-config-patch"
}
