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

FreeBSD Manual Pages

  
 
  

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

perl v5.24.1			  2017-07-02		     FTIMES-GRABBER(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | AUTHOR | SEE ALSO | LICENSE

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

home | help