NAME

       shrinkfile - Shrink files on line boundaries

SYNOPSIS

       shrinkfile [-nv] [-m maxsize] [-s size] file [file ...]

DESCRIPTION

       The shrinkfile program shrinks files to at most a given size when their size is larger
       than maxsize, preserving the data at the end of the file.  Truncation is performed on line
       boundaries, where a line is a series of bytes ending with a newline ("\n").  There is no
       line length restriction and files may contain any binary data.

       If the first line is longer than the absolute value of size, the file will be truncated to
       zero length.

       The maximum file size shrinkfile can handle is 2,147,483,647 bytes.

       Temporary files are created in the pathtmp directory as set in inn.conf.  The "TMPDIR"
       environment variable may be used to specify a different directory.

       A newline will be added to any non-empty file that does not end with a newline, if
       naturally the resulting file size does not exceed size by this addition.

       This program is currently used by only nntpsend(8).

OPTIONS

       -m maxsize
           This option sets the maximum size allowed before truncation occurs.

           By default, maxsize is the same as size (as set with the -s flag).  If maxsize is less
           than size, maxsize is reset to size.

           This parameter may end with a "k", "m" or "g", indicating kilobyte (1,024 bytes),
           megabyte (1,048,576 bytes) or gigabyte (1,073,741,824 bytes) lengths.  Uppercase
           letters are also allowed.

       -n  This flag is used to determine if any file is too large.  No files will be altered in
           this mode.

           Exits with status code "0" if any file is larger than maxsize (as set with the -m
           flag), and exits with status code "1" otherwise.

       -s size
           By default, size is assumed to be zero and files are truncated to zero bytes.  This
           flag may be used to change the truncation size.  Because the program truncates only on
           line boundaries, the final size may be smaller than the specified truncation size.

           This parameter may end with a "k", "m" or "g", indicating kilobyte (1,024 bytes),
           megabyte (1,048,576 bytes) or gigabyte (1,073,741,824 bytes) lengths.  Uppercase
           letters are also allowed.

       -v  Prints to standard output a status line if a file was shrunk.

EXAMPLES

       Example usage:

           shrinkfile -s 4m curds
           shrinkfile -s 1g -v whey
           shrinkfile -s 500k -m 4m -v curds whey
           if shrinkfile -n -s 100m whey; then echo "whey is way too big"; fi

       The first command shrinks curds to 4 MB if bigger than this size.  The second command
       shrinks whey to 1 GB and outputs a log line if the file is bigger than this size.  The
       third command shrinks both curds and whey to 500 kB if bigger than 4 MB, and outputs a log
       line for the files it has shrunk.  The fourth command just prints a sentence if "whey" is
       bigger than 100 MB, without shrinking it.

HISTORY

       Written by Landon Curt Noll <chongo@toad.com> and Rich $alz <rsalz@uunet.uu.net> for
       InterNetNews.  Rewritten into POD by Julien Elie.

SEE ALSO

       nntpsend(8).