From nobody Tue Nov 19 21:18:52 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 4XtHRd0Bc3z5fS1h; Tue, 19 Nov 2024 21:18:53 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4XtHRc5WSCz4mNT; Tue, 19 Nov 2024 21:18:52 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1732051132; 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=3ukyBRKsUxuSACNhMVvFoOuf4zBG5eBLxAuFCZqPorE=; b=pWpxS48tBd5qhSGqubzMG/hJjzGWe7pW26IW0d6+IDUhonfbwp+7fXGWTetzbAdNrhugV1 dwulyo5GOWNFqDciJwcbdfpElOFG/TyPUXJjbUVD1jMMJeQk5zkJZPNGqykighyfsrHftB 6W6auouquZy/yNDm4sXc4d3P+jjwRe13tP4hiW5FbVG+03/oFxEtk6evpikEj1edU3A1bv +Vg7Lc62fU1oQ9Sev6Hy+yUdc+yjNMTM18vVf3ZPdH/5xWqzdYHKqL79xtwV28Fa897Aj0 +atjFwBpB9tuit95kP8blzODzGxZ2Sh94G9X/xInMj1Bz7u1FU6QrHI3H6CNEA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1732051132; 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=3ukyBRKsUxuSACNhMVvFoOuf4zBG5eBLxAuFCZqPorE=; b=XgSXQBIJnZhdJIKOoxWdKmwWUjfUWX2Cs36VGur0/4g8p73Dx3dEYSlbGtVfyMUPiTMn6Q m3YuCIyc4T//ogi39eWAjvMYsqfuS8ijDFHb/23xGB2t1xogc7XT/8ityZJqB00HPYcE7b F/5gRRboJazcziHCXuF6lJQt8EhiHelKoBmLvNasOOdEB+eK25vaz94rdDIIB7OXVMof/R H6v7vCGPyYtxQd4Ft4AI3/ELo6yyR9E3Ee1tSwUPxplhLtFKUnq/PI2SyImw38XDsVDWbX F56P0MQkqoFCICbHb+iLfTTdKnpYyf3v6lq6+ia/SlGIDfTcNrjKm0Ig7dao6w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1732051132; a=rsa-sha256; cv=none; b=J/IFhRT4KFN84SbuP2yQ3ZZmcRqYtxgERbMssFowtr00skXvhYvNE0jfeTU6mXkxiZqqQ4 zYKOuMqKd6OK3zvQw+8kBpxwbevJsNo/1UcAYEYG24Za1JSu16Gz9ZA2gXjR8XWl4v3eXy /XL0Hio9KZ37HMSqIWtb4EOkDpqcInUs/3Ao7tDDOLpsHOJOdA/QhrHnCWDHl0cmXe1Nut hNOF62soI3kQpz+Si69QuSu0qO60YyNoYKxXa9aOP+ssIO4HzdgDV24Ku6Rto90vyzGNjm oXYjJlPgf6otTo7A18420bcOfbbi6KTSGPiEWIsAO2v53D37uiLtQAUjgkIUVQ== 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 4XtHRc56MtzR8K; Tue, 19 Nov 2024 21:18:52 +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 4AJLIqcR093256; Tue, 19 Nov 2024 21:18:52 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4AJLIqR9093253; Tue, 19 Nov 2024 21:18:52 GMT (envelope-from git) Date: Tue, 19 Nov 2024 21:18:52 GMT Message-Id: <202411192118.4AJLIqR9093253@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mark Johnston Subject: git: a20249443be1 - main - makefs.8: Clarify that makefs-generated zpools always have the same GUID 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: markj X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a20249443be111e8a3cb3b7bbe4a0d0e460a6058 Auto-Submitted: auto-generated The branch main has been updated by markj: URL: https://cgit.FreeBSD.org/src/commit/?id=a20249443be111e8a3cb3b7bbe4a0d0e460a6058 commit a20249443be111e8a3cb3b7bbe4a0d0e460a6058 Author: Mark Johnston AuthorDate: 2024-11-19 21:07:56 +0000 Commit: Mark Johnston CommitDate: 2024-11-19 21:18:38 +0000 makefs.8: Clarify that makefs-generated zpools always have the same GUID PR: 282832 MFC after: 1 week --- usr.sbin/makefs/makefs.8 | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/usr.sbin/makefs/makefs.8 b/usr.sbin/makefs/makefs.8 index 897c647fc52b..ae11309953e4 100644 --- a/usr.sbin/makefs/makefs.8 +++ b/usr.sbin/makefs/makefs.8 @@ -507,6 +507,21 @@ The root dataset is always created implicitly and contains the entire input directory tree unless additional datasets are specified using the options described below. .Pp +To keep images reproducible, the pool GUID and other random identifiers will +always be the same across runs of +.Nm . +This means that when a pool is first imported, its GUID should be reset +using +.Xr zpool-reguid 8 +to avoid conflicting with other pools also generated by +.Nm ; +otherwise, it will not be possible to import other pools. +This can be configured from +.Pa /etc/rc.conf +using the +.Va zpool_reguid +variable. +.Pp The arguments consist of a keyword, an equal sign .Pq Ql = , and a value. @@ -584,11 +599,13 @@ The following properties may be set for a dataset: .El .Sh SEE ALSO .Xr mtree 5 , +.Xr rc.conf 5 , .Xr zfsconcepts 7 , .Xr zfsprops 7 , .Xr zpoolprops 7 , .Xr mtree 8 , -.Xr newfs 8 +.Xr newfs 8 , +.Xr zpool-reguid 8 .Sh HISTORY The .Nm