#android #file-format #openaes #twrp

bin+lib roaes

Rust implementation of openaes file format

2 releases

0.1.2 Nov 12, 2021
0.1.1 Nov 12, 2021

#214 in #android


Used in twtar

BSD-3-Clause

38KB
860 lines

roaes

Disclaimer: Neither this project, nor the author, are in any way associated with Team Win or Team Win Recovery Project (TWRP). No infringement on or claim over the aforementioned terms is made or intended.

Library

Library implementing the openaes standard used by the Team Win Recovery Project (TWRP), as of 2018-08-24.

There are both implementations for reading (decrypting) and writing (encrypting) data. The intention is to make encrypted TWRP backups accessible or even facilitate re-compression with a different/more modern algorithm.

Beware

All cryptographic code is re-used from libraries of the wider ecosystem. No assessment as to their quality or suitability has been made beyond testing basic compliance with sample files!

Binary

The executable roaes will decrypt and encrypt the openaes format. It uses very simple command line parsing. Running the command without any parameter will print its usage information.

USAGE: roaes enc|dev <key>

decrypts files encrypted in CBC mode with the TWRP-flavoured oaes binary
reads stdin and writes to stdout, expects encryption key as single argument

Data is read from standard input and written to standard output. No file handles are opened at all. To process data, use appropriate shell mechanisms like roaes enc somekey < plaintext.file > ciphertext.file.

Setting the environment variable RUST_LOG to one of trace, debug, info, warn or error might reveal information about internal state (though neither plaintext, ciphertext nor key material).

Dependencies

~5–14MB
~168K SLoC