From nobody Sat Oct 03 15:42:44 2026 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 4hxqfX57xPz6vc4w for ; Sat, 03 Oct 2026 15:42:44 +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 "YR2" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hxqfX36Qfz4SlD for ; Sat, 03 Oct 2026 15:42:44 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1791042164; 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=YvM/laWJbAX7ZjUGn6cNSfKd48ZaEN7lVGB25kGIAlk=; b=lQHVGKQOencRfamhFJMXMnFfONos/E4L5KBm5p0d1zk0lyqAWhckhd1pWoQJH4jyWwFzHt NBOIEcda/brULW+iV2FJLE9+0EuBtu31MaaihbSHNMGtl1+PFDUCVUY6hn6d7f+9yf071Z jZaCXRPFQ6wcirxud9gBr0t1J01rolDfrHahHCe0eH9aIZEAGigM9VzhHzpeaBVYUMygUN kNu0bWRKOkcq7/1qAy9lO/+aDiCAnbAbM5xZtZMcOIN1rir3UgG3nGJ0AUQK4aOmdCbSei GeYFIHSvfjDYkctS3rAImsbPlLtcaWph8WpKns4Au0pmnB1qlz28WAqiTLb4zA== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1791042164; b=reGLF8iR7bUCvkZNcjDekWrnOSzsR8PJ9Dlc2Qlb22AX/NNGb00FSnJmhBMzj4mOcu7jay U1aIB/UNMbf9cGXN16ozPu+Irwr7Jcn/9MZUU8enaTykRWqv7ETg1+uD0QClEXI+A+DpFB mAjMZPzR5yIpU05c+QKkyTMp6fusE4IED1P4XEuog+V1sBH5R0c4TT56XQPYJBJS2liqkn 09TJGR+qIx/wCk6idChA8iatLM76qZUzXap+FFLaDtVKCw5csNuqDNYPJJsbmZbuWBIbQK E3DmlIMUoeUeU9CZnwb5h0DtTlTP1yfvd5u8AOE7v3qPSZ1+Bmc/qxKCobcB8Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1791042164; 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=YvM/laWJbAX7ZjUGn6cNSfKd48ZaEN7lVGB25kGIAlk=; b=a1jHoaLxAISOmeateOmCNzBYqdFJLTHShQRVqd3X4mzcOSWCQtI339oQtBM9C4LGOzpILK AIaoXfUMrhRO8Hp9MQYMHfFomG6zl0FKAvlUfjI13nYDRNVoKMFK4Z446ui+csvk1eEc4L qodlG6sJcI0Na+BFG2MPIGLmLoKP3gHYx6wFrHtKL2bdmExrNZSnh1Yl4yKuay9alGaN38 O2n1mRbsQnuHQlbe2qtnngTdXFU37Znl0XNRAvfP+mUpG9KURTNQWgOxVt0PzksPc/9vTK +lHz6l9KWJyPKjBfPI9acR4ZxH484Up8GFgHseURGSD2YgP1CmwAKC0nL0HH+A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hxqfX230mz17yG for ; Sat, 03 Oct 2026 15:42:44 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 41e79 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sat, 03 Oct 2026 15:42:44 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Colin Percival Subject: git: 88017d32745e - main - mkimg.1: Document new vmdks format 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: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: cperciva X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 88017d32745ef24d662db826fe475d8a20d290a6 Auto-Submitted: auto-generated Date: Sat, 03 Oct 2026 15:42:44 +0000 Message-Id: <6ac12274.41e79.6431e372@gitrepo.freebsd.org> The branch main has been updated by cperciva: URL: https://cgit.FreeBSD.org/src/commit/?id=88017d32745ef24d662db826fe475d8a20d290a6 commit 88017d32745ef24d662db826fe475d8a20d290a6 Author: Colin Percival AuthorDate: 2026-09-29 19:44:01 +0000 Commit: Colin Percival CommitDate: 2026-10-03 15:42:20 +0000 mkimg.1: Document new vmdks format Reviewed by: ziaee Co-authored-by: Claude Opus 5.5 MFC after: 2 weeks Sponsored by: Amazon Differential Revision: https://reviews.freebsd.org/D60152 --- usr.bin/mkimg/mkimg.1 | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/usr.bin/mkimg/mkimg.1 b/usr.bin/mkimg/mkimg.1 index d3e6285d110f..10cf413188e6 100644 --- a/usr.bin/mkimg/mkimg.1 +++ b/usr.bin/mkimg/mkimg.1 @@ -22,7 +22,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd December 30, 2025 +.Dd September 29, 2026 .Dt MKIMG 1 .Os .Sh NAME @@ -284,7 +284,17 @@ virtualization solutions. To create a VMDK file, specify .Fl f Ar vmdk on the command line. -The preferred file extension is ".vmdk". +.Pp +The stream-optimized VMDK format is a variant in which each grain +(64 KiB of the virtual disk) is compressed with deflate, and grains which +contain only zeroes are omitted. +It is typically much smaller than the other formats, and is the VMDK +variant accepted by some cloud platforms for importing disk images. +To create a stream-optimized VMDK file, specify +.Fl f Ar vmdks +on the command line. +.Pp +The preferred file extension is ".vmdk" for both variants. .Pp Not all virtualization solutions support all file formats, but often those virtualization environments have utilities to convert from one format to