diff options
author | Nikos Mavrogiannopoulos <nmav@gnutls.org> | 2012-12-03 20:35:22 +0100 |
---|---|---|
committer | Nikos Mavrogiannopoulos <nmav@gnutls.org> | 2012-12-03 20:35:22 +0100 |
commit | f97082d162912524d417239b2b143fb52430cf7d (patch) | |
tree | 2f5a471582b36230daf210e1c3b4a545b39acb53 /manual/html_node/Importing-an-X_002e509-certificate.html | |
download | gnutls-f97082d162912524d417239b2b143fb52430cf7d.tar.gz |
added web
Diffstat (limited to 'manual/html_node/Importing-an-X_002e509-certificate.html')
-rw-r--r-- | manual/html_node/Importing-an-X_002e509-certificate.html | 191 |
1 files changed, 191 insertions, 0 deletions
diff --git a/manual/html_node/Importing-an-X_002e509-certificate.html b/manual/html_node/Importing-an-X_002e509-certificate.html new file mode 100644 index 0000000000..b367414e59 --- /dev/null +++ b/manual/html_node/Importing-an-X_002e509-certificate.html @@ -0,0 +1,191 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- This manual is last updated 17 November 2012 for version +3.1.5 of GnuTLS. + +Copyright (C) 2001-2012 Free Software Foundation, Inc. + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 or +any later version published by the Free Software Foundation; with no +Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A +copy of the license is included in the section entitled "GNU Free +Documentation License". --> +<!-- Created by GNU Texinfo 4.13.90, http://www.gnu.org/software/texinfo/ --> +<head> +<title>GnuTLS 3.1.5: Importing an X.509 certificate</title> + +<meta name="description" content="GnuTLS 3.1.5: Importing an X.509 certificate"> +<meta name="keywords" content="GnuTLS 3.1.5: Importing an X.509 certificate"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<link href="index.html#Top" rel="start" title="Top"> +<link href="Function-and-Data-Index.html#Function-and-Data-Index" rel="index" title="Function and Data Index"> +<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> +<link href="X_002e509-certificates.html#X_002e509-certificates" rel="up" title="X.509 certificates"> +<link href="X_002e509-distinguished-names.html#X_002e509-distinguished-names" rel="next" title="X.509 distinguished names"> +<link href="X_002e509-certificate-structure.html#X_002e509-certificate-structure" rel="previous" title="X.509 certificate structure"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.indentedblock {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smallindentedblock {margin-left: 3.2em; font-size: smaller} +div.smalllisp {margin-left: 3.2em} +kbd {font-style:oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +pre.smalldisplay {font-family: inherit; font-size: smaller} +pre.smallexample {font-size: smaller} +pre.smallformat {font-family: inherit; font-size: smaller} +pre.smalllisp {font-size: smaller} +span.nocodebreak {white-space:nowrap} +span.nolinebreak {white-space:nowrap} +span.roman {font-family:serif; font-weight:normal} +span.sansserif {font-family:sans-serif; font-weight:normal} +ul.no-bullet {list-style: none} +body { + margin: 2%; + padding: 0 5%; + background: #ffffff; +} +h1,h2,h3,h4,h5 { + font-weight: bold; + padding: 5px 5px 5px 5px; + background-color: #c2e0ff; + color: #336699; +} +h1 { + padding: 2em 2em 2em 5%; + color: white; + background: #336699; + text-align: center; + letter-spacing: 3px; +} +h2 { text-decoration: underline; } +pre { + margin: 0 5%; + padding: 0.5em; +} +pre.example,pre.verbatim { + padding-bottom: 1em; + + border: solid #c2e0ff; + background: #f0faff; + border-width: 1px 1px 1px 5px; + margin: 1em auto; + width: 90%; +} + +div.node { + margin: 0 -5% 0 -2%; + padding: 0.5em 0.5em; + margin-top: 0.5em; + margin-bottom: 0.5em; + font-weight: bold; +} +dd, li { + padding-top: 0.1em; + padding-bottom: 0.1em; +} +div.float { + + margin-bottom: 0.5em; + text-align: center; +} + +table { + text-align: left; + margin-left:auto; + margin-right:auto; + width: 50%; +} + +th { + padding: 0; + color: #336699; + background-color: #c2e0ff; + border: solid #000000; + border-width: 0px; + margin: 1em auto; + text-align: center; + margin-left:auto; + margin-right:auto; +} + +td { + padding: 0; + border: solid #000000; + background-color: #f0faff; + border-width: 0px; + margin: 1em auto; + text-align: left; + margin-left:auto; + margin-right:auto; + padding-left: 1em; +} + +dl { + text-align: left; + margin-left:auto; + margin-right:auto; + width: 50%; + + padding-left: 1em; + border: solid #c2e0ff; + background: #f0faff; + border-width: 5px 1px 1px 1px; + margin: 1em auto; +} + +--> +</style> + + +</head> + +<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> +<a name="Importing-an-X_002e509-certificate"></a> +<div class="header"> +<p> +Next: <a href="X_002e509-distinguished-names.html#X_002e509-distinguished-names" accesskey="n" rel="next">X.509 distinguished names</a>, Previous: <a href="X_002e509-certificate-structure.html#X_002e509-certificate-structure" accesskey="p" rel="previous">X.509 certificate structure</a>, Up: <a href="X_002e509-certificates.html#X_002e509-certificates" accesskey="u" rel="up">X.509 certificates</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-and-Data-Index.html#Function-and-Data-Index" title="Index" rel="index">Index</a>]</p> +</div> +<hr> +<a name="Importing-an-X_002e509-certificate-1"></a> +<h4 class="subsection">4.1.2 Importing an X.509 certificate</h4> + +<p>The certificate structure should be initialized using <a href="X509-certificate-API.html#gnutls_005fx509_005fcrt_005finit">gnutls_x509_crt_init</a>, and +a certificate structure can be imported using <a href="X509-certificate-API.html#gnutls_005fx509_005fcrt_005fimport">gnutls_x509_crt_import</a>. +</p> +<dl compact="compact"> +<dt><code><var>int</var> <a href="X509-certificate-API.html#gnutls_005fx509_005fcrt_005finit">gnutls_x509_crt_init</a> (gnutls_x509_crt_t * <var>cert</var>)</code></dt> +<dt><code><var>int</var> <a href="X509-certificate-API.html#gnutls_005fx509_005fcrt_005fimport">gnutls_x509_crt_import</a> (gnutls_x509_crt_t <var>cert</var>, const gnutls_datum_t * <var>data</var>, gnutls_x509_crt_fmt_t <var>format</var>)</code></dt> +<dt><code><var>void</var> <a href="X509-certificate-API.html#gnutls_005fx509_005fcrt_005fdeinit">gnutls_x509_crt_deinit</a> (gnutls_x509_crt_t <var>cert</var>)</code></dt> +</dl> + +<p>In several functions an array of certificates is required. To assist in initialization +and import the following two functions are provided. +</p> +<dl compact="compact"> +<dt><code><var>int</var> <a href="X509-certificate-API.html#gnutls_005fx509_005fcrt_005flist_005fimport">gnutls_x509_crt_list_import</a> (gnutls_x509_crt_t * <var>certs</var>, unsigned int * <var>cert_max</var>, const gnutls_datum_t * <var>data</var>, gnutls_x509_crt_fmt_t <var>format</var>, unsigned int <var>flags</var>)</code></dt> +<dt><code><var>int</var> <a href="X509-certificate-API.html#gnutls_005fx509_005fcrt_005flist_005fimport2">gnutls_x509_crt_list_import2</a> (gnutls_x509_crt_t ** <var>certs</var>, unsigned int * <var>size</var>, const gnutls_datum_t * <var>data</var>, gnutls_x509_crt_fmt_t <var>format</var>, unsigned int <var>flags</var>)</code></dt> +</dl> + +<p>In all cases after use a certificate must be deinitialized using <a href="X509-certificate-API.html#gnutls_005fx509_005fcrt_005fdeinit">gnutls_x509_crt_deinit</a>. +Note that although the functions above apply to <code>gnutls_x509_crt_t</code> structure, similar functions +exist for the CRL structure <code>gnutls_x509_crl_t</code>. +</p> + + + +</body> +</html> |