NAME

ftimes-grabber - Parse FTimes output, grab files, and zip them up

SYNOPSIS

ftimes-grabber [-b bytes] [-c count] [-e exclude] [-i include] [-o option[,option[,...]]] -f {file|-} -z {zip|-}

DESCRIPTION

This utility reads FTimes map or dig data, conditionally filters records based on user-specified include/exclude patterns, and creates a list of files that are subsequently added to a ZIP archive.

Pattern filtering (includes/excludes) occurs only when a pattern file has been specified. Include filters are applied first, and then, exclude filters are applied. Once pattern filtering is complete, byte and file count limits are checked/applied (in that order).

Only files are archived by this utility -- all directories and special files (e.g., symbolic links) are ignored.

OPTIONS

-b bytes: Specifies the maximum number of uncompressed bytes to put in the ZIP archive. Once this limit has been reached, all remaining matches, if any, will be skipped.
-c files: Specifies the maximum number of files to put in the ZIP archive. Once this limit has been reached, all remaining matches, if any, will be skipped.
-e exclude: Specifies a file containing zero or more regular expressions, one per line, that are to be applied to the 'name' field after it has been deneutered and dequoted. Files that match any exclude pattern will not be added to the ZIP archive.
-f {file|-}: Specifies the name of the input file. A value of '-' will cause the program to read from stdin.
-i include: Specifies a file containing zero or more regular expressions, one per line, that are to be applied to the 'name' field after it has been deneutered and dequoted. Files that match any include pattern will be added to the ZIP archive unless they are subsequently matched by an exclude pattern. If no include patterns are specified, all files are implicitly included.
-o option,[option[,...]]: Specifies the list of options to apply. Currently, the following options are supported:

BeQuiet: Don't list the files being added or skipped.
DryRun: Process the FTimes data, but do not create the ZIP archive. Instead, simply report the number of files and uncompressed bytes the archive would contain.
EnableZipErrorHandler: Enable the error handler that comes with Archive::Zip. This provides additional information that may be useful for debugging purposes.
StopShort: Terminate the filtering process as soon as the maximum number of files or bytes is reached, and proceed directly to ZIP archive creation.

-z zip: Specifies the name of the ZIP archive to create. A value of '-' will cause the program to write to stdout.

AUTHOR

Klayton Monroe

LICENSE