git: 88017d32745e - main - mkimg.1: Document new vmdks format

From: Colin Percival <cperciva_at_FreeBSD.org>
Date: Sat, 03 Oct 2026 15:42:44 UTC
The branch main has been updated by cperciva:

URL: https://cgit.FreeBSD.org/src/commit/?id=88017d32745ef24d662db826fe475d8a20d290a6

commit 88017d32745ef24d662db826fe475d8a20d290a6
Author:     Colin Percival <cperciva@FreeBSD.org>
AuthorDate: 2026-09-29 19:44:01 +0000
Commit:     Colin Percival <cperciva@FreeBSD.org>
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