diff options
| author | tb <> | 2023-07-28 05:48:33 +0000 |
|---|---|---|
| committer | tb <> | 2023-07-28 05:48:33 +0000 |
| commit | cd5a7810f274964f07d89f110cb07feed5bc163e (patch) | |
| tree | 663afe7bc99772837b2f8934613103cbbd34c0d0 /src/lib/libcrypto/man | |
| parent | e20061c65d48ab2376dad6b927a54138ea5a7eb1 (diff) | |
| download | openbsd-cd5a7810f274964f07d89f110cb07feed5bc163e.tar.gz openbsd-cd5a7810f274964f07d89f110cb07feed5bc163e.tar.bz2 openbsd-cd5a7810f274964f07d89f110cb07feed5bc163e.zip | |
Remove ASN1_BIT_STRING_num_asc.3
Diffstat (limited to 'src/lib/libcrypto/man')
| -rw-r--r-- | src/lib/libcrypto/man/ASN1_BIT_STRING_num_asc.3 | 146 | ||||
| -rw-r--r-- | src/lib/libcrypto/man/ASN1_STRING_new.3 | 5 | ||||
| -rw-r--r-- | src/lib/libcrypto/man/Makefile | 3 |
3 files changed, 3 insertions, 151 deletions
diff --git a/src/lib/libcrypto/man/ASN1_BIT_STRING_num_asc.3 b/src/lib/libcrypto/man/ASN1_BIT_STRING_num_asc.3 deleted file mode 100644 index 3891ced8a8..0000000000 --- a/src/lib/libcrypto/man/ASN1_BIT_STRING_num_asc.3 +++ /dev/null | |||
| @@ -1,146 +0,0 @@ | |||
| 1 | .\" $OpenBSD: ASN1_BIT_STRING_num_asc.3,v 1.1 2021/11/19 16:00:54 schwarze Exp $ | ||
| 2 | .\" | ||
| 3 | .\" Copyright (c) 2021 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: November 19 2021 $ | ||
| 18 | .Dt ASN1_BIT_STRING_NUM_ASC 3 | ||
| 19 | .Os | ||
| 20 | .Sh NAME | ||
| 21 | .Nm ASN1_BIT_STRING_num_asc , | ||
| 22 | .Nm ASN1_BIT_STRING_set_asc , | ||
| 23 | .Nm ASN1_BIT_STRING_name_print | ||
| 24 | .Nd names for individual bits | ||
| 25 | .Sh SYNOPSIS | ||
| 26 | .In openssl/asn1.h | ||
| 27 | .Bd -unfilled | ||
| 28 | typedef struct { | ||
| 29 | int bitnum; | ||
| 30 | const char *lname; | ||
| 31 | const char *sname; | ||
| 32 | } BIT_STRING_BITNAME; | ||
| 33 | .Ed | ||
| 34 | .Pp | ||
| 35 | .Ft int | ||
| 36 | .Fo ASN1_BIT_STRING_num_asc | ||
| 37 | .Fa "const char *name" | ||
| 38 | .Fa "BIT_STRING_BITNAME *table" | ||
| 39 | .Fc | ||
| 40 | .Ft int | ||
| 41 | .Fo ASN1_BIT_STRING_set_asc | ||
| 42 | .Fa "ASN1_BIT_STRING *bitstr" | ||
| 43 | .Fa "const char *name" | ||
| 44 | .Fa "int set" | ||
| 45 | .Fa "BIT_STRING_BITNAME *table" | ||
| 46 | .Fc | ||
| 47 | .Ft int | ||
| 48 | .Fo ASN1_BIT_STRING_name_print | ||
| 49 | .Fa "BIO *bio" | ||
| 50 | .Fa "ASN1_BIT_STRING *bitstr" | ||
| 51 | .Fa "BIT_STRING_BITNAME *table" | ||
| 52 | .Fa "int indent" | ||
| 53 | .Fc | ||
| 54 | .Sh DESCRIPTION | ||
| 55 | These functions provide access to individual bits of an ASN.1 BIT STRING | ||
| 56 | based on a | ||
| 57 | .Fa table | ||
| 58 | assigning names to individual bits. | ||
| 59 | The | ||
| 60 | .Fa table | ||
| 61 | is a variable-sized array. | ||
| 62 | Each element contains a long name | ||
| 63 | .Fa lname | ||
| 64 | and a short name | ||
| 65 | .Fa sname | ||
| 66 | for the bit with the bit number | ||
| 67 | .Fa bitnum . | ||
| 68 | The table needs to be terminated with a dummy element containing a | ||
| 69 | .Dv NULL | ||
| 70 | pointer in the | ||
| 71 | .Fa lname | ||
| 72 | field. | ||
| 73 | .Pp | ||
| 74 | .Fn ASN1_BIT_STRING_num_asc | ||
| 75 | retrieves the | ||
| 76 | .Fa bitnum | ||
| 77 | from the first element in the | ||
| 78 | .Fa table | ||
| 79 | where at least one of the names matches the | ||
| 80 | .Fa name | ||
| 81 | argument in the sense of | ||
| 82 | .Xr strcmp 3 . | ||
| 83 | That bit number can then be used for | ||
| 84 | .Xr ASN1_BIT_STRING_get_bit 3 . | ||
| 85 | .Pp | ||
| 86 | .Fn ASN1_BIT_STRING_set_asc | ||
| 87 | converts the | ||
| 88 | .Fa name | ||
| 89 | to a bit number using | ||
| 90 | .Fn ASN1_BIT_STRING_num_asc | ||
| 91 | and sets or clears that bit in | ||
| 92 | .Fa bitstr | ||
| 93 | according to the | ||
| 94 | .Fa set | ||
| 95 | argument, using | ||
| 96 | .Xr ASN1_BIT_STRING_set_bit 3 . | ||
| 97 | If | ||
| 98 | .Fa bitstr | ||
| 99 | is a | ||
| 100 | .Dv NULL | ||
| 101 | pointer, no action occurs. | ||
| 102 | .Pp | ||
| 103 | .Fn ASN1_BIT_STRING_name_print | ||
| 104 | prints a single line of text to the given | ||
| 105 | .Fa BIO . | ||
| 106 | The line starts with | ||
| 107 | .Fa indent | ||
| 108 | space characters, contains the long names of the bit contained in the | ||
| 109 | .Fa table | ||
| 110 | that are set in | ||
| 111 | .Fa bitstr , | ||
| 112 | separated by commas, and ends with a newline character. | ||
| 113 | If any bits are set in | ||
| 114 | .Fa bitstr | ||
| 115 | that have no corresponding entries in the | ||
| 116 | .Fa table , | ||
| 117 | those bits are silently ignored and nothing is printed for them. | ||
| 118 | .Sh RETURN VALUES | ||
| 119 | .Fn ASN1_BIT_STRING_num_asc | ||
| 120 | returns a non-negative bit number or \-1 if the | ||
| 121 | .Fa name | ||
| 122 | is not found in the | ||
| 123 | .Fa table . | ||
| 124 | .Pp | ||
| 125 | .Fn ASN1_BIT_STRING_set_asc | ||
| 126 | returns 1 on success or 0 if the | ||
| 127 | .Fa name | ||
| 128 | is not found in the | ||
| 129 | .Fa table | ||
| 130 | or if memory allocation fails. | ||
| 131 | .Pp | ||
| 132 | .Fn ASN1_BIT_STRING_name_print | ||
| 133 | is intended to return 1 for success or 0 for failure. | ||
| 134 | .Sh SEE ALSO | ||
| 135 | .Xr ASN1_BIT_STRING_new 3 , | ||
| 136 | .Xr ASN1_BIT_STRING_set 3 , | ||
| 137 | .Xr BIO_new 3 , | ||
| 138 | .Xr strcmp 3 | ||
| 139 | .Sh HISTORY | ||
| 140 | These functions first appeared in OpenSSL 0.9.5 | ||
| 141 | and have been available since | ||
| 142 | .Ox 2.7 . | ||
| 143 | .Sh BUGS | ||
| 144 | .Fn ASN1_BIT_STRING_name_print | ||
| 145 | ignores all errors and always returns 1, | ||
| 146 | even if nothing or only part of the desired output was printed. | ||
diff --git a/src/lib/libcrypto/man/ASN1_STRING_new.3 b/src/lib/libcrypto/man/ASN1_STRING_new.3 index d9f5093f33..9500b82df3 100644 --- a/src/lib/libcrypto/man/ASN1_STRING_new.3 +++ b/src/lib/libcrypto/man/ASN1_STRING_new.3 | |||
| @@ -1,4 +1,4 @@ | |||
| 1 | .\" $OpenBSD: ASN1_STRING_new.3,v 1.24 2021/12/14 19:36:18 schwarze Exp $ | 1 | .\" $OpenBSD: ASN1_STRING_new.3,v 1.25 2023/07/28 05:48:33 tb Exp $ |
| 2 | .\" OpenSSL 99d63d46 Tue Mar 24 07:52:24 2015 -0400 | 2 | .\" OpenSSL 99d63d46 Tue Mar 24 07:52:24 2015 -0400 |
| 3 | .\" | 3 | .\" |
| 4 | .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> | 4 | .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> |
| @@ -15,7 +15,7 @@ | |||
| 15 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | 15 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
| 16 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | 16 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
| 17 | .\" | 17 | .\" |
| 18 | .Dd $Mdocdate: December 14 2021 $ | 18 | .Dd $Mdocdate: July 28 2023 $ |
| 19 | .Dt ASN1_STRING_NEW 3 | 19 | .Dt ASN1_STRING_NEW 3 |
| 20 | .Os | 20 | .Os |
| 21 | .Sh NAME | 21 | .Sh NAME |
| @@ -205,7 +205,6 @@ object if successful; otherwise | |||
| 205 | is returned and an error code can be retrieved with | 205 | is returned and an error code can be retrieved with |
| 206 | .Xr ERR_get_error 3 . | 206 | .Xr ERR_get_error 3 . |
| 207 | .Sh SEE ALSO | 207 | .Sh SEE ALSO |
| 208 | .Xr ASN1_BIT_STRING_num_asc 3 , | ||
| 209 | .Xr ASN1_BIT_STRING_set 3 , | 208 | .Xr ASN1_BIT_STRING_set 3 , |
| 210 | .Xr ASN1_INTEGER_get 3 , | 209 | .Xr ASN1_INTEGER_get 3 , |
| 211 | .Xr ASN1_item_pack 3 , | 210 | .Xr ASN1_item_pack 3 , |
diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile index 1697357f62..23e48a9877 100644 --- a/src/lib/libcrypto/man/Makefile +++ b/src/lib/libcrypto/man/Makefile | |||
| @@ -1,11 +1,10 @@ | |||
| 1 | # $OpenBSD: Makefile,v 1.258 2023/07/26 20:08:59 tb Exp $ | 1 | # $OpenBSD: Makefile,v 1.259 2023/07/28 05:48:33 tb Exp $ |
| 2 | 2 | ||
| 3 | .include <bsd.own.mk> | 3 | .include <bsd.own.mk> |
| 4 | 4 | ||
| 5 | MAN= \ | 5 | MAN= \ |
| 6 | ACCESS_DESCRIPTION_new.3 \ | 6 | ACCESS_DESCRIPTION_new.3 \ |
| 7 | AES_encrypt.3 \ | 7 | AES_encrypt.3 \ |
| 8 | ASN1_BIT_STRING_num_asc.3 \ | ||
| 9 | ASN1_BIT_STRING_set.3 \ | 8 | ASN1_BIT_STRING_set.3 \ |
| 10 | ASN1_INTEGER_get.3 \ | 9 | ASN1_INTEGER_get.3 \ |
| 11 | ASN1_NULL_new.3 \ | 10 | ASN1_NULL_new.3 \ |
