"hx509 printing functions" 3 "11 Jan 2012" "Version 1.5.2" "Heimdalx509library" \" -*- nroff -*-
 NAME
hx509 printing functions - 

 "Functions"

 "void hx509_print_stdout (void *ctx, const char *fmt, va_list va)" 

 "int hx509_oid_sprint (const heim_oid *oid, char **str)" 

 "void hx509_oid_print (const heim_oid *oid, hx509_vprint_func func, void *ctx)" 

 "void hx509_bitstring_print (const heim_bit_string *b, hx509_vprint_func func, void *ctx)" 

 "int hx509_cert_keyusage_print (hx509_context context, hx509_cert c, char **s)" 

 "int hx509_validate_ctx_init (hx509_context context, hx509_validate_ctx *ctx)" 

 "void hx509_validate_ctx_set_print (hx509_validate_ctx ctx, hx509_vprint_func func, void *c)" 

 "void hx509_validate_ctx_add_flags (hx509_validate_ctx ctx, int flags)" 

 "void hx509_validate_ctx_free (hx509_validate_ctx ctx)" 

 "int hx509_validate_cert (hx509_context context, hx509_validate_ctx ctx, hx509_cert cert)" 


 "Detailed Description"
 


 "Function Documentation"
 

 "void hx509_bitstring_print (const heim_bit_string * b, hx509_vprint_func func, void * ctx)"

Print a bitstring using a hx509_vprint_func function. To print to stdout use hx509_print_stdout().


Parameters:


b bit string to print. 


func hx509_vprint_func to print with. 


ctx context variable to hx509_vprint_func function. 






 "int hx509_cert_keyusage_print (hx509_context context, hx509_cert c, char ** s)"

Print certificate usage for a certificate to a string.


Parameters:


context A hx509 context. 


c a certificate print the keyusage for. 


s the return string with the keysage printed in to, free with hx509_xfree().




Returns:


An hx509 error code, see hx509_get_error_string(). 






 "void hx509_oid_print (const heim_oid * oid, hx509_vprint_func func, void * ctx)"

Print a oid using a hx509_vprint_func function. To print to stdout use hx509_print_stdout().


Parameters:


oid oid to print 


func hx509_vprint_func to print with. 


ctx context variable to hx509_vprint_func function. 






 "int hx509_oid_sprint (const heim_oid * oid, char ** str)"

Print a oid to a string.


Parameters:


oid oid to print 


str allocated string, free with hx509_xfree().




Returns:


An hx509 error code, see hx509_get_error_string(). 






 "void hx509_print_stdout (void * ctx, const char * fmt, va_list va)"

Helper function to print on stdout for:

 "\(bu" 2
hx509_oid_print(),

 "\(bu" 2
hx509_bitstring_print(),

 "\(bu" 2
hx509_validate_ctx_set_print().




Parameters:


ctx the context to the print function. If the ctx is NULL, stdout is used. 


fmt the printing format. 


va the argumet list. 






 "int hx509_validate_cert (hx509_context context, hx509_validate_ctx ctx, hx509_cert cert)"

Validate/Print the status of the certificate.


Parameters:


context A hx509 context. 


ctx A hx509 validation context. 


cert the cerificate to validate/print.




Returns:


An hx509 error code, see hx509_get_error_string(). 






 "void hx509_validate_ctx_add_flags (hx509_validate_ctx ctx, int flags)"

Add flags to control the behaivor of the hx509_validate_cert() function.


Parameters:


ctx A hx509 validation context. 


flags flags to add to the validation context.




Returns:


An hx509 error code, see hx509_get_error_string(). 






 "void hx509_validate_ctx_free (hx509_validate_ctx ctx)"

Free an hx509 validate context.


Parameters:


ctx the hx509 validate context to free. 






 "int hx509_validate_ctx_init (hx509_context context, hx509_validate_ctx * ctx)"

Allocate a hx509 validation/printing context.


Parameters:


context A hx509 context. 


ctx a new allocated hx509 validation context, free with hx509_validate_ctx_free().




Returns:


An hx509 error code, see hx509_get_error_string(). 






 "void hx509_validate_ctx_set_print (hx509_validate_ctx ctx, hx509_vprint_func func, void * c)"

Set the printing functions for the validation context.


Parameters:


ctx a hx509 valication context. 


func the printing function to usea. 


c the context variable to the printing function.




Returns:


An hx509 error code, see hx509_get_error_string().