1.\" ---------------------------------------------------------------------------- 2.\" "THE BEER-WARE LICENSE" (Revision 42): 3.\" <sobomax@FreeBSD.ORG> wrote this file. As long as you retain this notice you 4.\" can do whatever you want with this stuff. If we meet some day, and you think 5.\" this stuff is worth it, you can buy me a beer in return. Maxim Sobolev 6.\" ---------------------------------------------------------------------------- 7.\" |
8.\" $FreeBSD: head/usr.bin/mkuzip/mkuzip.8 162792 2006-09-29 15:20:48Z ru $ |
9.\" |
10.Dd March 17, 2006 |
11.Dt MKUZIP 8 12.Os 13.Sh NAME 14.Nm mkuzip 15.Nd compress disk image for use with 16.Xr geom_uzip 4 17class 18.Sh SYNOPSIS --- 6 unchanged lines hidden (view full) --- 25The 26.Nm 27utility compresses a disk image file so that the 28.Xr geom_uzip 4 29class will be able to decompress the resulting image at run-time. 30This allows for a significant reduction of size of disk image at 31the expense of some CPU time required to decompress the data each 32time it is read. |
33The |
34.Nm |
35utility |
36works in two phases: 37.Bl -enum 38.It 39An 40.Ar infile 41image is split into clusters; each cluster is compressed using 42.Xr zlib 3 . 43.It --- 27 unchanged lines hidden (view full) --- 71are only 1-2% less than those achieved with 72.Xr gzip 1 . 73However, it should be kept in mind that larger cluster 74sizes lead to higher overhead in the 75.Xr geom_uzip 4 76class, as the class has to decompress the whole cluster even if 77only a few bytes from that cluster have to be read. 78.Pp |
79The |
80.Nm |
81utility |
82inserts a short shell script at the beginning of the generated image, 83which makes it possible to 84.Dq run 85the image just like any other shell script. 86The script tries to load the 87.Xr geom_uzip 4 88class if it is not loaded, configure the image as an 89.Xr md 4 --- 17 unchanged lines hidden --- |