From: schwarze <schwarze@openbsd.org>
Date: Mon, 9 Oct 2023 19:32:51 +0000 (+0000)
Subject: Mention that the strings are OS-specific.
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=d62f3bdc69145384b28a9411533f1dae1c1eb2f9;p=openbsd

Mention that the strings are OS-specific.
In part based on input from deraadt@, OK millert@.
---

diff --git a/lib/libc/gen/uname.3 b/lib/libc/gen/uname.3
index 1c161d7291f..03d2476584a 100644
--- a/lib/libc/gen/uname.3
+++ b/lib/libc/gen/uname.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: uname.3,v 1.18 2022/09/11 06:38:10 jmc Exp $
+.\"	$OpenBSD: uname.3,v 1.19 2023/10/09 19:32:51 schwarze Exp $
 .\"
 .\" Copyright (c) 1994
 .\"	The Regents of the University of California.  All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: September 11 2022 $
+.Dd $Mdocdate: October 9 2023 $
 .Dt UNAME 3
 .Os
 .Sh NAME
@@ -62,6 +62,13 @@ Version level of the operating system.
 .It Fa machine
 Machine hardware platform.
 .El
+.Pp
+These are the same strings that can be displayed with
+.Xr uname 1 .
+Because their format and meaning depends on the operating system,
+trying to parse or interpret them is discouraged in portable code.
+The only reasonable way an application program can use them
+is for displaying them to the user.
 .Sh RETURN VALUES
 The
 .Fn uname