.\"	$NetBSD: hx509_print.3,v 1.2.10.1 2023/08/11 13:39:51 martin Exp $
.\"
.TH "hx509_print" 3 "Tue Nov 15 2022" "Version 7.8.0" "Heimdal x509 library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
hx509_print \- hx509 printing functions
.SH SYNOPSIS
.br
.PP
.SS "Functions"

.in +1c
.ti -1c
.RI "void \fBhx509_print_stdout\fP (void *ctx, const char *fmt, va_list va)"
.br
.ti -1c
.RI "int \fBhx509_oid_sprint\fP (const heim_oid *oid, char **str)"
.br
.ti -1c
.RI "void \fBhx509_oid_print\fP (const heim_oid *oid, hx509_vprint_func func, void *ctx)"
.br
.ti -1c
.RI "void \fBhx509_bitstring_print\fP (const heim_bit_string *b, hx509_vprint_func func, void *ctx)"
.br
.ti -1c
.RI "int \fBhx509_cert_keyusage_print\fP (hx509_context context, hx509_cert c, char **s)"
.br
.ti -1c
.RI "int \fBhx509_validate_ctx_init\fP (hx509_context context, hx509_validate_ctx *ctx)"
.br
.ti -1c
.RI "void \fBhx509_validate_ctx_set_print\fP (hx509_validate_ctx ctx, hx509_vprint_func func, void *c)"
.br
.ti -1c
.RI "void \fBhx509_validate_ctx_add_flags\fP (hx509_validate_ctx ctx, int flags)"
.br
.ti -1c
.RI "void \fBhx509_validate_ctx_free\fP (hx509_validate_ctx ctx)"
.br
.ti -1c
.RI "int \fBhx509_validate_cert\fP (hx509_context context, hx509_validate_ctx ctx, hx509_cert cert)"
.br
.in -1c
.SH "Detailed Description"
.PP 

.SH "Function Documentation"
.PP 
.SS "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 \fBhx509_print_stdout()\fP\&.
.PP
\fBParameters\fP
.RS 4
\fIb\fP bit string to print\&. 
.br
\fIfunc\fP hx509_vprint_func to print with\&. 
.br
\fIctx\fP context variable to hx509_vprint_func function\&. 
.RE
.PP

.SS "int hx509_cert_keyusage_print (hx509_context context, hx509_cert c, char ** s)"
Print certificate usage for a certificate to a string\&.
.PP
\fBParameters\fP
.RS 4
\fIcontext\fP A hx509 context\&. 
.br
\fIc\fP a certificate print the keyusage for\&. 
.br
\fIs\fP the return string with the keysage printed in to, free with \fBhx509_xfree()\fP\&.
.RE
.PP
\fBReturns\fP
.RS 4
An hx509 error code, see \fBhx509_get_error_string()\fP\&. 
.RE
.PP

.SS "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 \fBhx509_print_stdout()\fP\&.
.PP
\fBParameters\fP
.RS 4
\fIoid\fP oid to print 
.br
\fIfunc\fP hx509_vprint_func to print with\&. 
.br
\fIctx\fP context variable to hx509_vprint_func function\&. 
.RE
.PP

.SS "int hx509_oid_sprint (const heim_oid * oid, char ** str)"
Print a oid to a string\&.
.PP
\fBParameters\fP
.RS 4
\fIoid\fP oid to print 
.br
\fIstr\fP allocated string, free with \fBhx509_xfree()\fP\&.
.RE
.PP
\fBReturns\fP
.RS 4
An hx509 error code, see \fBhx509_get_error_string()\fP\&. 
.RE
.PP

.SS "void hx509_print_stdout (void * ctx, const char * fmt, va_list va)"
Helper function to print on stdout for:
.IP "\(bu" 2
\fBhx509_oid_print()\fP,
.IP "\(bu" 2
\fBhx509_bitstring_print()\fP,
.IP "\(bu" 2
\fBhx509_validate_ctx_set_print()\fP\&.
.PP
.PP
\fBParameters\fP
.RS 4
\fIctx\fP the context to the print function\&. If the ctx is NULL, stdout is used\&. 
.br
\fIfmt\fP the printing format\&. 
.br
\fIva\fP the argumet list\&. 
.RE
.PP

.SS "int hx509_validate_cert (hx509_context context, hx509_validate_ctx ctx, hx509_cert cert)"
Validate/Print the status of the certificate\&.
.PP
\fBParameters\fP
.RS 4
\fIcontext\fP A hx509 context\&. 
.br
\fIctx\fP A hx509 validation context\&. 
.br
\fIcert\fP the cerificate to validate/print\&.
.RE
.PP
\fBReturns\fP
.RS 4
An hx509 error code, see \fBhx509_get_error_string()\fP\&. 
.RE
.PP

.SS "void hx509_validate_ctx_add_flags (hx509_validate_ctx ctx, int flags)"
Add flags to control the behaivor of the \fBhx509_validate_cert()\fP function\&.
.PP
\fBParameters\fP
.RS 4
\fIctx\fP A hx509 validation context\&. 
.br
\fIflags\fP flags to add to the validation context\&.
.RE
.PP
\fBReturns\fP
.RS 4
An hx509 error code, see \fBhx509_get_error_string()\fP\&. 
.RE
.PP

.SS "void hx509_validate_ctx_free (hx509_validate_ctx ctx)"
Free an hx509 validate context\&.
.PP
\fBParameters\fP
.RS 4
\fIctx\fP the hx509 validate context to free\&. 
.RE
.PP

.SS "int hx509_validate_ctx_init (hx509_context context, hx509_validate_ctx * ctx)"
Allocate a hx509 validation/printing context\&.
.PP
\fBParameters\fP
.RS 4
\fIcontext\fP A hx509 context\&. 
.br
\fIctx\fP a new allocated hx509 validation context, free with \fBhx509_validate_ctx_free()\fP\&.
.RE
.PP
\fBReturns\fP
.RS 4
An hx509 error code, see \fBhx509_get_error_string()\fP\&. 
.RE
.PP

.SS "void hx509_validate_ctx_set_print (hx509_validate_ctx ctx, hx509_vprint_func func, void * c)"
Set the printing functions for the validation context\&.
.PP
\fBParameters\fP
.RS 4
\fIctx\fP a hx509 valication context\&. 
.br
\fIfunc\fP the printing function to usea\&. 
.br
\fIc\fP the context variable to the printing function\&.
.RE
.PP
\fBReturns\fP
.RS 4
An hx509 error code, see \fBhx509_get_error_string()\fP\&. 
.RE
.PP

.SH "Author"
.PP 
Generated automatically by Doxygen for Heimdal x509 library from the source code\&.