libMariaS3

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:

• Andrew (LinuxJedi) Hutchings
  • Starting with this commit, all my contributions are under the 3-clause BSD license.
• Sergei Golubchik
• Markus Mäkelä

libMariaS3 uses the following Open Source projects:

• libcurl
• xml.c
• DDM4
• Jouni Malinen's SHA256 hash code