-</code></pre></div><h2 id=description>DESCRIPTION<a class=headerlink href=#description title="Permanent link">¶</a></h2><p>X509_add_cert() adds a certificate <em>cert</em> to the given list <em>sk</em>.</p><p>X509_add_certs() adds a list of certificate <em>certs</em> to the given list <em>sk</em>. The <em>certs</em> argument may be NULL, which implies no effect. It does not modify the list <em>certs</em> but in case the <strong>X509_ADD_FLAG_UP_REF</strong> flag (described below) is set the reference counters of those of its members added to <em>sk</em> are increased.</p><p>Both these functions have a <em>flags</em> parameter, which is used to control details of the operation.</p><p>The value <strong>X509_ADD_FLAG_DEFAULT</strong>, which equals 0, means no special semantics.</p><p>If <strong>X509_ADD_FLAG_UP_REF</strong> is set then the reference counts of those certificates added successfully are increased.</p><p>If <strong>X509_ADD_FLAG_PREPEND</strong> is set then the certificates are prepended to <em>sk</em>. By default they are appended to <em>sk</em>. In both cases the original order of the added certificates is preserved.</p><p>If <strong>X509_ADD_FLAG_NO_DUP</strong> is set then certificates already contained in <em>sk</em>, which is determined using <a href=../X509_cmp/ >X509_cmp(3)</a>, are ignored.</p><p>If <strong>X509_ADD_FLAG_NO_SS</strong> is set then certificates that are marked self-signed, which is determined using <a href=../X509_verify/ >X509_self_signed(3)</a>, are ignored.</p><h2 id=return-values>RETURN VALUES<a class=headerlink href=#return-values title="Permanent link">¶</a></h2><p>Both functions return 1 for success and 0 for failure.</p><h2 id=notes>NOTES<a class=headerlink href=#notes title="Permanent link">¶</a></h2><p>If X509_add_certs() is used with the flags <strong>X509_ADD_FLAG_NO_DUP</strong> or <strong>X509_ADD_FLAG_NO_SS</strong> it is advisable to use also <strong>X509_ADD_FLAG_UP_REF</strong> because otherwise likely not for all members of the <em>certs</em> list the ownership is transferred to the list of certificates <em>sk</em>.</p><p>Care should also be taken in case the <em>certs</em> argument equals <em>sk</em>.</p><h2 id=see-also>SEE ALSO<a class=headerlink href=#see-also title="Permanent link">¶</a></h2><p><a href=../X509_cmp/ >X509_cmp(3)</a><a href=../X509_verify/ >X509_self_signed(3)</a></p><h2 id=history>HISTORY<a class=headerlink href=#history title="Permanent link">¶</a></h2><p>The functions X509_add_cert() and X509_add_certs() were added in OpenSSL 3.0.</p><h2 id=copyright>COPYRIGHT<a class=headerlink href=#copyright title="Permanent link">¶</a></h2><p>Copyright 2019-2022 The OpenSSL Project Authors. All Rights Reserved.</p><p>Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <a href=https://www.openssl.org/source/license.html>https://www.openssl.org/source/license.html</a>.</p></article></div><script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script></div></main><footer class=md-footer><div class="md-footer-meta md-typeset"><div class="md-footer-meta__inner md-grid"><div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a></div></div></div></footer></div><div class=md-dialog data-md-component=dialog><div class="md-dialog__inner md-typeset"></div></div><script id=__config type=application/json>{"base": "../..", "features": ["navigation.indexes", "navigation.instant", "navigation.path", "navigation.prune", "navigation.tabs", "navigation.tabs.sticky", "navigation.tracking", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "master", "provider": "mike"}}</script><script src=../../assets/javascripts/bundle.ad660dcc.min.js></script></body></html>
0 commit comments