From nobody Thu Jul 21 20:03:25 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 4Lpk5n413Xz4XQR2; Thu, 21 Jul 2022 20:03:25 +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 4Lpk5n3Qvyz3g59; Thu, 21 Jul 2022 20:03:25 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1658433805; 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=Ovz7HD+uq2HMLQ9xH1rRHi4Q+nJ2CpRJi7ElJOh6RkA=; b=XbtlOqzPK80T2eCigtbfsWWOvQUKKcUzjLMRKILbU+mMgDGJJq0l89+LdW09W6TpDqYfl+ 7wiVMmhoeF1J9K0KSCUAT2DFtrJEAX4YPV2Ogu1VItnz/8A6CsvWanP4cTLwBT6mLy8QrK NBLxu5VEP/AWUqjHGMe0RbZi6tlLIfzBFd8rZV03Fp5hTIOQ6LrZHTlpvp3T6tUV1Hu2Kq lWTsNFTnQz7QNYwbUrpxhEXoaRUVn5kkeTKpb0MTPe4Cv/p7odgsiqjTctBsF7mVHwAW6m TJe8u6XAJ66VDrvsF80cqZ/lw0Sw9KVqd1Utjv5jKGx/Xz9iMikiHfP5OvlBlw== 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 4Lpk5n2RvnzZcL; Thu, 21 Jul 2022 20:03:25 +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 26LK3Pjb021221; Thu, 21 Jul 2022 20:03:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 26LK3P3P021220; Thu, 21 Jul 2022 20:03:25 GMT (envelope-from git) Date: Thu, 21 Jul 2022 20:03:25 GMT Message-Id: <202207212003.26LK3P3P021220@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: a848315f6804 - main - gmirror.8: Remove references rc.early 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: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a848315f68047ae46a5d96cbc7a890e645ce646f Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1658433805; 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=Ovz7HD+uq2HMLQ9xH1rRHi4Q+nJ2CpRJi7ElJOh6RkA=; b=JG72848rYk/k2Pf0ej9d5aAihplcUvzc8ryQ0hTDxs0GyuD5w2/DYA2bWHZG9tnPz7kMXJ 9D3fQiAxpbynVTUKl1Hu4IMxn+DTkYB4qIWtjp1coYdjFZ3Vo36lm08oWLsIN5p0XqND2d BWWpunyRKXZ9rqbuxK9nqVR9OMdToCl+V8I+EIjLVd2tVxRD+yQt335FgqwWQzP6XUX0jA YisuhzPwUi7R/+kkQnVx7fWf67486m0sK1UKQSn+gxURpeneN9If/dqJvMnslQUi7d7+Od p4HLlMJDoCjzAdEXYKiC/Y2Lg62ZXjoULBLPplJAoJ+tbUG1RnhihJqJFgRT0A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1658433805; a=rsa-sha256; cv=none; b=NK82FbvG23echUpe8uWPj9si5gD6EDRAcXaWOvjn1kOTTtxvbaRXSjrhUp7xj7xchSWU3H +qsiVOKaMqXDcNSA/ZxxcJf80FjS7Zvj/V0Bqp2zEjrgGDsTPVQ01NIXWTq1dHvdmYGcjC jlGg6rG/KmNqLCs6IDulhk7/55uHg3nMd0jubf4Xk7IyhiQbOSj6Y/56H+YdAIsZgLX6kp tGnj4T7+Q/Zo0eoWZMfL9BfeSGldsBn9rmY8u+17r+S+166oXm3Ztq5qVjkXAbsTHAYF+z IWNux4XbUa5DdPhJlr84k4oEmWfYR6ydSC5E1rwJYEMeJQUs2+HfHIhdWvNntA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=a848315f68047ae46a5d96cbc7a890e645ce646f commit a848315f68047ae46a5d96cbc7a890e645ce646f Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-07-21 19:43:14 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-07-21 20:02:44 +0000 gmirror.8: Remove references rc.early The manual page of gmirror describes how gmirror providers can be used for kernel dumps. Unfortunately, the instruction references /etc/rc.early, which is no longer a part of rc(8). Remove references to rc.early and suggest creating an rc(8) service script instead. Future work: In the Problem Report on Bugzilla, Lawrence Chen suggested adding example rc(8) scripts to the gmirror. However, those examples need to be tested before they become official reference examples in the base. Also, those scripts should probably land directly to /etc/rc.d, /usr/share/examples/rc.d, or /usr/share/examples/gmirror instead of the gmirror manual page. PR: 178818 Reported by: Lawrence Chen Fixes: dd2b024a336f Removal of early.sh MFC after: 1 week --- lib/geom/mirror/gmirror.8 | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/lib/geom/mirror/gmirror.8 b/lib/geom/mirror/gmirror.8 index 128138bbd2e4..44ea08bcf65b 100644 --- a/lib/geom/mirror/gmirror.8 +++ b/lib/geom/mirror/gmirror.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd November 30, 2017 +.Dd July 21, 2022 .Dt GMIRROR 8 .Os .Sh NAME @@ -388,21 +388,26 @@ Reading a dump from the mirror on boot will only work if the balance algorithm is used (that way .Nm will read only from the component with the highest priority). -If you use a different balance algorithm, you should add: +If you use a different balance algorithm, you should create an +.Xr rc 8 +script that sets the balance algorithm to +.Cm prefer , +for example with the following command: .Bd -literal -offset indent gmirror configure -b prefer data .Ed .Pp -to the -.Pa /etc/rc.early -script and: +Make sure that +.Xr rcorder 8 +schedules the new script before +.Xr savecore 8 . +The desired balance algorithm can be restored later on +by placing the following command in +.Xr rc.local 8 : .Bd -literal -offset indent gmirror configure -b round-robin data .Ed .Pp -to the -.Pa /etc/rc.local -script. The decision which component to choose for dumping is made when .Xr dumpon 8 is called.