Go to file
Sandro Bonazzola e21d2a3501 Convert GitHub Actions in GitLab Pipelines
audit test temporary disabled waiting for
https://gitlab.com/CentOS/automotive/src/cvd2img/-/issues/3
to be fixed.

Clippy test temporary disabled waiting for
https://gitlab.com/CentOS/automotive/src/cvd2img/-/issues/2
to be fixed.

Fixes: #1
Signed-off-by: Sandro Bonazzola <sbonazzo@redhat.com>
2024-08-06 09:11:03 +02:00
src cleanup: Use Path/PathBuf instead of allocating a new String 2023-09-20 13:03:37 +02:00
.gitignore initial commit 2023-05-04 19:01:23 +02:00
.gitlab-ci.yml Convert GitHub Actions in GitLab Pipelines 2024-08-06 09:11:03 +02:00
COPYING initial commit 2023-05-04 19:01:23 +02:00
Cargo.lock Update dependencies 2023-09-20 10:51:28 +02:00
Cargo.toml Downgrade clap version requirement 2023-05-18 18:10:01 +02:00
README.md readme: Document the openssl runtime dependency 2023-09-29 16:01:23 +02:00

README.md

cvd2img

A tool to transform Android Cuttlefish images into raw disk images that can be used with QEMU (and other VMMs).

Building

Dependencies

  • parted headers and libraries (libparted-dev in Debian, parted-devel in Fedora)
  • clang headers and libraries (libclang-dev in Debian, clang-devel in Fedora)
  • openssl runtime dependency used by avbtool
  • The Rust Toolchain

Generating the executable

With all dependencies in place, it should be as simple as running cargo build. The resulting binary will be in ./target/debug/cvd2img.

Using

Preparing the Cuttlefish Directory

  1. Download a cuttlefish image from http://ci.android.com/. If you don't exactly what to download, read this guide.

  2. Create a directory and unpack for the cuttlefish images and the CVD tools.

mkdir cuttlefish
cd cuttlefish
unzip ~/Downloads/aosp_cf_x86_64_phone-img*.zip
tar xf ~/Downloads/cvd-host_package.tar.gz

Generating the raw disk images

Go back to the cvd2img build directory and execute it pointing to the directory containing the cuttlefish images expanded above:

./target/debug/cvd2img ~/cuttlefish

More options

./target/debug/cvd2img --help
Usage: cvd2img [OPTIONS] <CVD_DIR>

Arguments:
  <CVD_DIR>  Directory containing the Android Cuttlefish images

Options:
  -a, --arch <ARCH>    Architecture of the source images [possible values: x86-64, aarch64]
  -s, --system <FILE>  Output file for the system disk image
  -p, --props <FILE>   Output file for the properties disk image
  -h, --help           Print help
  -V, --version        Print version