rtxBase64.h File Reference

#include "rtxsrc/rtxContext.h"

Go to the source code of this file.

Functions
long	rtxBase64EncodeData (OSCTXT *pctxt, const char *pSrcData, size_t srcDataSize, OSOCTET **ppDstData)
long	rtxBase64EncodeURLParam (OSCTXT *pctxt, const char *pSrcData, size_t srcDataSize, OSOCTET **ppDstData)
long	rtxBase64DecodeData (OSCTXT *pctxt, const char *pSrcData, size_t srcDataSize, OSOCTET **ppDstData)
long	rtxBase64DecodeDataToFSB (OSCTXT *pctxt, const char *pSrcData, size_t srcDataSize, OSOCTET *buf, size_t bufsiz)
long	rtxBase64GetBinDataLen (const char *pSrcData, size_t srcDataSize)
long	rtxBase64UrlEncodeData (OSCTXT *pctxt, const char *pSrcData, size_t srcDataSize, OSOCTET **ppDstData)
long	rtxBase64UrlDecodeData (OSCTXT *pctxt, const char *pSrcData, size_t srcDataSize, OSOCTET **ppDstData)
long	rtxBase64UrlDecodeDataToFSB (OSCTXT *pctxt, const char *pSrcData, size_t srcDataSize, OSOCTET *buf, size_t bufsiz)
int	rtxBase64CharToIdx (char c, OSBOOL url)
char	rtxBase64IdxToChar (int idx, OSBOOL url)

Detailed Description

base64 and base64url are defined in RFC 4648.

Function Documentation

rtxBase64CharToIdx()

int rtxBase64CharToIdx	(	char	c,
		OSBOOL	url
	)

Convert base64 character to index.

Parameters

c	Character to convert.
url	Flag indicating if base64 string is used in a URL

Returns

Converted integer value or -1 if invalid character.

rtxBase64DecodeData()

long rtxBase64DecodeData	(	OSCTXT *	pctxt,
		const char *	pSrcData,
		size_t	srcDataSize,
		OSOCTET **	ppDstData
	)

Decode base64 string to binary form into a dynamic buffer.

Parameters

pctxt	Pointer to context structure.
pSrcData	Pointer to base64 string to decode.
srcDataSize	Length of the base64 string.
ppDstData	Pointer to pointer variable to hold address of dynamically allocated buffer to hold data.

Returns

Completion status of operation:

• number of binary bytes written
• negative return value is error.

rtxBase64DecodeDataToFSB()

long rtxBase64DecodeDataToFSB	(	OSCTXT *	pctxt,
		const char *	pSrcData,
		size_t	srcDataSize,
		OSOCTET *	buf,
		size_t	bufsiz
	)

Decode base64 string to binary form into a fixed-size buffer.

Parameters

pctxt	Pointer to context structure.
pSrcData	Pointer to base64 string to decode.
srcDataSize	Length of the base64 string.
buf	Address of buffer to receive decoded binary data.
bufsiz	Size of output buffer.

Returns

Completion status of operation:

• number of binary bytes written
• negative return value is error.

rtxBase64EncodeData()

long rtxBase64EncodeData	(	OSCTXT *	pctxt,
		const char *	pSrcData,
		size_t	srcDataSize,
		OSOCTET **	ppDstData
	)

Encode binary data into base64 string form to a dynamic buffer.

Parameters

pctxt	Pointer to context structure.
pSrcData	Pointer to binary data to encode.
srcDataSize	Length of the binary data in octets.
ppDstData	Pointer to pointer variable to hold address of dynamically allocated buffer the encoded base64 string.

Returns

Completion status of operation:

• number of binary bytes written
• negative return value is error.

rtxBase64EncodeURLParam()

long rtxBase64EncodeURLParam	(	OSCTXT *	pctxt,
		const char *	pSrcData,
		size_t	srcDataSize,
		OSOCTET **	ppDstData
	)

Encode binary data into base64 string form to a dynamic buffer, converting '+' characters to the URL escape sequence %2B so that the encoded string may be used in a query string parameter in a URL.

Parameters

pctxt	Pointer to context structure.
pSrcData	Pointer to binary data to encode.
srcDataSize	Length of the binary data in octets.
ppDstData	Pointer to pointer variable to hold address of dynamically allocated buffer the encoded base64 string.

Returns

Completion status of operation:

• number of binary bytes written
• negative return value is error.

rtxBase64GetBinDataLen()

long rtxBase64GetBinDataLen	(	const char *	pSrcData,
		size_t	srcDataSize
	)

Calculate number of byte required to hold a decoded base64/base64url string in binary form.

Parameters

pSrcData	Pointer to base64/base64url string.
srcDataSize	Length of the base64/base64url string.

Returns

Completion status of operation: If success, positive value is number of bytes, If failure, negative status code.

rtxBase64IdxToChar()

char rtxBase64IdxToChar	(	int	idx,
		OSBOOL	url
	)

Convert base64 index to character.

Parameters

idx	Index to convert.
url	Flag indicating if base64 string is used in a URL

Returns

Converted character value or -1 if invalid index;

rtxBase64UrlDecodeData()

long rtxBase64UrlDecodeData	(	OSCTXT *	pctxt,
		const char *	pSrcData,
		size_t	srcDataSize,
		OSOCTET **	ppDstData
	)

Decode base64url string to binary form into a dynamic buffer.

Parameters

pctxt	Pointer to context structure.
pSrcData	Pointer to base64 string to decode.
srcDataSize	Length of the base64 string.
ppDstData	Pointer to pointer variable to hold address of dynamically allocated buffer to hold data.

Returns

Completion status of operation:

• number of binary bytes written
• negative return value is error.

rtxBase64UrlDecodeDataToFSB()

long rtxBase64UrlDecodeDataToFSB	(	OSCTXT *	pctxt,
		const char *	pSrcData,
		size_t	srcDataSize,
		OSOCTET *	buf,
		size_t	bufsiz
	)

Decode base64url string to binary form into a fixed-size buffer.

Parameters

pctxt	Pointer to context structure.
pSrcData	Pointer to base64 string to decode.
srcDataSize	Length of the base64 string.
buf	Address of buffer to receive decoded binary data.
bufsiz	Size of output buffer.

Returns

Completion status of operation:

• number of binary bytes written
• negative return value is error.

rtxBase64UrlEncodeData()

long rtxBase64UrlEncodeData	(	OSCTXT *	pctxt,
		const char *	pSrcData,
		size_t	srcDataSize,
		OSOCTET **	ppDstData
	)

Encode binary data into base64url string form to a dynamic buffer.

Parameters

pctxt	Pointer to context structure.
pSrcData	Pointer to binary data to encode.
srcDataSize	Length of the binary data in octets.
ppDstData	Pointer to pointer variable to hold address of dynamically allocated buffer the encoded base64 string.

Returns

Completion status of operation:

• number of binary bytes written
• negative return value is error.