Skip to content

A lightweight, LGPL-2.1 licensed C API to read from / write to S3 buckets

License

Notifications You must be signed in to change notification settings

mariadb-corporation/libmarias3

Repository files navigation

libMariaS3

Documentation Status

This is a lightweight C library to read/write to AWS S3 buckets using objects in memory.

You will need an access key which for AWS can be created at the AWS security crenditials page.

Compiling

autoreconf -fi
./configure
make

Testing

libMariaS3 comes with a basic test suite which we recommend executing, especially if you are building for a new platform.

You will need the following OS environment variables set to run the tests:

Variable Desription
S3KEY Your AWS access key
S3SECRET Your AWS secret key
S3REGION The AWS region (for example us-east-1)
S3BUCKET The S3 bucket name
S3HOST OPTIONAL hostname for non-AWS S3 service
S3PORT OPTIONAL port for non-AWS S3 service
S3USEHTTP Set to 1 if the host uses http instead of https
S3NOVERIFY Set to 1 if the host should not use SSL verification

If you have minion installed, you should be able to use same settings as used by MariaDB mtr s3 tests:

export S3KEY=minio
export S3SECRET=minioadmin
export S3REGION=
export S3BUCKET=storage-engine
export S3HOST=127.0.0.1
export S3PORT=9000
export S3USEHTTP=1

The test suite is automatically built along with the library and can be executed with make check or make distcheck.

Before pushing, please ALWAYS ensure that make check and make distcheck works!

Credits

The libMariaS3 authors are:

libMariaS3 uses the following Open Source projects:

About

A lightweight, LGPL-2.1 licensed C API to read from / write to S3 buckets

Resources

License

Stars

Watchers

Forks

Packages

No packages published