doc: discourage use of uname -i and -p options

* src/uname.c (usage): State that the non POSIX -i and -p options
are non-portable.
* doc/coreutils.texi (uname invocation): Mention the discrepancies
even across GNU/Linux distros, and that the results should
be used as informational only, rather than impacting any
logic decisions.
Fixes http://bugs.gnu.org/13001

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 58084139c726cba7568f459859f186058a26d498..6f62f6dbccb1f3eb17872c489db08f9e693cc20a 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -15605,8 +15605,8 @@ and the hardware platform name if they are unknown.
 @cindex platform, hardware
 Print the hardware platform name
 (sometimes called the hardware implementation).
-Print @samp{unknown} if the kernel does not make this information
-easily available, as is the case with Linux kernels.
+Print @samp{unknown} if this information is not available.
+Note this is non-portable (even across GNU/Linux distributions).
 
 @item -m
 @itemx --machine
@@ -15634,8 +15634,8 @@ Print the network node hostname.
 @cindex host processor type
 Print the processor type (sometimes called the instruction set
 architecture or ISA).
-Print @samp{unknown} if the kernel does not make this information
-easily available, as is the case with Linux kernels.
+Print @samp{unknown} if this information is not available.
+Note this is non-portable (even across GNU/Linux distributions).
 
 @item -o
 @itemx --operating-system

diff --git a/src/uname.c b/src/uname.c
index 39bd28c74acbfaaf6a8f3a5bd523d06a32e5a266..af83a5461f09e812e2d2c849800ff6aa69e76fa5 100644 (file)
--- a/src/uname.c
+++ b/src/uname.c
@@ -133,8 +133,8 @@ Print certain system information.  With no OPTION, same as -s.\n\
           fputs (_("\
   -v, --kernel-version     print the kernel version\n\
   -m, --machine            print the machine hardware name\n\
-  -p, --processor          print the processor type or \"unknown\"\n\
-  -i, --hardware-platform  print the hardware platform or \"unknown\"\n\
+  -p, --processor          print the processor type (non-portable)\n\
+  -i, --hardware-platform  print the hardware platform (non-portable)\n\
   -o, --operating-system   print the operating system\n\
 "), stdout);
         }