H5FDs3comms.h File Reference

Data Structures
struct	hrb_node_t
struct	hrb_t
struct	parsed_url_t
struct	s3r_t

Typedefs
typedef struct hrb_node_t	hrb_node_t

Functions
H5_DLL herr_t	H5FD_s3comms_hrb_node_set (hrb_node_t **L, const char *name, const char *value)
H5_DLL herr_t	H5FD_s3comms_hrb_destroy (hrb_t **buf)
H5_DLL hrb_t *	H5FD_s3comms_hrb_init_request (const char *verb, const char *resource, const char *host)
H5_DLL herr_t	H5FD_s3comms_s3r_close (s3r_t *handle)
H5_DLL size_t	H5FD_s3comms_s3r_get_filesize (s3r_t *handle)
H5_DLL s3r_t *	H5FD_s3comms_s3r_open (const char url[], const char region[], const char id[], const unsigned char signing_key[])
H5_DLL herr_t	H5FD_s3comms_s3r_read (s3r_t *handle, haddr_t offset, size_t len, void *dest)
H5_DLL struct tm *	gmnow (void)
H5_DLL herr_t	H5FD_s3comms_aws_canonical_request (char *canonical_request_dest, int cr_size, char *signed_headers_dest, int sh_size, hrb_t *http_request)
H5_DLL herr_t	H5FD_s3comms_bytes_to_hex (char *dest, const unsigned char *msg, size_t msg_len, hbool_t lowercase)
H5_DLL herr_t	H5FD_s3comms_free_purl (parsed_url_t *purl)
H5_DLL herr_t	H5FD_s3comms_HMAC_SHA256 (const unsigned char *key, size_t key_len, const char *msg, size_t msg_len, char *dest)
H5_DLL herr_t	H5FD_s3comms_load_aws_profile (const char *name, char *key_id_out, char *secret_access_key_out, char *aws_region_out)
H5_DLL herr_t	H5FD_s3comms_nlowercase (char *dest, const char *s, size_t len)
H5_DLL herr_t	H5FD_s3comms_parse_url (const char *str, parsed_url_t **purl)
H5_DLL herr_t	H5FD_s3comms_percent_encode_char (char *repr, const unsigned char c, size_t *repr_len)
H5_DLL herr_t	H5FD_s3comms_signing_key (unsigned char *md, const char *secret, const char *region, const char *iso8601now)
H5_DLL herr_t	H5FD_s3comms_tostringtosign (char *dest, const char *req_str, const char *now, const char *region)
H5_DLL herr_t	H5FD_s3comms_trim (char *dest, char *s, size_t s_len, size_t *n_written)
H5_DLL herr_t	H5FD_s3comms_uriencode (char *dest, const char *s, size_t s_len, hbool_t encode_slash, size_t *n_written)

Typedef Documentation

hrb_node_t

typedef struct hrb_node_t hrb_node_t

Function Documentation

gmnow()

H5_DLL struct tm* gmnow

(

void

)

References HDassert(), NULL, and ret_value.

Referenced by H5FD_s3comms_s3r_read().

H5FD_s3comms_aws_canonical_request()

H5_DLL herr_t H5FD_s3comms_aws_canonical_request	(	char *	canonical_request_dest,
		int	cr_size,
		char *	signed_headers_dest,
		int	sh_size,
		hrb_t *	http_request
	)

References FAIL, hrb_t::first_header, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, HDassert(), HDfprintf(), hrb_node_t::lowername, hrb_node_t::magic, hrb_t::magic, hrb_node_t::next, NULL, hrb_t::resource, ret_value, hrb_node_t::value, and hrb_t::verb.

Referenced by H5FD_s3comms_s3r_read().

H5FD_s3comms_bytes_to_hex()

