Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 1 addition & 5 deletions .github/actions/test-package/action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -98,11 +98,7 @@ runs:
if: runner.os == 'macOS'
shell: bash -euxo pipefail {0}
run: |
brew install cmake
curl -O https://raw.githubusercontent.com/Homebrew/homebrew-core/b8292ac3475e57ca407db18dfeb131cc51116da2/Formula/lib/libmagic.rb
brew tap-new redballoonsecurity/ofrak-libmagic
cp libmagic.rb $(brew --repository)/Library/Taps/redballoonsecurity/homebrew-ofrak-libmagic/Formula/
brew install redballoonsecurity/ofrak-libmagic/libmagic
brew install cmake libmagic

- name: Install packages
shell: bash -euxo pipefail {0}
Expand Down
2 changes: 1 addition & 1 deletion docs/install/pypi.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Install OFRAK quickly using pip for the simplest setup.
## Prerequisites

- Python 3.9+ and pip
- cmake and libmagic 5.46 (macOS only - libmagic 5.47 has a known regression affecting ELF identification; see [source install docs](source.md#macos-libmagic-install) for installation steps)
- cmake and libmagic (macOS only - install via `brew install cmake libmagic`)

## Quick Install

Expand Down
14 changes: 1 addition & 13 deletions docs/install/source.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Install OFRAK from source code for development or contribution.
- Python 3.9+ and pip
- Git with [Git LFS](https://git-lfs.github.com/) installed ([installation instructions](https://github.com/git-lfs/git-lfs#installing))
- make
- cmake and libmagic 5.46 (macOS only - libmagic 5.47 has a known regression affecting ELF identification; see [macOS libmagic install](#macos-libmagic-install) below)
- cmake and libmagic (macOS only - install via `brew install cmake libmagic`)

## Clone

Expand Down Expand Up @@ -103,18 +103,6 @@ make requirements-pip
make requirements-build-docker
```

### macOS libmagic Install

libmagic 5.47 contains a regression where ELF files are identified as `ELF` instead of `ELF ` (with trailing space), which breaks OFRAK's ELF identification. Install libmagic 5.46 via a custom Homebrew tap:

```bash
brew install cmake
curl -O https://raw.githubusercontent.com/Homebrew/homebrew-core/b8292ac3475e57ca407db18dfeb131cc51116da2/Formula/lib/libmagic.rb
brew tap-new local/ofrak-libmagic
cp libmagic.rb $(brew --repository)/Library/Taps/local/homebrew-ofrak-libmagic/Formula/
brew install local/ofrak-libmagic/libmagic
```

### keystone-engine Import Error on macOS (M1/M2)

**Symptoms**: `ImportError: ERROR: fail to load the dynamic library` when importing or using OFRAK components that depend on `keystone-engine`.
Expand Down
1 change: 1 addition & 0 deletions ofrak_core/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
- Remove test dependencies that are already in the global `requirements-dev.txt` ([#695](https://github.com/redballoonsecurity/ofrak/pull/695))

### Fixed
- Remove libmagic 5.46 pin as the pinned manifest is not compatible with latest brew and libmagic 5.48 fixes the original regression ([#755](https://github.com/redballoonsecurity/ofrak/pull/755))
- Fix thread-unsafe `os.chdir` in `ZipPacker` by passing `cwd` to subprocess ([#721](https://github.com/redballoonsecurity/ofrak/pull/721))
- Pin libmagic to 5.46 on macOS CI builds to work around a regression in 5.47 that breaks ELF identification; update documentation to reflect the libmagic 5.46 requirement ([#723](https://github.com/redballoonsecurity/ofrak/pull/723))
- Bump `aiohttp` to >=3.13.3 to address CVE-2025-69223 ([#693](https://github.com/redballoonsecurity/ofrak/pull/693))
Expand Down
2 changes: 1 addition & 1 deletion ofrak_core/version.py
Original file line number Diff line number Diff line change
@@ -1 +1 @@
VERSION = "3.4.0rc14"
VERSION = "3.4.0rc15"
Loading