mkulzma(8) [freebsd man page]

MKULZMA(8)						    BSD System Manager's Manual 						MKULZMA(8)

NAME

     mkulzma -- compress disk image for use with geom_uncompress(4) class

SYNOPSIS

     mkulzma [-v] [-o outfile] [-s cluster_size] infile

DESCRIPTION

     The mkulzma utility compresses a disk image file so that the geom_uncompress(4) class will be able to decompress the resulting image at run-
     time.  This allows for a significant reduction of size of disk image at the expense of some CPU time required to decompress the data each
     time it is read.  The mkulzma utility works in two phases:

     1.   An infile image is split into clusters; each cluster is compressed using liblzma.

     2.   The resulting set of compressed clusters along with headers that allow locating each individual cluster is written to the output file.

     The options are:

     -o outfile
	     Name of the output file outfile.  The default is to use the input name with the suffix .ulzma.

     -s cluster_size
	     Split the image into clusters of cluster_size bytes, 16384 bytes by default.  The cluster_size should be a multiple of 512 bytes.

     -v      Display verbose messages.

NOTES

     The compression ratio largely depends on the cluster size used.  For large cluster sizes (16K and higher), typical compression ratios are
     only 1-2% less than those achieved with lzma(1).  However, it should be kept in mind that larger cluster sizes lead to higher overhead in the
     geom_uncompress(4) class, as the class has to decompress the whole cluster even if only a few bytes from that cluster have to be read.

     The mkulzma utility inserts a short shell script at the beginning of the generated image, which makes it possible to ``run'' the image just
     like any other shell script.  The script tries to load the geom_uncompress(4) class if it is not loaded, configure the image as an md(4) disk
     device using mdconfig(8), and automatically mount it using mount_cd9660(8) on the mount point provided as the first argument to the script.

EXIT STATUS

     The mkulzma utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

     lzma(1), geom(4), geom_uncompress(4), md(4), mdconfig(8), mount_cd9660(8)

AUTHORS

     Maxim Sobolev <sobomax@FreeBSD.org>
     Aleksandr Rybalko <ray@ddteam.net>

BSD
								  March 17, 2006							       BSD

NEWFS_EXFAT(8)						    BSD System Manager's Manual 					    NEWFS_EXFAT(8)

NAME

     newfs_exfat -- construct a new ExFAT file system

SYNOPSIS

     newfs_exfat [-N] [-R] [-I volume-serial-number] [-S bytes-per-sector] [-a sectors-per-FAT] [-b bytes-per-cluster] [-c sectors-per-cluster]
		 [-n number-of-FATs] [-s total-sectors] [-v volume-name] special

DESCRIPTION

     The newfs_exfat utility creates an ExFAT file system on device special.  If the -R option is not given, and the device is already formatted
     as ExFAT, it will preserve the partition offset, bytes per cluster, FAT offset and size, number of FATs, offset to start of clusters, number
     of clusters, volume serial number, and volume name (label).  If a volume name was specified via the -v option, that name is used instead of
     the volume's previous name.

     The options are as follow:

     -N      Don't create a file system: just print out parameters.

     -R      Do not check whether the device is currently formatted as ExFAT.  Always derive the partition offset, bytes per cluster, FAT offset
	     and size, and offset to start of clusters based on the device type and size.

     -I volume-serial-number
	     Volume ID, a 32-bit integer.

     -S bytes-per-sector
	     Number of bytes per sector.  Acceptable values are powers of 2 in the range 512 through 4096.

     -a sectors-per-FAT
	     Number of sectors per FAT.

     -b bytes-per-cluster
	     File system block size (bytes per cluster).  Acceptable values are powers of 2 in the range 512 through 33554432.

     -c sectors-per-cluster
	     Sectors per cluster.  Acceptable values are powers of 2 in the range 1 through 65536.

     -n number-of-FATs
	     Number of FATs.  Acceptable values are 1 or 2.  The default is 1.	Using any value other than 1 is discouraged, and may be incompati-
	     ble with other devices.

     -s total-sectors
	     The total number of sectors in the device.

     -v volume-name
	     Volume name (label).  The name will be converted to UTF-16, and must be no longer than 11 UTF-16 characters.  ASCII control charac-
	     ters and some punctuation characters are not allowed (similar to DOS 8.3-style names).  NOTE: The volume name may be an empty (zero-
	     length) string.

EXAMPLES

	   newfs_exfat /dev/disk0s1
     Create a file system, using default parameters (or existing ExFAT layout), on /dev/rdisk0s1.
	   newfs_exfat -v Hello disk2s1
     Create a file system with the name "Hello" on /dev/rdisk2s1.

SEE ALSO

     mount_exfat(8), fsck_exfat(8)

DIAGNOSTICS

     Exit status is 0 on success and 1 on error.

HISTORY

     The newfs_exfat command appeared in Mac OS X 10.6.3.

Darwin								 January 19, 2010							    Darwin