keyhole logo

Functions

hx509 name functions

Functions

int hx509_name_to_string (const hx509_name name, char **str)
int hx509_name_cmp (hx509_name n1, hx509_name n2)
int hx509_parse_name (hx509_context context, const char *str, hx509_name *name)
int hx509_name_copy (hx509_context context, const hx509_name from, hx509_name *to)
int hx509_name_to_Name (const hx509_name from, Name *to)
int hx509_name_expand (hx509_context context, hx509_name name, hx509_env env)
void hx509_name_free (hx509_name *name)
int hx509_unparse_der_name (const void *data, size_t length, char **str)
int hx509_name_binary (const hx509_name name, heim_octet_string *os)
int hx509_name_is_null_p (const hx509_name name)
int hx509_general_name_unparse (GeneralName *name, char **str)

Detailed Description

See the PKIX/X.509 Names for description and examples.


Function Documentation

int hx509_general_name_unparse ( GeneralName *  name,
char **  str 
)

Unparse the hx509 name in name into a string.

Parameters:
namethe name to print
stran allocated string returns the name in string form
Returns:
An hx509 error code, see hx509_get_error_string().
int hx509_name_binary ( const hx509_name  name,
heim_octet_string *  os 
)

Convert a hx509_name object to DER encoded name.

Parameters:
namename to concert
osdata to a DER encoded name, free the resulting octet string with hx509_xfree(os->data).
Returns:
An hx509 error code, see hx509_get_error_string().
int hx509_name_cmp ( hx509_name  n1,
hx509_name  n2 
)

Compare to hx509 name object, useful for sorting.

Parameters:
n1a hx509 name object.
n2a hx509 name object.
Returns:
0 the objects are the same, returns > 0 is n2 is "larger" then n2, < 0 if n1 is "smaller" then n2.
int hx509_name_copy ( hx509_context  context,
const hx509_name  from,
hx509_name *  to 
)

Copy a hx509 name object.

Parameters:
contextA hx509 cotext.
fromthe name to copy from
tothe name to copy to
Returns:
An hx509 error code, see hx509_get_error_string().
int hx509_name_expand ( hx509_context  context,
hx509_name  name,
hx509_env  env 
)

Expands variables in the name using env. Variables are on the form ${name}. Useful when dealing with certificate templates.

Parameters:
contextA hx509 cotext.
namethe name to expand.
envenvironment variable to expand.
Returns:
An hx509 error code, see hx509_get_error_string().

Only UTF8String rdnSequence names are allowed

void hx509_name_free ( hx509_name *  name )

Free a hx509 name object, upond return *name will be NULL.

Parameters:
namea hx509 name object to be freed.
int hx509_name_is_null_p ( const hx509_name  name )

Unparse the hx509 name in name into a string.

Parameters:
namethe name to check if its empty/null.
Returns:
non zero if the name is empty/null.
int hx509_name_to_Name ( const hx509_name  from,
Name *  to 
)

Convert a hx509_name into a Name.

Parameters:
fromthe name to copy from
tothe name to copy to
Returns:
An hx509 error code, see hx509_get_error_string().
int hx509_name_to_string ( const hx509_name  name,
char **  str 
)

Convert the hx509 name object into a printable string. The resulting string should be freed with free().

Parameters:
namename to print
strthe string to return
Returns:
An hx509 error code, see hx509_get_error_string().
int hx509_parse_name ( hx509_context  context,
const char *  str,
hx509_name *  name 
)

Parse a string into a hx509 name object.

Parameters:
contextA hx509 context.
stra string to parse.
namethe resulting object, NULL in case of error.
Returns:
An hx509 error code, see hx509_get_error_string().
int hx509_unparse_der_name ( const void *  data,
size_t  length,
char **  str 
)

Convert a DER encoded name info a string.

Parameters:
datadata to a DER/BER encoded name
lengthlength of data
strthe resulting string, is NULL on failure.
Returns:
An hx509 error code, see hx509_get_error_string().

Generated on Fri Dec 6 2013 08:13:05 for Heimdalx509library by doxygen 1.7.2