debian man page for gaffitter

GAFFITTER(1)															      GAFFITTER(1)

NAME
       gaffitter - File subsets extractor based on genetic algorithms

SYNOPSIS
       gaffitter -t|--target value[unit] [OPTION]... FILE...
       gaffitter - -t|--target value[unit] [OPTION]... [FILE]...

DESCRIPTION
       gaffitter  (Genetic  Algorithm File Fitter) is a command-line software written in C++ that extracts --via genetic algorithm-- subsets of an
       input list of files/directories that best fit the given volume size (target), such as CD, DVD and others.

       If gaffitter is executed using the second option listed above, the information about files is fetched from stdin.

       The unit suffixes 'k', 'm', 'g' or 't' can be used, where: k = KB/KiB, m = MB/MiB, g = GB/GiB and t = TB/TiB. Default: bytes.

OPTIONS
       General options:

       -t, --target VALUE[unit] (float)
	      Set VALUE as target size (mandatory), VALUE > 0.0

       --bins, --vols VALUE[unit]
	      Set VALUE as the maximum number of bins (volumes). [default = "unlimited"]

       --si   Use powers of 1000 (not 1024) for target, min, max and output sizes.

       --min, --min-size VALUE[unit]
	      Minimum file size. [default = none]

       --max, --max-size VALUE[unit]
	      Maximum file size. [default = none]

       -B, --block-size VALUE
	      The smallest amount of bytes a file can occupy. [default = 1]

       --ss, --show-size
	      Print the size of each file.

       --sb, --show-bytes
	      Also print the sizes in bytes.

       --hi, --hide-items
	      Don't print selected files.

       --hs, --hide-summary
	      Hide summary line containing sum, difference and number of selected files.

       -s, --sort-by-size
	      Sort the output by size, not by name.

       -n, --no-case
	      Use case-insensitive sorting.

       -r, --sort-reverse
	      Sort the output in reverse order.

       --ew, --enclose-with CHAR
	      Enclose file names with CHAR. [default = none]

       --dw, --delimit-with CHAR
	      Delimit file names (lines) with CHAR. [default = newline]

       -z, --null-data
	      Assume NULL ( ) as the delimiter of input files via stdin (pipe).

       -Z, --null
	      Same as --dw ''. See also the -0 and --hs options.

       -0, --null-bins
	      Same as --bs ''. See also the -Z and --hs options.

       --bs, --bins-separator CHAR
	      Separate bins (vols) with CHAR. [default = newline]

       --version
	      Print gaffitter version and exit.

       -v, --verbose
	      Verbose.

       -h, --help
	      Print help and exit.

       Direct Input options:

       --di, --direct-input
	      Switch to direct input mode, i.e., read directly "size identifier" pairs instead of file names.

       --di-b, --di-bytes
	      Assume input sizes as bytes.

       --di-k, --di-kb
	      Assume input sizes as kibi bytes (KiB). KB if --di-si.

       --di-m, --di-mb
	      Assume input sizes as mebi bytes (MiB). MB if --di-si.

       --di-g, --di-gb
	      Assume input sizes as gibi bytes (GiB). GB if --di-si.

       --di-t, --di-tb
	      Assume input sizes as tebi bytes (TiB). TB if --di-si.

       --di-si
	      Use powers of 1000 (not 1024) for input sizes.

       Genetic Algorithm options:

       --ga-s, --ga-seed VALUE (integer)
	      GA initialization seed, VALUE >= 0. Zero means random. [default = 1]

       --ga-rs, --ga-random-seed
	      Use rendom GA seed (same as --ga-seed 0).

       --ga-ng, --ga-num-generations VALUE (integer)
	      Maximum number of generations, VALUE > 0. [default = auto]

       --ga-ps, --ga-pop-size VALUE (integer)
	      Number of individuals, VALUE > tournament_size. [default = auto]

       --ga-cp, --ga-cross-prob VALUE (float)
	      Crossover probability, 0.0 <= VALUE <= 1.0. [default = 0.95]

       --ga-mp, --ga-mutation-prob VALUE (float)
	      Mutation probability (per gene), 0.0 <= VALUE <= 1.0. [default = auto]

       --ga-sp, --ga-sel-pressure VALUE (integer)
	      Selection pressure (tournament size), 2 <= VALUE < pop_size. [default = 2]

       --ga-theo, --ga-theoretical [VALUE] (integer)
	      Stop if the theoretical minimum number of bins is reached. If VALUE is given, it is assumed to be the theoretical minimum number	of
	      bins.

       Other search methods:

       --ap, --approximate
	      Approximate the solution using Best First search (non-optimal but very fast).

       --sp, --split
	      Just split the input when target size is reached (preserves original order while splitting).

AUTHOR
       Written by Douglas A. Augusto <daaugusto@gmail.com>. This manpage has been written by Nacho Barrientos Arias <chipi@criptonita.com> for the
       Debian GNU/Linux system (but may be used by others).

BUGS
       Report bugs to Douglas A. Augusto <daaugusto@gmail.com>.

COPYRIGHT
       Copyright (C) 2005-2009, Douglas A. Augusto <daaugusto@gmail.com> - All Rights Reserved. This program is  free  software;  you  can  redis-
       tribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, Inc.

SEE ALSO
       http://gaffitter.sourceforge.net/

gaffitter 0.6.0 						September 24, 2009						      GAFFITTER(1)