Operation Functions

This section details the functions which facilitate symmetric key cryptography.

Functions
int	R_SKEY_new (R_LIB_CTX ctx, int key_type, R_ITEM key_descriptor, R_SKEY **new_skey)
	Creates a new R_SKEY. More...
int	R_SKEY_free (R_SKEY *skey)
	Deallocates the memory for the symmetric key object skey. More...
int	R_SKEY_get_info (R_SKEY skey, int id, void param)
	Returns the R_SKEY key data. More...

Function Documentation

int R_SKEY_free ( R_SKEY * skey ) ;

Deallocates the memory for the symmetric key object skey.
Parameters:

skey [In] The R_SKEY reference.

Returns:
R_ERROR_NONE indicates success.
See Error Identifiers for valid values.
Note:
It is the calling function's responsibility to set the R_SKEY pointer to NULL.
See also:
R_SKEY_new() and R_SKEY_get_info().

int R_SKEY_get_info ( R_SKEY * key,

int id,

void * param

) ;

Returns the R_SKEY key data.
Parameters:

key [In] The data hold.

id [In] The information type to return.

param [Out] The place holder for data return.

Returns:
R_ERROR_NONE indicates success.
See Error Identifiers for valid values.
See also:
R_SKEY_new() and R_SKEY_free().

int R_SKEY_new ( R_LIB_CTX * ctx,

int key_type,

R_ITEM * key_descriptor,

R_SKEY ** new_skey

) ;

Creates a new R_SKEY.
Parameters:

ctx [In] The library context.

key_type [In] The type of key.
Only R_SKEY_TYPE_GENERIC is supported.

key_descriptor [In] The key data.

new_skey [Out] The place holder for key return.

Returns:
R_ERROR_NONE indicates success.
See Error Identifiers for valid values.
Note:
The actual length of data pointed to by key_descriptor->data is at least of size identified in key_descriptor->len.
See also:
R_SKEY_free() and R_SKEY_get_info().