lib/libssl/man/SSL_dup_CA_list.3

   1 .\"     $OpenBSD: SSL_dup_CA_list.3,v 1.2 2016/12/14 16:20:28 schwarze Exp $
   2 .\"
   3 .\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
   4 .\"
   5 .\" Permission to use, copy, modify, and distribute this software for any
   6 .\" purpose with or without fee is hereby granted, provided that the above
   7 .\" copyright notice and this permission notice appear in all copies.
   8 .\"
   9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16 .\"
  17 .Dd $Mdocdate: December 14 2016 $
  18 .Dt SSL_DUP_CA_LIST 3
  19 .Os
  20 .Sh NAME
  21 .Nm SSL_dup_CA_list
  22 .Nd deep copy of a stack of X.509 Name objects
  23 .\" The capital "N" in "Name" is intentional (X.509 syntax).
  24 .Sh SYNOPSIS
  25 .Ft STACK_OF(X509_NAME) *
  26 .Fo SSL_dup_CA_list
  27 .Fa "STACK_OF(X509_NAME) *sk"
  28 .Fc
  29 .Sh DESCRIPTION
  30 .Fn SSL_dup_CA_list
  31 constructs a new
  32 .Vt STACK_OF(X509_NAME)
  33 object and places copies of all the
  34 .Vt X509_NAME
  35 objects found on
  36 .Fa sk
  37 on it.
  38 .Sh RETURN VALUES
  39 .Fn SSL_dup_CA_list
  40 returns the new
  41 .Vt STACK_OF(X509_NAME)
  42 or
  43 .Dv NULL
  44 on failure.
  45 .Sh SEE ALSO
  46 .Xr SSL_CTX_set_client_CA_list 3 ,
  47 .Xr SSL_get_client_CA_list 3 ,
  48 .Xr SSL_load_client_CA_file 3 ,
  49 .Xr X509_NAME_new 3
  50 .Sh HISTORY
  51 .Fn SSL_dup_CA_list
  52 is available in all versions of OpenSSL.