uplink-c  v1.8.0
uplink-c

C library for Storj V3 Network.

Storj is building a decentralized cloud storage network. Check out our white paper for more info!


Storj is an S3-compatible platform and suite of decentralized applications that allows you to store data in a secure and decentralized manner. Your files are encrypted, broken into little pieces and stored in a global decentralized network of computers. Luckily, we also support allowing you (and only you) to retrieve those files!

Build

Download and install the latest release of Go (at least Go 1.13) at golang.org.

When ready, building the shared library is as easy as executing:

make build

The output is in the .build folder.

If you specifically need GPLv2 compatibility, you can use GPL2=true make build instead, which will compile the library without any Apache v2 dependencies (sadly, Apache v2 is incompatible with the GPLv2). Currently this results in slower hashing performance (no github.com/minio/sha256-simd) and reduced debugging and analysis infrastructure.

API Documentation

Documentation of the stable C API is at storj.github.io/uplink-c

API resource management

Functions that return a struct have allocated memory and possibly handles for that struct. There is a function associated with the struct that the caller must use to free those resources. Such a function can be recognized by the "_free_" in its name.

The rest of parameters of the functions follow the c-convention, the caller owns them unless they mention it explicitly.

In summary:

  • The caller owns the data.
  • Some functions allocate on behalf of the caller (in which case there's a corresponding free that needs to be called).

Examples

For some example code please take a look at testsuite folder. Where example_test.c shows the most common use cases.

License

This library is distributed under the MIT/expat license.

Support

If you have any questions or suggestions please reach out to us on our community forum or email us at suppo.nosp@m.rt@t.nosp@m.ardig.nosp@m.rade.nosp@m..io.