git: 88017d32745e - main - mkimg.1: Document new vmdks format
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
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