mkuzip(8) [freebsd man page]

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

NAME

     mkuzip -- compress disk image for use with geom_uzip(4) class

SYNOPSIS

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

DESCRIPTION

     The mkuzip utility compresses a disk image file so that the geom_uzip(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 mkuzip utility works in two phases:

     1.   An infile image is split into clusters; each cluster is compressed using zlib(3).

     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 .uzip.

     -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 gzip(1).  However, it should be kept in mind that larger cluster sizes lead to higher overhead in the
     geom_uzip(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 mkuzip 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_uzip(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 mkuzip utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

     gzip(1), zlib(3), geom(4), geom_uzip(4), md(4), mdconfig(8), mount_cd9660(8)

AUTHORS

     Maxim Sobolev <sobomax@FreeBSD.org>

BSD
								  March 17, 2006							       BSD

CLUSTER(1)						      General Commands Manual							CLUSTER(1)

NAME

       cluster - find clusters in a graph and augment the graph with this information.

SYNOPSIS

       cluster [-v?]  [ -Ck ] [ -ck ] [ -o outfile ] [ files ]

DESCRIPTION

       cluster takes as input a graph in DOT format, finds node clusters and augments the graph with this information.	The clusters are specified
       by the "cluster" attribute attached to nodes; cluster values are non-negative integers.	cluster attempts to maximize the modularity of the
       clustering.  If the edge attribute "weight" is defined, this will be used in computing the clustering.

OPTIONS

       The following options are supported:

       -Ck    specifies  a targeted number of clusters that should be generated.  The specified number k is only a suggestion and may not be real-
	      isable.  If k == 0, the default, the number of clusters that approximately optimizes the modularity is returned.

       -ck    specifies clustering method.  If k == 0, the default, the modularity will be used. If k == 1 modularity quality will be used.

       -ooutfile
	      Specifies that output should go into the file outfile. By default, stdout is used.

       -v     Verbose mode.

EXAMPLES

       Applying cluster to the following graph,

	  graph {
	      1--2 [weight=10.]
	      2--3 [weight=1]
	      3--4 [weight=10.]
	      4--5 [weight=10]
	      5--6 [weight=10]
	      3--6 [weight=0.1]
	      4--6 [weight=10.]
	     }

       gives

	  graph {
		node [cluster="-1"];
		1 [cluster=1];
		2 [cluster=1];
		3 [cluster=2];
		4 [cluster=2];
		5 [cluster=2];
		6 [cluster=2];
		1 -- 2 [weight="10."];
		2 -- 3 [weight=1];
		3 -- 4 [weight="10."];
		4 -- 5 [weight=10];
		5 -- 6 [weight=10];
		3 -- 6 [weight="0.1"];
		4 -- 6 [weight="10."];
	  }

AUTHOR

       Yifan Hu <yifanhu@research.att.com>

SEE ALSO

       gvmap(1)

       Blondel, V.D., Guillaume, J.L., Lambiotte, R., Lefebvre, E.: Fast unfolding of  communities  in	large  networks.  Journal  of  Statistical
       Mechanics: Theory and Experiment (2008), P10008.

								   3 March 2011 							CLUSTER(1)