lib/libcrypto/man/d2i_ESS_SIGNING_CERT.3

   1 .\"     $OpenBSD: d2i_ESS_SIGNING_CERT.3,v 1.1 2016/12/27 20:56:18 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 27 2016 $
  18 .Dt D2I_ESS_SIGNING_CERT 3
  19 .Os
  20 .Sh NAME
  21 .Nm d2i_ESS_SIGNING_CERT ,
  22 .Nm i2d_ESS_SIGNING_CERT ,
  23 .Nm d2i_ESS_CERT_ID ,
  24 .Nm i2d_ESS_CERT_ID ,
  25 .Nm d2i_ESS_ISSUER_SERIAL ,
  26 .Nm i2d_ESS_ISSUER_SERIAL
  27 .Nd decode and encode signing certificates for S/MIME
  28 .Sh SYNOPSIS
  29 .In openssl/ts.h
  30 .Ft ESS_SIGNING_CERT *
  31 .Fo d2i_ESS_SIGNING_CERT
  32 .Fa "ESS_SIGNING_CERT **val_out"
  33 .Fa "const unsigned char **der_in"
  34 .Fa "long length"
  35 .Fc
  36 .Ft int
  37 .Fo i2d_ESS_SIGNING_CERT
  38 .Fa "const ESS_SIGNING_CERT *val_in"
  39 .Fa "unsigned char **der_out"
  40 .Fc
  41 .Ft ESS_CERT_ID *
  42 .Fo d2i_ESS_CERT_ID
  43 .Fa "ESS_CERT_ID **val_out"
  44 .Fa "const unsigned char **der_in"
  45 .Fa "long length"
  46 .Fc
  47 .Ft int
  48 .Fo i2d_ESS_CERT_ID
  49 .Fa "const ESS_CERT_ID *val_in"
  50 .Fa "unsigned char **der_out"
  51 .Fc
  52 .Ft ESS_ISSUER_SERIAL *
  53 .Fo d2i_ESS_ISSUER_SERIAL
  54 .Fa "ESS_ISSUER_SERIAL **val_out"
  55 .Fa "const unsigned char **der_in"
  56 .Fa "long length"
  57 .Fc
  58 .Ft int
  59 .Fo i2d_ESS_ISSUER_SERIAL
  60 .Fa "const ESS_ISSUER_SERIAL *val_in"
  61 .Fa "unsigned char **der_out"
  62 .Fc
  63 .Sh DESCRIPTION
  64 These functions decode and encode signing certificate attribute
  65 structures.
  66 For details about the semantics, examples, caveats, and bugs, see
  67 .Xr ASN1_item_d2i 3 .
  68 .Pp
  69 .Fn d2i_ESS_SIGNING_CERT
  70 and
  71 .Fn i2d_ESS_SIGNING_CERT
  72 decode and encode an ASN.1
  73 .Vt SigningCertificate
  74 structure defined in RFC 2634 section 5.4.
  75 .Pp
  76 .Fn d2i_ESS_CERT_ID
  77 and
  78 .Fn i2d_ESS_CERT_ID
  79 decode and encode an ASN.1
  80 .Vt ESSCertID
  81 structure defined in RFC 2634 section 5.4.1.
  82 .Pp
  83 .Fn d2i_ESS_ISSUER_SERIAL
  84 and
  85 .Fn i2d_ESS_ISSUER_SERIAL
  86 decode and encode an ASN.1
  87 .Vt IssuerSerial
  88 structure defined in RFC 2634 section 5.4.1.
  89 .Sh RETURN VALUES
  90 .Fn d2i_ESS_SIGNING_CERT ,
  91 .Fn d2i_ESS_CERT_ID ,
  92 and
  93 .Fn d2i_ESS_ISSUER_SERIAL
  94 return an
  95 .Vt ESS_SIGNING_CERT ,
  96 .Vt ESS_CERT_ID ,
  97 or
  98 .Vt ESS_ISSUER_SERIAL
  99 object, respectively, or
 100 .Dv NULL
 101 if an error occurs.
 102 .Pp
 103 .Fn i2d_ESS_SIGNING_CERT ,
 104 .Fn i2d_ESS_CERT_ID ,
 105 and
 106 .Fn i2d_ESS_ISSUER_SERIAL
 107 return the number of bytes successfully encoded or a negative value
 108 if an error occurs.
 109 .Sh SEE ALSO
 110 .Xr ASN1_item_d2i 3 ,
 111 .Xr ESS_SIGNING_CERT_new 3
 112 .Sh STANDARDS
 113 RFC 2634: Enhanced Security Services for S/MIME,
 114 section 5: Signing Certificate Attribute