From nobody Thu Nov 28 14:38:55 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 4Xzf7z63VDz5dnZL; Thu, 28 Nov 2024 14:38:55 +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 4Xzf7z4ZTDz44JZ; Thu, 28 Nov 2024 14:38:55 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1732804735; 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=TRC4pEvHH1D9I0eXrFK8YyWNLUZsS+kWulgMF6rTDFI=; b=rZELlFkbRobiIo0X1i2fjX8Qo13wDaaQffKs+kSpfypPTPCwdiBBhzKHpW9gaJknm44wPb +77TFjn+jXF/acSLZx2DOCPwt6f718ihQ6GCkWRYr5D1uonikf8wUUf1oU8VGOkwZ2ukD6 xG0KP9vkSCMO5lTgVs3WXeGBwwX1ycNsJG04fPW09bfXdu+kJvHs7+otwkCrrTFHoSGukF ddTWgm56F1wBxcNQ5nvibmFU0+hY0NmwO2h5oAxcUnKWzuRkIAP+uKujiTBQTYGKelzHW5 MHXUCqlBLWSfr0zFjK/51QFgSmJG9cEcPjK5eLrgLhRlYqHBs+d3cdsQSRByLg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1732804735; 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=TRC4pEvHH1D9I0eXrFK8YyWNLUZsS+kWulgMF6rTDFI=; b=kJyRfCgTtaLD2z6gzLZX8DHfSnHOzJh/nSHD3WqYUy1540dn+kSM93zmc9wbC90Lcya7C7 qtjnKkoQPZ33vvhNfauV4wpShvc2JlhfkKsLRtOYA2kK+knOj2It1F7rQaIGyNoopJpAUv nXMTM34Aytc6RHkYoF0jf20qZy/tiFCmJyEh93/FqWOAc1Rth/7PcOMeWknAd1qMEa0cYs e+jPos2jZ83KZlHC9JCkfRkiGJSyBX27YE4EvxQsKYUaxstGlqbH24InRlf6vA+nZiL5TM HXAJJirYLYsOyAPsTRXChehyJFDMvqwiCrUSflmand3X4/l5weV1m2DvIXJapg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1732804735; a=rsa-sha256; cv=none; b=GR3Yey6FGy+BeNukG0LE8+ojMBR0dYePFtwjjEUEzS9i6d/b7v7tl7JdftVkWUt+oLoN4o eeCMV/POX0/gCeN52v9A8UmQcXFeW92i0/6O6LTkoVZo2vDdfmy5Zw/lxRSSPshNPdoF1d 6FEQ9wFNsiHnz/bU4gX6ymZf2+c9mDy29Sz562pSqZ+ORKgYRjORRb9NtuGVC9T2H/3BoZ M04sQvylwEfgGjcBDFJJYUjfNsMWQGPp3K5VO/8I+aO3un3WOLdf8LrEoZkiC1hAOX7An6 yj+k/jiRvyeoAqJEo6PxkJaiSm24DLKkZoL27H4FvUpADl49Iep8GV+bkOAftQ== 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 4Xzf7z4BHTzjW9; Thu, 28 Nov 2024 14:38:55 +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 4ASEctRc035538; Thu, 28 Nov 2024 14:38:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4ASEct1T035535; Thu, 28 Nov 2024 14:38:55 GMT (envelope-from git) Date: Thu, 28 Nov 2024 14:38:55 GMT Message-Id: <202411281438.4ASEct1T035535@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mark Johnston Subject: git: c9f9f1a282ab - stable/14 - 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/stable/14 X-Git-Reftype: branch X-Git-Commit: c9f9f1a282ab81276feb81d0509e44535ebda504 Auto-Submitted: auto-generated The branch stable/14 has been updated by markj: URL: https://cgit.FreeBSD.org/src/commit/?id=c9f9f1a282ab81276feb81d0509e44535ebda504 commit c9f9f1a282ab81276feb81d0509e44535ebda504 Author: Mark Johnston AuthorDate: 2024-11-19 21:07:56 +0000 Commit: Mark Johnston CommitDate: 2024-11-28 14:38:17 +0000 makefs.8: Clarify that makefs-generated zpools always have the same GUID PR: 282832 MFC after: 1 week (cherry picked from commit a20249443be111e8a3cb3b7bbe4a0d0e460a6058) --- 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 c87df98d24d5..803ae0714abd 100644 --- a/usr.sbin/makefs/makefs.8 +++ b/usr.sbin/makefs/makefs.8 @@ -511,6 +511,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. @@ -588,11 +603,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