From nobody Fri Sep 16 11:28:47 2022 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4MTWzh2zcRz4cVdW; Fri, 16 Sep 2022 11:28:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4MTWzh2V7nz4Fnf; Fri, 16 Sep 2022 11:28:48 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1663327728; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=jYO9RBwSgPZoqcySfWIU0Y+kYkECzsl8+WuhCuFbGZc=; b=XQ+TaJSr0/G4Zj5S65gGVLqw/yhUx6QoK80sYhSUW0HiDYaaKyioyrcl+mwX1akxd2Wo4i RTCqCjDVQig/ggtWIzmA2+GNO+pSjSJ6tWTOEqvujCEwriLy3ZbCzU4D1b6n5HKJHNFSrs S38rUTg93jzyfGygWcc+IHX7w8pn/6MGMvkWZ7KQamnPbOksrJ1mJN9Twkd+R1Ueq8+b2y Q4cweQXPfyj+BUdoehTEQNL0WsMiDisvC5ymhbt02xVkte8YTtzREG0cWO5WOt8jRG8ME5 wMh4M9jU81zQobXbl3T/Rkkq5nIDn6T4IILNOamybh0rf9eI4DvillX76x+5qQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4MTWzh1Hm4zLTy; Fri, 16 Sep 2022 11:28:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 28GBSmDZ052657; Fri, 16 Sep 2022 11:28:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 28GBSlP1052656; Fri, 16 Sep 2022 11:28:47 GMT (envelope-from git) Date: Fri, 16 Sep 2022 11:28:47 GMT Message-Id: <202209161128.28GBSlP1052656@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Gordon Bergling Subject: git: 8f98a937ed72 - main - uname.1: Clarify the -r option List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gbe X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 8f98a937ed726399b89e87e95769a9adc809281a Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1663327728; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=jYO9RBwSgPZoqcySfWIU0Y+kYkECzsl8+WuhCuFbGZc=; b=SVbfTjJ7w2x81z6kAXl2aYJjFlUiuDQMEufWOkby8e+Joq8zUDsYR+JMkKhDvfPjtzrR7v 43gA+TblccWynxZEa/iL8a/VKUtJaeBqDq+uJTkr+PP0GljmJhsFO6FB7BL1+8RtcQJh4N IbCblHs/qp1rIxj3aOQxT7TXyaljEkyEG7NZQMATTJWigEiZILm9D7z2hfcQ3H0+3EddxY Isx1toXVB1reRmFB48FSaft9T379taT9nr6WFvdgpWkhIjbJhp+TuXGXVCT8nbcAY6YMcP KL+piYxUfDkZ04vNNddqzFY2PpAaXxN7dkRMqDU2g3gHf9gnhMNeaTFtNGqrwQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1663327728; a=rsa-sha256; cv=none; b=ULzcklnN2DbCSaAVYHfnFsmIBv7on5VITmNWp0mP9gLNvCF8ynp8l5+MDRBlOI8g49QcAG CLw9/UlZJ71+mZB9F7X1soVLvpeIMqLDlpNlBvcKQhYKcfcIAydyxYbRgCAFEtDq7HJs3L Q4042q9qR4lBms1GUl6GHpcxeotW45EjE4qDBuLRmlueXH0B3UFWsBZ8KakoqkKjZN0ZwJ ovQaOP/p+hYZzYdtHaMd5oyPjtOPycJHRXkan/CxzgJ2K9Y83GoJP2yDXWAiuc76tHDAEH BrsaAVtd4xWGeumRDmSVU1/xhO1t357I/KVSHdvj23oMZ4EJec/QkP9Vgu+oYA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by gbe (doc committer): URL: https://cgit.FreeBSD.org/src/commit/?id=8f98a937ed726399b89e87e95769a9adc809281a commit 8f98a937ed726399b89e87e95769a9adc809281a Author: Gordon Bergling AuthorDate: 2022-09-16 11:27:54 +0000 Commit: Gordon Bergling CommitDate: 2022-09-16 11:27:54 +0000 uname.1: Clarify the -r option It is some times hard to understand the difference between kernel version and userland version. So clarify the -r option of uname(1) in terms of a printed kernel version. While here, add some cross references: - cross reference freebsd-version(1) in uname(1) - cross reference freebsd-version(1) and uname(1) in freebsd-update(8) PR: 265594 Reported by: rwatson Reviewed by: gbe, imp MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D36516 --- usr.bin/uname/uname.1 | 7 +++++-- usr.sbin/freebsd-update/freebsd-update.8 | 4 +++- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/usr.bin/uname/uname.1 b/usr.bin/uname/uname.1 index a29e7ec2d8af..ff1b3ec5f3f2 100644 --- a/usr.bin/uname/uname.1 +++ b/usr.bin/uname/uname.1 @@ -28,7 +28,7 @@ .\" @(#)uname.1 8.3 (Berkeley) 4/8/94 .\" $FreeBSD$ .\" -.Dd November 13, 2020 +.Dd September 14, 2022 .Dt UNAME 1 .Os .Sh NAME @@ -82,8 +82,10 @@ uses it to set the variable. .Pc .It Fl r -Write the current release level of the operating system +Write the current release level of the kernel to standard output. +.Xr freebsd-version 1 +can be used to print the release level of the userland. .It Fl s Write the name of the operating system implementation to standard output. .It Fl U @@ -138,6 +140,7 @@ and would return .Va powerpc64 . .Sh SEE ALSO +.Xr freebsd-version 1 , .Xr feature_present 3 , .Xr getosreldate 3 , .Xr sysctl 3 , diff --git a/usr.sbin/freebsd-update/freebsd-update.8 b/usr.sbin/freebsd-update/freebsd-update.8 index 6d7fc792c6f1..3b56d64660a2 100644 --- a/usr.sbin/freebsd-update/freebsd-update.8 +++ b/usr.sbin/freebsd-update/freebsd-update.8 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 22, 2022 +.Dd September 10, 2022 .Dt FREEBSD-UPDATE 8 .Os .Sh NAME @@ -256,6 +256,8 @@ Default location where stores temporary files and downloaded updates. .El .Sh SEE ALSO +.Xr freebsd-version 1 , +.Xr uname 1 , .Xr freebsd-update.conf 5 , .Xr nextboot 8 .Sh AUTHORS