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

SEE ALSO

ftimes(1)

LICENSE

All documentation and code are distributed under same terms and conditions as FTimes.