From 3f619478f796eddbba6e39502fe941b285dd97b1 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 4 May 2024 20:00:34 +0200 Subject: Adding upstream version 1:10.11.6. Signed-off-by: Daniel Baumann --- storage/maria/libmarias3/README.rst | 68 +++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 storage/maria/libmarias3/README.rst (limited to 'storage/maria/libmarias3/README.rst') diff --git a/storage/maria/libmarias3/README.rst b/storage/maria/libmarias3/README.rst new file mode 100644 index 00000000..2d9a7f49 --- /dev/null +++ b/storage/maria/libmarias3/README.rst @@ -0,0 +1,68 @@ +libMariaS3 +========== + +.. image:: https://readthedocs.org/projects/libmarias3/badge/?version=latest + :target: https://libmarias3.readthedocs.io/en/latest/?badge=latest + :alt: 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 +--------- + +.. code-block:: bash + + 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 | ++------------+----------------------------------------------------------+ + +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 `_ -- cgit v1.2.3