From d684f11da759490a8d98d7b790796106285f4084 Mon Sep 17 00:00:00 2001 From: Hiroki Sato <hrs@FreeBSD.org> Date: Wed, 4 Apr 2018 04:21:19 +0000 Subject: Import Heimdal 7.5.0. --- doc/doxyout/hx509/man/man3/hx509_keyset.3 | 208 +++++++++++++----------------- 1 file changed, 93 insertions(+), 115 deletions(-) (limited to 'doc/doxyout/hx509/man/man3/hx509_keyset.3') diff --git a/doc/doxyout/hx509/man/man3/hx509_keyset.3 b/doc/doxyout/hx509/man/man3/hx509_keyset.3 index 72c3f713d18c..4b8495d9bfbe 100644 --- a/doc/doxyout/hx509/man/man3/hx509_keyset.3 +++ b/doc/doxyout/hx509/man/man3/hx509_keyset.3 @@ -1,8 +1,11 @@ -.TH "hx509 certificate store functions" 3 "11 Jan 2012" "Version 1.5.2" "Heimdalx509library" \" -*- nroff -*- +.TH "hx509_keyset" 3 "Fri Dec 8 2017" "Version 7.5.0" "Heimdalx509library" \" -*- nroff -*- .ad l .nh .SH NAME -hx509 certificate store functions \- +hx509_keyset +.SH SYNOPSIS +.br +.PP .SS "Functions" .in +1c @@ -54,320 +57,295 @@ hx509 certificate store functions \- .in -1c .SH "Detailed Description" .PP -See the \fBCertificate store operations\fP for description and examples. +See the \fBCertificate store operations\fP for description and examples\&. .SH "Function Documentation" .PP .SS "int hx509_certs_add (hx509_context context, hx509_certs certs, hx509_cert cert)" +Add a certificate to the certificiate store\&. .PP -Add a certificate to the certificiate store. -.PP -The receiving keyset certs will either increase reference counter of the cert or make a deep copy, either way, the caller needs to free the cert itself. +The receiving keyset certs will either increase reference counter of the cert or make a deep copy, either way, the caller needs to free the cert itself\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIcerts\fP certificate store to add the certificate to. +\fIcerts\fP certificate store to add the certificate to\&. .br -\fIcert\fP certificate to add. +\fIcert\fP certificate to add\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP .SS "int hx509_certs_append (hx509_context context, hx509_certs to, hx509_lock lock, const char * name)" -.PP -Same a \fBhx509_certs_merge()\fP but use a lock and name to describe the from source. +Same a \fBhx509_certs_merge()\fP but use a lock and name to describe the from source\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIto\fP the store to merge into. +\fIto\fP the store to merge into\&. .br -\fIlock\fP a lock that unlocks the certificates store, use NULL to select no password/certifictes/prompt lock (see \fBLocking and unlocking certificates and encrypted data.\fP). +\fIlock\fP a lock that unlocks the certificates store, use NULL to select no password/certifictes/prompt lock (see \fBLocking and unlocking certificates and encrypted data\&.\fP)\&. .br \fIname\fP name of the source store .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP .SS "int hx509_certs_end_seq (hx509_context context, hx509_certs certs, hx509_cursor cursor)" -.PP -End the iteration over certificates. +End the iteration over certificates\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIcerts\fP certificate store to iterate over. +\fIcerts\fP certificate store to iterate over\&. .br -\fIcursor\fP cursor that will keep track of progress, freed. +\fIcursor\fP cursor that will keep track of progress, freed\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP .SS "int hx509_certs_filter (hx509_context context, hx509_certs certs, const hx509_query * q, hx509_certs * result)" -.PP -Filter certificate matching the query. +Filter certificate matching the query\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIcerts\fP certificate store to search. +\fIcerts\fP certificate store to search\&. .br -\fIq\fP query allocated with \fBhx509 query functions\fP functions. +\fIq\fP query allocated with \fBhx509 query functions\fP functions\&. .br -\fIresult\fP the filtered certificate store, caller must free with \fBhx509_certs_free()\fP. +\fIresult\fP the filtered certificate store, caller must free with \fBhx509_certs_free()\fP\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP - -.PP -Return HX509_CERT_NOT_FOUND if no certificate in certs matched the query. +Return HX509_CERT_NOT_FOUND if no certificate in certs matched the query\&. .SS "int hx509_certs_find (hx509_context context, hx509_certs certs, const hx509_query * q, hx509_cert * r)" -.PP -Find a certificate matching the query. +Find a certificate matching the query\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIcerts\fP certificate store to search. +\fIcerts\fP certificate store to search\&. .br -\fIq\fP query allocated with \fBhx509 query functions\fP functions. +\fIq\fP query allocated with \fBhx509 query functions\fP functions\&. .br -\fIr\fP return certificate (or NULL on error), should be freed with \fBhx509_cert_free()\fP. +\fIr\fP return certificate (or NULL on error), should be freed with \fBhx509_cert_free()\fP\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP - -.PP -Return HX509_CERT_NOT_FOUND if no certificate in certs matched the query. +Return HX509_CERT_NOT_FOUND if no certificate in certs matched the query\&. .SS "void hx509_certs_free (hx509_certs * certs)" -.PP -Free a certificate store. +Free a certificate store\&. .PP \fBParameters:\fP .RS 4 -\fIcerts\fP certificate store to free. +\fIcerts\fP certificate store to free\&. .RE .PP .SS "int hx509_certs_info (hx509_context context, hx509_certs certs, int(*)(void *, const char *) func, void * ctx)" -.PP -Print some info about the certificate store. +Print some info about the certificate store\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIcerts\fP certificate store to print information about. +\fIcerts\fP certificate store to print information about\&. .br -\fIfunc\fP function that will get each line of the information, if NULL is used the data is printed on a FILE descriptor that should be passed in ctx, if ctx also is NULL, stdout is used. +\fIfunc\fP function that will get each line of the information, if NULL is used the data is printed on a FILE descriptor that should be passed in ctx, if ctx also is NULL, stdout is used\&. .br -\fIctx\fP parameter to func. +\fIctx\fP parameter to func\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP .SS "int hx509_certs_init (hx509_context context, const char * name, int flags, hx509_lock lock, hx509_certs * certs)" -.PP -Open or creates a new hx509 certificate store. +Open or creates a new hx509 certificate store\&. .PP \fBParameters:\fP .RS 4 \fIcontext\fP A hx509 context .br -\fIname\fP name of the store, format is TYPE:type-specific-string, if NULL is used the MEMORY store is used. +\fIname\fP name of the store, format is TYPE:type-specific-string, if NULL is used the MEMORY store is used\&. .br \fIflags\fP list of flags: .IP "\(bu" 2 -HX509_CERTS_CREATE create a new keystore of the specific TYPE. +HX509_CERTS_CREATE create a new keystore of the specific TYPE\&. .IP "\(bu" 2 -HX509_CERTS_UNPROTECT_ALL fails if any private key failed to be extracted. +HX509_CERTS_UNPROTECT_ALL fails if any private key failed to be extracted\&. .PP .br -\fIlock\fP a lock that unlocks the certificates store, use NULL to select no password/certifictes/prompt lock (see \fBLocking and unlocking certificates and encrypted data.\fP). +\fIlock\fP a lock that unlocks the certificates store, use NULL to select no password/certifictes/prompt lock (see \fBLocking and unlocking certificates and encrypted data\&.\fP)\&. .br -\fIcerts\fP return pointer, free with \fBhx509_certs_free()\fP. +\fIcerts\fP return pointer, free with \fBhx509_certs_free()\fP\&. +.RE +.PP +\fBReturns:\fP +.RS 4 +Returns an hx509 error code\&. .RE .PP .SS "int hx509_certs_iter_f (hx509_context context, hx509_certs certs, int(*)(hx509_context, void *, hx509_cert) func, void * ctx)" -.PP -Iterate over all certificates in a keystore and call an function for each fo them. +Iterate over all certificates in a keystore and call a function for each of them\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIcerts\fP certificate store to iterate over. +\fIcerts\fP certificate store to iterate over\&. .br -\fIfunc\fP function to call for each certificate. The function should return non-zero to abort the iteration, that value is passed back to the caller of \fBhx509_certs_iter_f()\fP. +\fIfunc\fP function to call for each certificate\&. The function should return non-zero to abort the iteration, that value is passed back to the caller of \fBhx509_certs_iter_f()\fP\&. .br -\fIctx\fP context variable that will passed to the function. +\fIctx\fP context variable that will passed to the function\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP .SS "int hx509_certs_merge (hx509_context context, hx509_certs to, hx509_certs from)" -.PP -Merge a certificate store into another. The from store is keep intact. +Merge a certificate store into another\&. The from store is keep intact\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIto\fP the store to merge into. +\fIto\fP the store to merge into\&. .br -\fIfrom\fP the store to copy the object from. +\fIfrom\fP the store to copy the object from\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP .SS "int hx509_certs_next_cert (hx509_context context, hx509_certs certs, hx509_cursor cursor, hx509_cert * cert)" -.PP -Get next ceritificate from the certificate keystore pointed out by cursor. +Get next ceritificate from the certificate keystore pointed out by cursor\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIcerts\fP certificate store to iterate over. +\fIcerts\fP certificate store to iterate over\&. .br -\fIcursor\fP cursor that keeps track of progress. +\fIcursor\fP cursor that keeps track of progress\&. .br -\fIcert\fP return certificate next in store, NULL if the store contains no more certificates. Free with \fBhx509_cert_free()\fP. +\fIcert\fP return certificate next in store, NULL if the store contains no more certificates\&. Free with \fBhx509_cert_free()\fP\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP .SS "int hx509_certs_start_seq (hx509_context context, hx509_certs certs, hx509_cursor * cursor)" -.PP Start the integration .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br \fIcerts\fP certificate store to iterate over .br -\fIcursor\fP cursor that will keep track of progress, free with \fBhx509_certs_end_seq()\fP. +\fIcursor\fP cursor that will keep track of progress, free with \fBhx509_certs_end_seq()\fP\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. HX509_UNSUPPORTED_OPERATION is returned if the certificate store doesn't support the iteration operation. +Returns an hx509 error code\&. HX509_UNSUPPORTED_OPERATION is returned if the certificate store doesn't support the iteration operation\&. .RE .PP .SS "int hx509_certs_store (hx509_context context, hx509_certs certs, int flags, hx509_lock lock)" -.PP -Write the certificate store to stable storage. +Write the certificate store to stable storage\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP A hx509 context. +\fIcontext\fP A hx509 context\&. .br -\fIcerts\fP a certificate store to store. +\fIcerts\fP a certificate store to store\&. .br -\fIflags\fP currently unused, use 0. +\fIflags\fP currently unused, use 0\&. .br -\fIlock\fP a lock that unlocks the certificates store, use NULL to select no password/certifictes/prompt lock (see \fBLocking and unlocking certificates and encrypted data.\fP). +\fIlock\fP a lock that unlocks the certificates store, use NULL to select no password/certifictes/prompt lock (see \fBLocking and unlocking certificates and encrypted data\&.\fP)\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. HX509_UNSUPPORTED_OPERATION if the certificate store doesn't support the store operation. +Returns an hx509 error code\&. HX509_UNSUPPORTED_OPERATION if the certificate store doesn't support the store operation\&. .RE .PP .SS "int hx509_ci_print_names (hx509_context context, void * ctx, hx509_cert c)" -.PP -Iterate over all certificates in a keystore and call an function for each fo them. -.PP -\fBParameters:\fP -.RS 4 -\fIcontext\fP a hx509 context. -.br -\fIcerts\fP certificate store to iterate over. -.br -\fIfunc\fP function to call for each certificate. The function should return non-zero to abort the iteration, that value is passed back to the caller of hx509_certs_iter(). -.RE -.PP -\fBReturns:\fP -.RS 4 -Returns an hx509 error code. Function to use to \fBhx509_certs_iter_f()\fP as a function argument, the ctx variable to \fBhx509_certs_iter_f()\fP should be a FILE file descriptor. -.RE +Function to use to \fBhx509_certs_iter_f()\fP as a function argument, the ctx variable to \fBhx509_certs_iter_f()\fP should be a FILE file descriptor\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIctx\fP used by \fBhx509_certs_iter_f()\fP. +\fIctx\fP used by \fBhx509_certs_iter_f()\fP\&. .br \fIc\fP a certificate .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP .SS "int hx509_get_one_cert (hx509_context context, hx509_certs certs, hx509_cert * c)" -.PP -Get one random certificate from the certificate store. +Get one random certificate from the certificate store\&. .PP \fBParameters:\fP .RS 4 -\fIcontext\fP a hx509 context. +\fIcontext\fP a hx509 context\&. .br -\fIcerts\fP a certificate store to get the certificate from. +\fIcerts\fP a certificate store to get the certificate from\&. .br -\fIc\fP return certificate, should be freed with \fBhx509_cert_free()\fP. +\fIc\fP return certificate, should be freed with \fBhx509_cert_free()\fP\&. .RE .PP \fBReturns:\fP .RS 4 -Returns an hx509 error code. +Returns an hx509 error code\&. .RE .PP +.SH "Author" +.PP +Generated automatically by Doxygen for Heimdalx509library from the source code\&. -- cgit v1.2.3