From 4b203882b9e2d71d369ac40ae0df3ebc624d8cae Mon Sep 17 00:00:00 2001
From: tb <>
Date: Sat, 16 May 2026 06:17:05 +0000
Subject: ASN1{,_parse}_dump: document return value 2 on EOC

Prompted by a report by N. Dossche

ok kenjiro
---
 src/lib/libcrypto/man/ASN1_parse_dump.3 | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

(limited to 'src')

diff --git a/src/lib/libcrypto/man/ASN1_parse_dump.3 b/src/lib/libcrypto/man/ASN1_parse_dump.3
index 45aa673d4c..809bf01337 100644
--- a/src/lib/libcrypto/man/ASN1_parse_dump.3
+++ b/src/lib/libcrypto/man/ASN1_parse_dump.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ASN1_parse_dump.3,v 1.4 2025/06/08 22:40:29 schwarze Exp $
+.\" $OpenBSD: ASN1_parse_dump.3,v 1.5 2026/05/16 06:17:05 tb Exp $
 .\"
 .\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: June 8 2025 $
+.Dd $Mdocdate: May 16 2026 $
 .Dt ASN1_PARSE_DUMP 3
 .Os
 .Sh NAME
@@ -180,7 +180,11 @@ with 0 passed as the
 .Fa dump
 argument.
 .Sh RETURN VALUES
-These functions return 1 for success or 0 for failure.
+These functions normally return 1 for success or 0 for failure;
+when printing indefinite-length encoded BER with a tag of class
+.Dv V_ASN1_UNIVERSAL ,
+the return value 2 indicates that the printing stopped
+when reaching the end-of-content marker.
 .Pp
 In particular, they print an error message to
 .Fa bio ,
-- 
cgit v1.2.3-55-g6feb