capi

Overview ¶

Package main builds the embedded ClassAd log as a C archive: it exports C symbols (cadb_*) mirroring HTCondor's classad_log.h, so a C++ interface (built on libcondor_utils) can sit on top. Build:

go build -buildmode=c-archive -o libclassad_db.a ./capi

which also emits capi.h with these signatures.

Handles: a DB and a transaction are passed to C as opaque cgo.Handle values (uintptr_t). C never dereferences them; it only passes them back. Returned strings are C-allocated and must be released with cadb_free.

This is the minimal, correct surface; the wire-bytes zero-alloc PutClassAd path (cadb_new_classad_wire) is a planned addition once the collections store exposes a raw-wire ingest (see DESIGN.md).