From 87394cdd011a57807fe044046476981f2b0142c2 Mon Sep 17 00:00:00 2001
From: Mateusz Piotrowski <0mp@FreeBSD.org>
Date: Thu, 17 Dec 2020 12:41:47 +0000
Subject: [PATCH] strerror.3: Add an example for perror()

This is a nice and quick reference.

Reviewed by:	jilles, yuripv
MFC after:	2 weeks
Differential Revision:	https://reviews.freebsd.org/D27623
---
 lib/libc/string/strerror.3 | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/lib/libc/string/strerror.3 b/lib/libc/string/strerror.3
index 39f49d3007a..3ea4145080c 100644
--- a/lib/libc/string/strerror.3
+++ b/lib/libc/string/strerror.3
@@ -32,7 +32,7 @@
 .\"     @(#)strerror.3	8.1 (Berkeley) 6/9/93
 .\" $FreeBSD$
 .\"
-.Dd December 7, 2020
+.Dd December 17, 2020
 .Dt STRERROR 3
 .Os
 .Sh NAME
@@ -170,6 +170,31 @@ The use of these variables is deprecated;
 or
 .Fn strerror_r
 should be used instead.
+.Sh EXAMPLES
+The following example shows how to use
+.Fn perror
+to report an error.
+.Bd -literal -offset 2n
+#include <fcntl.h>
+#include <stdio.h>
+#include <stdlib.h>
+
+int
+main(void)
+{
+	int fd;
+
+	if ((fd = open("/nonexistent", O_RDONLY)) == -1) {
+		perror("open()");
+		exit(1);
+	}
+        printf("File descriptor: %d\en", fd);
+	return (0);
+}
+.Ed
+.Pp
+When executed, the program will print an error message along the lines of
+.Ql "open(): No such file or directory" .
 .Sh SEE ALSO
 .Xr intro 2 ,
 .Xr err 3 ,
-- 
2.45.0