# BFFextract

Simple Rust program to extract AIX BFF files.

## Install

### Cargo

To compile it from source you can just install it using cargo install.

```
cargo install bffextract
```

### Binary download

Each release is available in compiled binary from Github. Linux build is using MUSL toolchain to make it work on older libc versions (e.g. CentOS 7) too.

https://github.com/ponchofiesta/bffextract-rs/releases

## Usage

```
Extract content of BFF file (AIX Backup file format)

Usage: bffextract.exe [OPTIONS] <FILENAME> [FILE_LIST]...

Arguments:
  <FILENAME>      Path to BFF file.
  [FILE_LIST]...  Extract specific source file(s) and folders recursively only.

Options:
  -C, --chdir <CHDIR>            Extract to directory. [default: .]
  -A, --attributes <ATTRIBUTES>  Restore only specified file attributes.
                                 Possible values: p = permissions (unix only)
                                                  o = owners (unix only)
                                                  t = timestamps
                                  [default: t]
  -t, --list                     List content of BFF archive.
  -v, --verbose                  Displays details while extracting.
  -n, --numeric                  List numeric user and group IDs.
  -h, --help                     Print help
  -V, --version                  Print version
```

## Limitations

- Checksum is not verified (archive and content files).
- Symlinks are unsupported. They are not part of the BFF file format, but of the liblpp.a file which is part of a install fileset.
- Bad file format may be ignored in some cases.

## Credits

Based on:

- https://github.com/terorie/aix-bff-go
- https://github.com/ReFirmLabs/binwalk/blob/cddfede795971045d99422bd7a9676c8803ec5ee/src/binwalk/magic/archives#L226
- https://github.com/jtreml/firmware-mod-kit/blob/master/src/bff