summaryrefslogtreecommitdiffstats
path: root/doc/internal
diff options
context:
space:
mode:
authorslontis <shane.lontis@oracle.com>2023-01-31 10:50:22 +1000
committerTomas Mraz <tomas@openssl.org>2023-02-08 16:17:37 +0100
commit23e65561e28f705f8f59128470aaf89bdbdb84fa (patch)
tree95611ad9a10999cb84cd443174b6392ce52b8aad /doc/internal
parent2b9e2afc382490592078cdb69d06f54f0fefd4c6 (diff)
Add more punycode tests and remove ossl_a2ucompare()
The unused and untested internal function ossl_a2ucompare() has been removed. Reviewed-by: Paul Dale <pauli@openssl.org> Reviewed-by: Dmitry Belyavskiy <beldmit@gmail.com> (Merged from https://github.com/openssl/openssl/pull/20177)
Diffstat (limited to 'doc/internal')
-rw-r--r--doc/internal/man3/ossl_punycode_decode.pod10
1 files changed, 1 insertions, 9 deletions
diff --git a/doc/internal/man3/ossl_punycode_decode.pod b/doc/internal/man3/ossl_punycode_decode.pod
index 8c9484889b..7a20864bcd 100644
--- a/doc/internal/man3/ossl_punycode_decode.pod
+++ b/doc/internal/man3/ossl_punycode_decode.pod
@@ -2,7 +2,7 @@
=head1 NAME
-ossl_punycode_decode, ossl_a2ulabel, ossl_a2ucompare
+ossl_punycode_decode, ossl_a2ulabel
- internal punycode-related functions
=head1 SYNOPSIS
@@ -14,8 +14,6 @@ ossl_punycode_decode, ossl_a2ulabel, ossl_a2ucompare
int ossl_a2ulabel(const char *in, char *out, size_t outlen);
- int ossl_a2ucompare(const char *a, const char *u);
-
=head1 DESCRIPTION
PUNYCODE encoding introduced in RFCs 3490-3492 is widely used for
@@ -25,9 +23,6 @@ such as RFC 8398, require comparison of hostnames encoded in UTF-8 charset.
ossl_a2ulabel() decodes NUL-terminated hostname from PUNYCODE to UTF-8,
using a provided buffer for output. The output buffer is NUL-terminated.
-ossl_a2ucompare() accepts two NUL-terminated hostnames, decodes the 1st
-from PUNYCODE to UTF-8 and compares it with the 2nd one as is.
-
ossl_punycode_decode() decodes one label (one dot-separated part) from
a hostname, with stripped PUNYCODE marker I<xn-->.
@@ -36,9 +31,6 @@ a hostname, with stripped PUNYCODE marker I<xn-->.
ossl_a2ulabel() returns 1 on success, 0 if the output buffer is too small and
-1 if an invalid PUNYCODE string is passed or another error occurs.
-ossl_a2ucompare() returns 1 on non-equal strings, 0 on equal strings,
--1 when an invalid PUNYCODE string is passed or another error occurs.
-
ossl_punycode_decode() returns 1 on success, 0 on error. On success,
*pout_length contains the number of codepoints decoded.