Stand-alone version of libs3client
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
debian
m4 @ b0541fb
man1
.gitignore
.gitmodules
.travis.yml
Makefile.am
README.md
attributes.h
aws_string.c
aws_string.h
base64.c
bdd-for-c.h
bucket.c
bucket_spec.c
configure.ac
curl_slist.c
curl_slist.h
http.c
http.h
libawsclient-uninstalled.pc.in
libawsclient.h
libawsclient.pc.in
libs3client.h
mem.c
mem.h
p_libawsclient.h
request.c
request_spec.c
s3cat.c
sign.c
sign_spec.c

README.md

This is a small client library for making requests to Amazon S3 and other services which expose the same API (such as RADOS).

It was originally written as part of Anansi, but has been split into a separate project to facilitiate reuse.

It depends upon libcurl, liburi and OpenSSL (except on Mac OS X, where CommonCrypto is used instead).

libawsclient URIs have the following form (all parameters are optional if the defaults are sufficient or the information is supplied through specific setter calls):


s3://ACCESSKEY:SECRETKEY@BUCKET/RESOURCE?endpoint=HOSTNAME&region=REGION&ver=AUTHVER&token=TOKEN

In the above:

Name Description
ACCESSKEY The AWS access key
SECRETKEY The AWS secret key
HOSTNAME The endpoint name (defaulting to s3.amazonaws.com for S3 requests)
REGION The region name for v4 authentication, e.g., us-west-1
AUTHVER The authentication mechanism to use; defaults to '2' unless a REGION or TOKEN are supplied, in which case '4'
TOKEN An AWS session token, if you have one
BUCKET The name of the S3 bucket to access
RESOURCE The path of the resource within a bucket