From: tb Date: Sat, 16 Dec 2023 10:26:10 +0000 (+0000) Subject: Rename ASN1_STRING_TABLE_add manual to _get X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=8a093c8c3a9b6330735389783a0fd5a3bef654b8;p=openbsd Rename ASN1_STRING_TABLE_add manual to _get --- diff --git a/lib/libcrypto/man/ASN1_STRING_TABLE_add.3 b/lib/libcrypto/man/ASN1_STRING_TABLE_add.3 deleted file mode 100644 index af5e810a392..00000000000 --- a/lib/libcrypto/man/ASN1_STRING_TABLE_add.3 +++ /dev/null @@ -1,85 +0,0 @@ -.\" $OpenBSD: ASN1_STRING_TABLE_add.3,v 1.10 2023/12/16 10:22:56 tb Exp $ -.\" checked up to: -.\" OpenSSL ASN1_STRING_TABLE_add.pod 7b608d08 Jul 27 01:18:50 2017 +0800 -.\" -.\" Copyright (c) 2017, 2021 Ingo Schwarze -.\" -.\" Permission to use, copy, modify, and distribute this software for any -.\" purpose with or without fee is hereby granted, provided that the above -.\" copyright notice and this permission notice appear in all copies. -.\" -.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES -.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF -.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR -.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES -.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN -.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF -.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -.\" -.Dd $Mdocdate: December 16 2023 $ -.Dt ASN1_STRING_TABLE_GET 3 -.Os -.Sh NAME -.Nm ASN1_STRING_TABLE_get -.Nd retrieve an entry from the global ASN.1 string table -.Sh SYNOPSIS -.In openssl/asn1.h -.Ft ASN1_STRING_TABLE * -.Fo ASN1_STRING_TABLE_get -.Fa "int nid" -.Fc -.Sh DESCRIPTION -The ASN.1 string table is a unique global object. -Each entry is of the type -.Vt ASN1_STRING_TABLE -and contains information about one NID object. -The entries are predefined according to RFC 5280 appendix A.1. -.Pp -The upper bounds for the number of characters in various kinds of -.Vt ASN1_STRING -objects are: -.Pp -.Bl -column -compact NID_organizationalUnitNa maxsi ub_organization_unit_na -.It object type Ta maxsize Ta symbolic constant -.It Dv NID_commonName Ta 64 Ta Dv ub_common_name -.It Dv NID_countryName Ta 2 Ta \(em -.It Dv NID_givenName Ta 32768 Ta Dv ub_name -.It Dv NID_initials Ta 32768 Ta Dv ub_name -.It Dv NID_localityName Ta 128 Ta Dv ub_locality_name -.It Dv NID_name Ta 32768 Ta Dv ub_name -.It Dv NID_organizationName Ta 64 Ta Dv ub_organization_name -.It Dv NID_organizationalUnitName Ta 64 Ta Dv ub_organization_unit_name -.It Dv NID_pkcs9_emailAddress Ta 128 Ta Dv ub_email_address -.It Dv NID_serialNumber Ta 64 Ta Dv ub_serial_number -.It Dv NID_stateOrProvinceName Ta 128 Ta Dv ub_state_name -.It Dv NID_surname Ta 32768 Ta Dv ub_name -.El -.Pp -The function -.Fn ASN1_STRING_TABLE_get -retrieves the entry for -.Fa nid . -If the -.Dv STABLE_NO_MASK -flag is set, -.Xr ASN1_STRING_set_by_NID 3 -skips applying the global mask that can be set with -.Xr ASN1_STRING_set_default_mask 3 . -.Sh RETURN VALUES -.Fn ASN1_STRING_TABLE_get -returns a valid -.Vt ASN1_STRING_TABLE -structure or -.Dv NULL -if nothing is found. -.Sh SEE ALSO -.Xr ASN1_OBJECT_new 3 , -.Xr ASN1_STRING_set_by_NID 3 , -.Xr OBJ_create 3 , -.Xr OBJ_nid2obj 3 -.Sh HISTORY -.Fn ASN1_STRING_TABLE_get -first appeared in OpenSSL 0.9.5 and have been available since -.Ox 2.7 . -.Sh BUGS -Most aspects of the semantics considerably differ from OpenSSL. diff --git a/lib/libcrypto/man/ASN1_STRING_TABLE_get.3 b/lib/libcrypto/man/ASN1_STRING_TABLE_get.3 new file mode 100644 index 00000000000..0fcc8a123de --- /dev/null +++ b/lib/libcrypto/man/ASN1_STRING_TABLE_get.3 @@ -0,0 +1,85 @@ +.\" $OpenBSD: ASN1_STRING_TABLE_get.3,v 1.1 2023/12/16 10:26:10 tb Exp $ +.\" checked up to: +.\" OpenSSL ASN1_STRING_TABLE_add.pod 7b608d08 Jul 27 01:18:50 2017 +0800 +.\" +.\" Copyright (c) 2017, 2021 Ingo Schwarze +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.Dd $Mdocdate: December 16 2023 $ +.Dt ASN1_STRING_TABLE_GET 3 +.Os +.Sh NAME +.Nm ASN1_STRING_TABLE_get +.Nd retrieve an entry from the global ASN.1 string table +.Sh SYNOPSIS +.In openssl/asn1.h +.Ft ASN1_STRING_TABLE * +.Fo ASN1_STRING_TABLE_get +.Fa "int nid" +.Fc +.Sh DESCRIPTION +The ASN.1 string table is a unique global object. +Each entry is of the type +.Vt ASN1_STRING_TABLE +and contains information about one NID object. +The entries are predefined according to RFC 5280 appendix A.1. +.Pp +The upper bounds for the number of characters in various kinds of +.Vt ASN1_STRING +objects are: +.Pp +.Bl -column -compact NID_organizationalUnitNa maxsi ub_organization_unit_na +.It object type Ta maxsize Ta symbolic constant +.It Dv NID_commonName Ta 64 Ta Dv ub_common_name +.It Dv NID_countryName Ta 2 Ta \(em +.It Dv NID_givenName Ta 32768 Ta Dv ub_name +.It Dv NID_initials Ta 32768 Ta Dv ub_name +.It Dv NID_localityName Ta 128 Ta Dv ub_locality_name +.It Dv NID_name Ta 32768 Ta Dv ub_name +.It Dv NID_organizationName Ta 64 Ta Dv ub_organization_name +.It Dv NID_organizationalUnitName Ta 64 Ta Dv ub_organization_unit_name +.It Dv NID_pkcs9_emailAddress Ta 128 Ta Dv ub_email_address +.It Dv NID_serialNumber Ta 64 Ta Dv ub_serial_number +.It Dv NID_stateOrProvinceName Ta 128 Ta Dv ub_state_name +.It Dv NID_surname Ta 32768 Ta Dv ub_name +.El +.Pp +The function +.Fn ASN1_STRING_TABLE_get +retrieves the entry for +.Fa nid . +If the +.Dv STABLE_NO_MASK +flag is set, +.Xr ASN1_STRING_set_by_NID 3 +skips applying the global mask that can be set with +.Xr ASN1_STRING_set_default_mask 3 . +.Sh RETURN VALUES +.Fn ASN1_STRING_TABLE_get +returns a valid +.Vt ASN1_STRING_TABLE +structure or +.Dv NULL +if nothing is found. +.Sh SEE ALSO +.Xr ASN1_OBJECT_new 3 , +.Xr ASN1_STRING_set_by_NID 3 , +.Xr OBJ_create 3 , +.Xr OBJ_nid2obj 3 +.Sh HISTORY +.Fn ASN1_STRING_TABLE_get +first appeared in OpenSSL 0.9.5 and have been available since +.Ox 2.7 . +.Sh BUGS +Most aspects of the semantics considerably differ from OpenSSL. diff --git a/lib/libcrypto/man/Makefile b/lib/libcrypto/man/Makefile index a5cd8c53d1f..544495207dd 100644 --- a/lib/libcrypto/man/Makefile +++ b/lib/libcrypto/man/Makefile @@ -1,4 +1,4 @@ -# $OpenBSD: Makefile,v 1.278 2023/12/01 10:40:21 schwarze Exp $ +# $OpenBSD: Makefile,v 1.279 2023/12/16 10:26:10 tb Exp $ .include @@ -11,7 +11,7 @@ MAN= \ ASN1_NULL_new.3 \ ASN1_OBJECT_new.3 \ ASN1_PRINTABLE_type.3 \ - ASN1_STRING_TABLE_add.3 \ + ASN1_STRING_TABLE_get.3 \ ASN1_STRING_length.3 \ ASN1_STRING_new.3 \ ASN1_STRING_print_ex.3 \