svn commit: r331148 - stable/11/usr.bin/uname

[Eitan Adler]

Author: eadler
Date: Sun Mar 18 22:24:29 2018
New Revision: 331148
URL: https://svnweb.freebsd.org/changeset/base/331148

Log:
  MFC r319274:
  
  - Add a simple example to uname(1) manual page to show how the hardware
    platform (returned by -m) can be different from the machine's processor
    architecture (-p)
  - Document that make(1) sets universal MACHINE and MACHINE_ARCH variables
    based on these values

Modified:
  stable/11/usr.bin/uname/uname.1
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/usr.bin/uname/uname.1
==============================================================================
--- stable/11/usr.bin/uname/uname.1	Sun Mar 18 22:19:52 2018	(r331147)
+++ stable/11/usr.bin/uname/uname.1	Sun Mar 18 22:24:29 2018	(r331148)
@@ -28,7 +28,7 @@
 .\"	@(#)uname.1	8.3 (Berkeley) 4/8/94
 .\" $FreeBSD$
 .\"
-.Dd November 20, 2013
+.Dd May 31, 2017
 .Dt UNAME 1
 .Os
 .Sh NAME
@@ -61,6 +61,11 @@ Write the
 version of the kernel.
 .It Fl m
 Write the type of the current hardware platform to standard output.
+.Po Xr make 1
+uses it to set the
+.Va MACHINE
+variable.
+.Pc
 .It Fl n
 Write the name of the system to standard output.
 .It Fl o
@@ -69,6 +74,11 @@ This is a synonym for the
 option, for compatibility with other systems.
 .It Fl p
 Write the type of the machine processor architecture to standard output.
+.Po Xr make 1
+uses it to set the
+.Va MACHINE_ARCH
+variable.
+.Pc
 .It Fl r
 Write the current release level of the operating system
 to standard output.
@@ -106,6 +116,19 @@ will allow the corresponding data to be set to the con
 of the environment variable.
 .Sh EXIT STATUS
 .Ex -std
+.Sh EXAMPLES
+The hardware platform
+.Pq Fl m
+can be different from the machine's processor architecture
+.Pq Fl p ,
+e.g., on 64-bit PowerPC,
+.Fl m
+would return
+.Va powerpc
+and
+.Fl p
+would return
+.Va powerpc64 .
 .Sh SEE ALSO
 .Xr feature_present 3 ,
 .Xr getosreldate 3 ,