From nobody Mon Oct 21 15:47:08 2024 X-Original-To: dev-commits-src-all@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 4XXKSD2fx4z5ZR12; Mon, 21 Oct 2024 15:47:08 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4XXKSD1Km9z4tWy; Mon, 21 Oct 2024 15:47:08 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1729525628; 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=yjalPciVCQZ/fWj5KSeRgCHBi7zTLso9ZisLZBNvA90=; b=HBrWhA54GThFlPJPtdITWvCBauJTRu2AxibyPK443onvZYjhkIYdomXpTCO7tHA9bgHEvD lZAJGH3b0acgMbvSK+aN2BsffYu6Waj2lP8W17vpiPdNrsCBttkK8PVb4JKJCG6U0/tMjZ YmiqAIBH3FYGq6Bpli9SqRx/UnWtHUXxhgFLhzeslIRQkXLh045Fuo/YSMX407CZGS68P/ LVoawWGErqZNHTeOrSK/pSwK5BZa+tgydoaz52VcVta0CoO8y0WL4nd9DINnS5Ju6mb3RU FClcg/Ao1cJtV6VMIwkFoRr4ifquGHgXrOwxnqLcGFOp8ESmQX9fFJFWTtiIdw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1729525628; 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=yjalPciVCQZ/fWj5KSeRgCHBi7zTLso9ZisLZBNvA90=; b=JDL/VcdXtdzQvyp1M6ipYAF2ag4lH+tKD1Qqb6gfTdD0FsAZu5bq1qHPfAKUUH+/C6RDEP UR49Zbi6eVnrnlDXbLqPX5Hg4dkpw9+Wc+L1ypHsCNjY6M/Oyj2qvgtOJyOXNNOkreoUO9 PSLokZtpvP39/id5TCs5QYH+uoQiMypdWIekG84FhfeOmdIneZCrbja9KK7fmrPeTBRnpd g+4+ZkIbLt5u028CIS8UPNmUMruG4Q5aDV6dx8DBCj0hPKWhuEEYMg5TYiPYC4DT8MiXNO AVEHAwrDj0jB9W1A3w+Mv8cQlZ0uaP2/K6KWTxjrOp645kJZGUSk6dF4tV2Low== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1729525628; a=rsa-sha256; cv=none; b=vBMTVZKaCALjtFl17oVLqSU5eOBopdTLa/yQWJLO14dszLAwXTHcIWnQN2Wvrl0hVX8Rzg YFPOF9tji0P5eIVOBfmoXAV82u1m8D9T4oNEUMxFEIwklAOkY21ju0Z720rro8njXWiFVK FoW8Zc1fQcElLvfV5Dv2Wbw/gzvs9r+oa6os/iTHKN2UXn63NoYVhkfv/U2pU0AEdqWgWI 9DFBDVEHfRGdLASGQcnTyxTHbpREzhZIy+TLlSF638SoEOnwoH6/rNzwqixMltreEnu/5D 2Pu7tNS7yI8DeDHbWPsI7FjMCh3lSqmy3535DLgEZKtabXQ5T3O6xURFpmRc9Q== 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 4XXKSD0x5CzbWN; Mon, 21 Oct 2024 15:47:08 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 49LFl8fP021860; Mon, 21 Oct 2024 15:47:08 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 49LFl800021857; Mon, 21 Oct 2024 15:47:08 GMT (envelope-from git) Date: Mon, 21 Oct 2024 15:47:08 GMT Message-Id: <202410211547.49LFl800021857@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Ed Maste Subject: git: e18ba5c5555a - stable/14 - freebsd-update(8): wrap to 80 columns List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: e18ba5c5555a52e5603f0ce1f76b63f1ffe4b645 Auto-Submitted: auto-generated The branch stable/14 has been updated by emaste: URL: https://cgit.FreeBSD.org/src/commit/?id=e18ba5c5555a52e5603f0ce1f76b63f1ffe4b645 commit e18ba5c5555a52e5603f0ce1f76b63f1ffe4b645 Author: Graham Perrin AuthorDate: 2023-08-20 10:01:05 +0000 Commit: Ed Maste CommitDate: 2024-10-21 15:46:41 +0000 freebsd-update(8): wrap to 80 columns Reviewed by: imp Pull Request: https://github.com/freebsd/freebsd-src/pull/826 (cherry picked from commit 4c1c516c1a0760de2c86c073e8e74e297a71b088) --- usr.sbin/freebsd-update/freebsd-update.8 | 62 ++++++++++++++------------------ 1 file changed, 27 insertions(+), 35 deletions(-) diff --git a/usr.sbin/freebsd-update/freebsd-update.8 b/usr.sbin/freebsd-update/freebsd-update.8 index 1960b0ee95fe..024185198342 100644 --- a/usr.sbin/freebsd-update/freebsd-update.8 +++ b/usr.sbin/freebsd-update/freebsd-update.8 @@ -82,8 +82,7 @@ e.g.: .Pp In particular, the .Fx -Security Team only builds updates for releases shipped in binary form -by the +Security Team only builds updates for releases shipped in binary form by the .Fx Release Engineering Team. .Sh OPTIONS @@ -149,8 +148,8 @@ from or similar using this flag, see: .Nm Cm cron .It Fl -currently-running Ar release -Do not detect the currently-running release; instead, assume that the -system is running the specified +Do not detect the currently-running release; instead, assume that the system is +running the specified .Ar release . This is most likely to be useful when upgrading jails. .El @@ -160,28 +159,26 @@ The can be any one of the following: .Bl -tag -width "rollback" .It Cm fetch -Based on the currently installed world and the configuration -options set, fetch all available binary updates. +Based on the currently installed world and the configuration options set, fetch +all available binary updates. .It Cm cron -Sleep a random amount of time between 1 and 3600 seconds, -then download updates as if the +Sleep a random amount of time between 1 and 3600 seconds, then download updates +as if the .Cm fetch command was used. -If updates are downloaded, an email will be sent -(to root or a different address if specified via the +If updates are downloaded, an email will be sent (to root or a different +address if specified via the .Fl t option or in the configuration file). -As the name suggests, this command is designed for running -from +As the name suggests, this command is designed for running from .Xr cron 8 ; -the random delay serves to minimize the probability that -a large number of machines will simultaneously attempt to -fetch updates. +the random delay serves to minimize the probability that a large number of +machines will simultaneously attempt to fetch updates. .It Cm upgrade Fetch files necessary for upgrading to a new release. -Before using this command, make sure that you read the -announcement and release notes for the new release in -case there are any special steps needed for upgrading. +Before using this command, make sure that you read the announcement and release +notes for the new release in case there are any special steps needed for +upgrading. Note that this command may require up to 500 MB of space in .Ar workdir depending on which components of the @@ -192,19 +189,15 @@ Check if there are fetched updates ready to install. Returns exit code 2 if there are no updates to install. .It Cm install Install the most recently fetched updates or upgrade. -Returns exit code 2 if there are no updates to install -and the +Returns exit code 2 if there are no updates to install and the .Cm fetch -command wasn't passed as an earlier argument in the same -invocation. +command wasn't passed as an earlier argument in the same invocation. .It Cm rollback Uninstall the most recently installed updates. .It Cm IDS -Compare the system against a "known good" index of the -installed release. +Compare the system against a "known good" index of the installed release. .It Cm showconfig -Show configuration options after parsing conffile and command -line options. +Show configuration options after parsing conffile and command line options. .El .Sh TIPS .Bl -bullet @@ -216,17 +209,15 @@ If your clock is set to local time, adding the line to .Pa /etc/crontab will check for updates every night. -If your clock is set to UTC, please pick a random time -other than 3AM, to avoid overly imposing an uneven load -on the server(s) hosting the updates. +If your clock is set to UTC, please pick a random time other than 3AM, to avoid +overly imposing an uneven load on the server(s) hosting the updates. .It In spite of its name, .Nm -IDS should not be relied upon as an "Intrusion Detection -System", since if the system has been tampered with -it cannot be trusted to operate correctly. -If you intend to use this command for intrusion-detection -purposes, make sure you boot from a secure disk (e.g., a CD). +IDS should not be relied upon as an "Intrusion Detection System", since if the +system has been tampered with it cannot be trusted to operate correctly. +If you intend to use this command for intrusion-detection purposes, make sure +you boot from a secure disk (e.g., a CD). .El .Sh ENVIRONMENT .Bl -tag -width "PAGER" @@ -265,7 +256,8 @@ required. .Sh AUTHORS .An Colin Percival Aq Mt cperciva@FreeBSD.org .Sh BUGS -In patch level situations – for example, 13.2-RELEASE-p1 up to 13.2-RELEASE-p2: if any previous modification to a file in +In patch level situations – for example, 13.2-RELEASE-p1 up to +13.2-RELEASE-p2: if any previous modification to a file in .Pa /etc/ will conflict with an available update, then .Nm