NAME
hx509 name functions –
Functions
int hx509_general_name_unparse (GeneralName *, char **)
int hx509_name_binary (const hx509_name, heim_octet_string *)
int hx509_name_cmp (hx509_name, hx509_name)
int hx509_name_copy (hx509_context, const hx509_name, hx509_name *)
int hx509_name_expand (hx509_context, hx509_name, hx509_env)
void hx509_name_free (hx509_name *)
int hx509_name_is_null_p (const hx509_name)
int hx509_name_to_Name (const hx509_name, Name *)
int hx509_name_to_string (const hx509_name, char **)
int hx509_parse_name (hx509_context, const char *, hx509_name *)
int hx509_unparse_der_name (const void *, size_t, char **)
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:
- name the name to print
str an allocated string returns the name in string form
Returns:
- An hx509 error code, see hx509_get_error_string().
int hx509_name_binary (const hx509_namename, heim_octet_string *os)
Convert a hx509_name object to DER encoded name.
Parameters:
- name name to concert
os data 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_namen1, hx509_namen2)
Compare to hx509 name object, useful for sorting.
Parameters:
- n1 a hx509 name object.
n2 a 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_contextcontext, const hx509_namefrom, hx509_name *to)
Copy a hx509 name object.
Parameters:
- context A hx509 cotext.
from the name to copy from
to the name to copy to
Returns:
- An hx509 error code, see hx509_get_error_string().
int hx509_name_expand (hx509_contextcontext, hx509_namename, hx509_envenv)
Expands variables in the name using env. Variables are on the form ${name}. Useful when dealing with certificate templates.
Parameters:
- context A hx509 cotext.
name the name to expand.
env environment 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:
- name a hx509 name object to be freed.
int hx509_name_is_null_p (const hx509_namename)
Unparse the hx509 name in name into a string.
Parameters:
- name the name to check if its empty/null.
Returns:
- non zero if the name is empty/null.
int hx509_name_to_Name (const hx509_namefrom, Name *to)
Convert a hx509_name into a Name.
Parameters:
- from the name to copy from
to the name to copy to
Returns:
- An hx509 error code, see hx509_get_error_string().
int hx509_name_to_string (const hx509_namename, char **str)
Convert the hx509 name object into a printable string. The resulting string should be freed with free().
Parameters:
- name name to print
str the string to return
Returns:
- An hx509 error code, see hx509_get_error_string().
int hx509_parse_name (hx509_contextcontext, const char *str, hx509_name *name)
Parse a string into a hx509 name object.
Parameters:
- context A hx509 context.
str a string to parse.
name the 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_tlength, char **str)
Convert a DER encoded name info a string.
Parameters:
- data data to a DER/BER encoded name
length length of data
str the resulting string, is NULL on failure.
Returns:
- An hx509 error code, see hx509_get_error_string().
Author
Generated automatically by Doxygen for Heimdalx509library from the source code.