lib/libcrypto/man/ENGINE_unregister_RSA.3

   1 .\" $OpenBSD: ENGINE_unregister_RSA.3,v 1.3 2018/04/18 03:39:22 schwarze Exp $
   2 .\" content checked up to:
   3 .\" OpenSSL ENGINE_add 1f13ad31 Dec 25 17:50:39 2017 +0800
   4 .\"
   5 .\" Copyright (c) 2018 Ingo Schwarze <schwarze@openbsd.org>
   6 .\"
   7 .\" Permission to use, copy, modify, and distribute this software for any
   8 .\" purpose with or without fee is hereby granted, provided that the above
   9 .\" copyright notice and this permission notice appear in all copies.
  10 .\"
  11 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  12 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  13 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  14 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  15 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  16 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  17 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  18 .\"
  19 .Dd $Mdocdate: April 18 2018 $
  20 .Dt ENGINE_UNREGISTER_RSA 3
  21 .Os
  22 .Sh NAME
  23 .Nm ENGINE_unregister_RSA ,
  24 .Nm ENGINE_unregister_DSA ,
  25 .Nm ENGINE_unregister_ECDH ,
  26 .Nm ENGINE_unregister_ECDSA ,
  27 .Nm ENGINE_unregister_DH ,
  28 .Nm ENGINE_unregister_RAND ,
  29 .Nm ENGINE_unregister_STORE ,
  30 .Nm ENGINE_unregister_ciphers ,
  31 .Nm ENGINE_unregister_digests
  32 .Nd revoke the registration of an ENGINE object
  33 .Sh SYNOPSIS
  34 .In openssl/engine.h
  35 .Ft void
  36 .Fo ENGINE_unregister_RSA
  37 .Fa "ENGINE *e"
  38 .Fc
  39 .Ft void
  40 .Fo ENGINE_unregister_DSA
  41 .Fa "ENGINE *e"
  42 .Fc
  43 .Ft void
  44 .Fo ENGINE_unregister_ECDH
  45 .Fa "ENGINE *e"
  46 .Fc
  47 .Ft void
  48 .Fo ENGINE_unregister_ECDSA
  49 .Fa "ENGINE *e"
  50 .Fc
  51 .Ft void
  52 .Fo ENGINE_unregister_DH
  53 .Fa "ENGINE *e"
  54 .Fc
  55 .Ft void
  56 .Fo ENGINE_unregister_RAND
  57 .Fa "ENGINE *e"
  58 .Fc
  59 .Ft void
  60 .Fo ENGINE_unregister_STORE
  61 .Fa "ENGINE *e"
  62 .Fc
  63 .Ft void
  64 .Fo ENGINE_unregister_ciphers
  65 .Fa "ENGINE *e"
  66 .Fc
  67 .Ft void
  68 .Fo ENGINE_unregister_digests
  69 .Fa "ENGINE *e"
  70 .Fc
  71 .Sh DESCRIPTION
  72 These functions remove
  73 .Fa e
  74 from the list of
  75 .Vt ENGINE
  76 objects that were previously registered for the respective algorithm
  77 with the functions described in
  78 .Xr ENGINE_register_RSA 3 .
  79 .Pp
  80 If
  81 .Fa e
  82 is currently used as the default engine for the algorithm
  83 as described in the
  84 .Fn ENGINE_set_default 3
  85 and
  86 .Fn ENGINE_get_default_RSA 3
  87 manual pages,
  88 .Xr ENGINE_finish 3
  89 is also called.
  90 .Pp
  91 .Fn ENGINE_unregister_ciphers
  92 and
  93 .Fn ENGINE_unregister_digests
  94 unregister
  95 .Fa e
  96 for all ciphers or digests, respectively.
  97 .Sh SEE ALSO
  98 .Xr ENGINE_cleanup 3 ,
  99 .Xr ENGINE_finish 3 ,
 100 .Xr ENGINE_new 3 ,
 101 .Xr ENGINE_register_RSA 3 ,
 102 .Xr ENGINE_set_default 3
 103 .Sh HISTORY
 104 .Fn ENGINE_unregister_RSA ,
 105 .Fn ENGINE_unregister_DSA ,
 106 .Fn ENGINE_unregister_DH ,
 107 .Fn ENGINE_unregister_RAND ,
 108 .Fn ENGINE_unregister_ciphers ,
 109 and
 110 .Fn ENGINE_unregister_digests
 111 first appeared in OpenSSL 0.9.7 and have been available since
 112 .Ox 3.2 .
 113 .Pp
 114 .Fn ENGINE_unregister_ECDH ,
 115 .Fn ENGINE_unregister_ECDSA ,
 116 and
 117 .Fn ENGINE_unregister_STORE
 118 first appeared in OpenSSL 0.9.8 and have been available since
 119 .Ox 4.5 .