tail head cat sleep
QR code linking to this page

Manual Pages  — hx509 name functions

NAME

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)

CONTENTS

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_name name, 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_name n1, hx509_name n2)

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_context context, const hx509_name from, 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_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:

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_name name)

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_name from, 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_name name, 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_context context, 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_t length, 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().


11 Jan 2012 hx509 name functions (3) Version 1.5.2

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

Do you laugh when the waiter drops a tray full of dishes? Unix weenies do. They're the first ones to laugh at hapless users, trying to figure out an error message that doesn't have anything to do with what they just typed.
— The Unix Haters' handbook