Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
FTIMES-GRABBER(1)	      FTimes Documentation	       FTIMES-GRABBER(1)

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

SYNOPSIS
     ftimes-grabber [-b bytes] [-c count] [-e exclude] [-i include] [-o op-
     tion[,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 fil-
     ters 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 ex-
	 clude pattern.  If no include patterns are specified, all files are im-
	 plicitly included.

     -o option,[option[,...]]
	 Specifies the list of options to apply.  Currently, the following op-
	 tions are supported:

	 BeQuiet
	     Don't list the files being added or skipped.

	 DryRun
	     Process the FTimes data, but do not create the ZIP archive.  In-
	     stead, simply report the number of files and uncompressed bytes the
	     archive would contain.

	 EnableZipErrorHandler
	     Enable the error handler that comes with Archive::Zip.  This pro-
	     vides additional information that may be useful for debugging pur-
	     poses.

	 StopShort
	     Terminate the filtering process as soon as the maximum number of
	     files or bytes is reached, and proceed directly to ZIP archive cre-
	     ation.

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

perl v5.42.3			   2026-08-27		       FTIMES-GRABBER(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ftimes-grabber&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help