Beyond Linux® From Scratch (System V Edition) - Version r12.2-875

Chapter 13. Programming

cargo-c-0.10.7

Introduction to cargo-c

The cargo-c package creates a cargo subcommand to build and install C-ABI compatible dynamic and static libraries.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

cargo-c Dependencies

Required

rustc-1.83.0

Recommended

libssh2-1.11.1 and SQLite-3.47.2

[Note]

Note

An Internet connection is needed for building this package.

Installation of cargo-c

First, download a file to ensure that cargo uses the dependency versions specified by the upstream developers when this cargo-c version (0.10.7) was released. Without this, the latest versions of the dependencies would be used and they might cause breakages: 

curl -LO https://github.com/lu-zero/cargo-c/releases/download/v0.10.7/Cargo.lock
[Note]

Note

Normally we would put such a download into an “Additional Downloads” section. But in this case we cannot tell the package name and version from the file name Cargo.lock, so it's better not to put the ambiguously-named file outside the cargo-c-0.10.7 directory. We use curl here because the cURL-8.11.0 package should have been installed as a required dependency of rustc-1.83.0.

The md5sum of the file should be cde6450efe78fb7713347b540a2e20a4.

Install cargo-c by running the following commands: 

[ ! -e /usr/include/libssh2.h ] || export LIBSSH2_SYS_USE_PKG_CONFIG=1    &&
[ ! -e /usr/include/sqlite3.h ] || export LIBSQLITE3_SYS_USE_PKG_CONFIG=1 &&

cargo build --release

To test the results, issue: cargo test --release.

Now, as the root user: 

install -vm755 target/release/cargo-{capi,cbuild,cinstall,ctest} /usr/bin/

Contents

Installed Programs: cargo-capi, cargo-cbuild, cargo-cinstall, and cargo-ctest
Installed Libraries: None
Installed Directories: None