H5_DLL herr_t H5FD_s3comms_bytes_to_hex	(	char *	dest,
		const unsigned char *	msg,
		size_t	msg_len,
		hbool_t	lowercase
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, HDfprintf(), NULL, and ret_value.

Referenced by H5FD_s3comms_HMAC_SHA256(), H5FD_s3comms_percent_encode_char(), and H5FD_s3comms_tostringtosign().

H5FD_s3comms_free_purl()

H5_DLL herr_t H5FD_s3comms_free_purl

(

parsed_url_t *

purl

)

References FUNC_LEAVE_NOAPI(), H5MM_xfree(), HDassert(), parsed_url_t::host, parsed_url_t::magic, NULL, parsed_url_t::path, parsed_url_t::port, parsed_url_t::query, and parsed_url_t::scheme.

Referenced by H5FD_s3comms_parse_url(), H5FD_s3comms_s3r_close(), and H5FD_s3comms_s3r_open().

H5FD_s3comms_HMAC_SHA256()

H5_DLL herr_t H5FD_s3comms_HMAC_SHA256	(	const unsigned char *	key,
		size_t	key_len,
		const char *	msg,
		size_t	msg_len,
		char *	dest
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5FD_s3comms_bytes_to_hex(), HDfprintf(), NULL, and ret_value.

Referenced by H5FD_s3comms_s3r_read().

H5FD_s3comms_hrb_destroy()

H5_DLL herr_t H5FD_s3comms_hrb_destroy

(

hrb_t **

buf

)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5MM_xfree(), HDfprintf(), hrb_t::magic, NULL, hrb_t::resource, ret_value, hrb_t::verb, and hrb_t::version.

Referenced by H5FD_s3comms_s3r_read().

H5FD_s3comms_hrb_init_request()

H5_DLL hrb_t* H5FD_s3comms_hrb_init_request	(	const char *	verb,
		const char *	resource,
		const char *	host
	)

References hrb_t::body, hrb_t::body_len, hrb_t::first_header, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5MM_malloc(), H5MM_xfree(), HDassert(), HDfprintf(), hrb_t::magic, NULL, hrb_t::resource, ret_value, hrb_t::verb, and hrb_t::version.

Referenced by H5FD_s3comms_s3r_read().

H5FD_s3comms_hrb_node_set()

H5_DLL herr_t H5FD_s3comms_hrb_node_set	(	hrb_node_t **	L,
		const char *	name,
		const char *	value
	)

References hrb_node_t::cat, FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5MM_malloc(), H5MM_xfree(), HDassert(), HDfprintf(), hrb_node_t::lowername, hrb_node_t::magic, hrb_node_t::name, name, hrb_node_t::next, NULL, ret_value, and hrb_node_t::value.

Referenced by H5FD_s3comms_s3r_read().

H5FD_s3comms_load_aws_profile()

H5_DLL herr_t H5FD_s3comms_load_aws_profile	(	const char *	name,
		char *	key_id_out,
		char *	secret_access_key_out,
		char *	aws_region_out
	)

References FAIL, HDfprintf(), NULL, and ret_value.

H5FD_s3comms_nlowercase()

H5_DLL herr_t H5FD_s3comms_nlowercase	(	char *	dest,
		const char *	s,
		size_t	len
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, HDfprintf(), len, NULL, ret_value, and s.

H5FD_s3comms_parse_url()

H5_DLL herr_t H5FD_s3comms_parse_url	(	const char *	str,
		parsed_url_t **	purl
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5FD_s3comms_free_purl(), H5MM_malloc(), HDassert(), parsed_url_t::host, len, parsed_url_t::magic, NULL, parsed_url_t::path, parsed_url_t::port, parsed_url_t::query, ret_value, and parsed_url_t::scheme.

Referenced by H5FD_s3comms_s3r_open().

H5FD_s3comms_percent_encode_char()

H5_DLL herr_t H5FD_s3comms_percent_encode_char	(	char *	repr,
		const unsigned char	c,
		size_t *	repr_len
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5FD_s3comms_bytes_to_hex(), HDfprintf(), NULL, ret_value, and s.

Referenced by H5FD_s3comms_uriencode().

H5FD_s3comms_s3r_close()

H5_DLL herr_t H5FD_s3comms_s3r_close

(

s3r_t *

handle

)

References s3r_t::curlhandle, FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5FD_s3comms_free_purl(), H5MM_xfree(), HDassert(), HDfprintf(), s3r_t::httpverb, s3r_t::magic, NULL, s3r_t::purl, s3r_t::region, ret_value, s3r_t::secret_id, and s3r_t::signing_key.

H5FD_s3comms_s3r_get_filesize()

H5_DLL size_t H5FD_s3comms_s3r_get_filesize

(

s3r_t *

handle

)

References s3r_t::filesize, FUNC_LEAVE_NOAPI(), NULL, and ret_value.

H5FD_s3comms_s3r_open()

H5_DLL s3r_t* H5FD_s3comms_s3r_open	(	const char	url[],
		const char	region[],
		const char	id[],
		const unsigned char	signing_key[]
	)

H5FD_s3comms_s3r_read()

H5_DLL herr_t H5FD_s3comms_s3r_read	(	s3r_t *	handle,
		haddr_t	offset,
		size_t	len,
		void *	dest
	)

References hrb_node_t::cat, s3r_t::curlhandle, s3r_datastruct::data, FAIL, s3r_t::filesize, hrb_t::first_header, FUNC_LEAVE_NOAPI(), gmnow(), H5E_BADVALUE, H5FD_s3comms_aws_canonical_request(), H5FD_s3comms_HMAC_SHA256(), H5FD_s3comms_hrb_destroy(), H5FD_s3comms_hrb_init_request(), H5FD_s3comms_hrb_node_set(), H5FD_s3comms_tostringtosign(), H5MM_malloc(), H5MM_xfree(), HDassert(), HDfprintf(), parsed_url_t::host, s3r_t::httpverb, len, s3r_datastruct::magic, hrb_node_t::magic, hrb_t::magic, parsed_url_t::magic, s3r_t::magic, hrb_node_t::name, hrb_node_t::next, NULL, offset, parsed_url_t::path, s3r_t::purl, s3r_t::region, ret_value, s3r_t::secret_id, s3r_t::signing_key, and s3r_datastruct::size.

Referenced by H5FD_s3comms_s3r_getsize().

H5FD_s3comms_signing_key()

H5_DLL herr_t H5FD_s3comms_signing_key	(	unsigned char *	md,
		const char *	secret,
		const char *	region,
		const char *	iso8601now
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5MM_malloc(), H5MM_xfree(), HDfprintf(), NULL, and ret_value.

H5FD_s3comms_tostringtosign()

H5_DLL herr_t H5FD_s3comms_tostringtosign	(	char *	dest,
		const char *	req_str,
		const char *	now,
		const char *	region
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5FD_s3comms_bytes_to_hex(), HDfprintf(), NULL, and ret_value.

Referenced by H5FD_s3comms_s3r_read().

H5FD_s3comms_trim()

H5_DLL herr_t H5FD_s3comms_trim	(	char *	dest,
		char *	s,
		size_t	s_len,
		size_t *	n_written
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, HDfprintf(), NULL, ret_value, and s.

H5FD_s3comms_uriencode()

H5_DLL herr_t H5FD_s3comms_uriencode	(	char *	dest,
		const char *	s,
		size_t	s_len,
		hbool_t	encode_slash,
		size_t *	n_written
	)

References FAIL, FUNC_LEAVE_NOAPI(), H5E_BADVALUE, H5FD_s3comms_percent_encode_char(), HDfprintf(), NULL, ret_value, and s.